@mt-gloss/ui 0.0.43 → 0.0.45

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

@@ -4,8 +4,15 @@ export interface GhostPreviewProps {
     visible: boolean;
     /** The target column span being previewed. */
     targetColSpan: 1 | 2 | 3;
-    /** D-07 — MotionValue driving translateX. Zero React re-renders per pointermove. */
-    motionX: MotionValue<number>;
+    /**
+     * D-07 rework 260419-v2 — MotionValue driving the ghost's WIDTH (px).
+     * The ghost is left-anchored at the slot origin; the ghost RIGHT edge
+     * follows the cursor via direct width animation (no translateX). Zero
+     * React re-renders per pointermove. Framer-motion animates width via rAF
+     * + direct style writes, so there is no CSS-engine transition on width
+     * (AP-19 companion — `transition-property` in edge-hover.scss is opacity-only).
+     */
+    ghostWidth: MotionValue<number>;
     /** AN-06 enter duration in ms. Default: 180ms */
     enterMs?: number;
     /** AN-06 exit duration in ms. Default: 120ms */
@@ -14,14 +21,21 @@ export interface GhostPreviewProps {
 /**
  * GhostPreview — Dashed outline overlay rendered during an active resize drag.
  *
- * Phase 19 evolution: consumes a framer-motion MotionValue for translateX
- * (D-07) so ghost tracks the cursor 1:1 without React re-renders on
- * pointermove (AP-17). Opacity transitions still use CSS enterMs/exitMs.
+ * Rework 260419-v2: ghost is LEFT-ANCHORED WIDTH (no translateX). The left
+ * edge stays pinned at the slot origin; the right edge follows the cursor
+ * via framer-motion MotionValue → `style={{ width }}`. Supersedes the prior
+ * translateX (D-07) rendering, which caused the ghost to slide horizontally
+ * across the page when compounded with the pre-Phase-19 wrapper (see debug
+ * session 260419-ghost-slides-across-page).
+ *
+ * D-24's "translateX over scaleX" rationale (corner distortion under scaleX)
+ * does NOT apply to direct `width` animation — the border/corners draw at
+ * every frame at the current width with no geometric scaling.
  *
  * Hidden via aria-hidden — purely decorative visual feedback.
- * Motion contract (AN-06): enter 180ms, exit 120ms.
+ * Motion contract (AN-06): enter 180ms, exit 120ms (opacity only).
  */
-export declare function GhostPreview({ visible, targetColSpan, motionX, enterMs, exitMs, }: GhostPreviewProps): import("react/jsx-runtime").JSX.Element;
+export declare function GhostPreview({ visible, targetColSpan, ghostWidth, enterMs, exitMs, }: GhostPreviewProps): import("react/jsx-runtime").JSX.Element;
 export declare namespace GhostPreview {
     var displayName: string;
 }

package/lib/primitives/dashboard/MetricCard/__tests__/fixtures/nyquist-09-parity-matrix.d.ts

@@ -0,0 +1,76 @@
+/**
+ * NYQUIST-09 Parity Matrix — Phase 19 plan 19-05.
+ *
+ * Typed array of 144 rows enumerating the 7-axis resize parity space:
+ *
+ *   spring          — 3 presets: default (S500D35M1), gentle (S300D30M1), stiff (S700D40M1)
+ *   viewport        — round-robin across [1280, 1920, 2560] (all 3 appear in asserted set)
+ *   reducedMotion   — {false, true}
+ *   pointerType     — {'mouse', 'touch'}
+ *   cardMode        — {'slot-fill', 'sparkline-fidelity'}
+ *   cancelPath      — {'commit', 'escape', 'out-of-range'}
+ *   dndKitActive    — {false, true}
+ *
+ * Arithmetic (per 19-RESEARCH §NYQUIST-09 Fixture Matrix):
+ *   3 × 2 × 2 × 2 × 3 × 2 = 144 logical rows.
+ *   Viewport axis is DERIVED per-row (round-robin) so every asserted row still
+ *   represents one of the 3 canonical viewports without multiplying the base
+ *   by a 4th full axis — this matches the RESEARCH-stated 144 count exactly.
+ *
+ * SkipFor taxonomy (~84 rows tagged; first-match wins):
+ *
+ *   Rule 1 — reducedMotion && spring === 'stiff':
+ *     Reduced motion bypasses spring; stiffer preset collapses to same
+ *     instant-jump code path as default. (default spring + gentle preset
+ *     still carry the rm=true assertion to exercise the branch.)
+ *
+ *   Rule 2 — pointerType === 'touch' && cancelPath === 'escape':
+ *     Touch devices lack Escape key; covered by separate touch-pointercancel
+ *     fixture (useEdgeHoverResize.touch.test.tsx).
+ *
+ *   Rule 3 — cardMode === 'sparkline-fidelity' && dndKitActive:
+ *     Non-stackable cards are not sortable; dnd-kit active state is
+ *     impossible (invariant from PagesContext.tsx stack rules).
+ *
+ *   Rule 4 — cancelPath === 'out-of-range' && !dndKitActive && spring !== default:
+ *     Out-of-range clamp is independent of spring variant; default-spring row
+ *     carries the clamp assertion. Non-default springs on the clamp path are
+ *     redundant (physics variant does not affect Math.min(3, …) behavior).
+ *
+ * Asserted target: 60 ± 5 rows (plan acceptance criterion).
+ * Actual asserted: 63 / 144 (skipped 81). Viewport distribution across
+ * asserted rows: 1280 → 25, 1920 → 18, 2560 → 20 (all 3 represented).
+ *
+ * @see .planning/phases/19-resize-interaction-rework/19-RESEARCH.md §NYQUIST-09 Fixture Matrix
+ * @see .planning/phases/19-resize-interaction-rework/19-PATTERNS.md §S10 NYQUIST matrix authoring
+ * @see .planning/phases/19-resize-interaction-rework/19-05-PLAN.md Task 1
+ */
+export interface Nyquist09Row {
+    /**
+     * Stable row id, e.g. 'S500D35M1-vw1280-rm_off-mouse-stack-commit-dndk_on'.
+     * Shape: `S{stiffness}D{damping}M{mass}-vw{viewport}-rm_{on|off}-{pointer}-{stack|spark}-{cancelPath}-dndk_{on|off}`.
+     */
+    id: string;
+    spring: {
+        stiffness: number;
+        damping: number;
+        mass: number;
+    };
+    viewport: 1280 | 1920 | 2560;
+    reducedMotion: boolean;
+    pointerType: 'mouse' | 'touch';
+    cardMode: 'slot-fill' | 'sparkline-fidelity';
+    cancelPath: 'commit' | 'escape' | 'out-of-range';
+    dndKitActive: boolean;
+    /**
+     * If set, row is test.skip with this reason string. Acceptance criterion:
+     * skipped ≤ 84, asserted ≥ 55 (see PLAN threat-model T-19-16).
+     */
+    skipFor?: string;
+}
+/** Canonical 144-row NYQUIST-09 parity matrix — enumerated explicitly for diff-ability. */
+export declare const NYQUIST_09_MATRIX: readonly Nyquist09Row[];
+/** Convenience: number of rows that actually run (skipFor === undefined). Exported for CI sanity check. */
+export declare const NYQUIST_09_ASSERTED_COUNT: number;
+/** Convenience: number of rows tagged skipFor. Exported for CI sanity check. */
+export declare const NYQUIST_09_SKIPPED_COUNT: number;

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

@@ -15,6 +15,13 @@ export interface UseEdgeHoverResizeArgs {
     onCancel?: () => void;
     /** D-14 — colWidth snapshot passed per-render; captured at pointerdown. Default: 180px (1280px viewport). */
     step?: number;
+    /**
+     * Grid gap (px) between adjacent columns. Used to compute the ghost's
+     * left-anchored width as `colSpan * step + (colSpan - 1) * gap`. Default: 0
+     * (single-column grids). Rework 260419-v2 — ghost is width-driven, not
+     * translateX-driven; this is the companion scalar.
+     */
+    gap?: number;
     /** D-03 panel override; falls back to DEFAULT_RESIZE_PHYSICS. */
     tuning?: Partial<ResizePhysicsConfig>;
     /** Hover dwell time before handle appears. Default: 120ms */
@@ -23,6 +30,13 @@ export interface UseEdgeHoverResizeArgs {
     enterMs?: number;
     /** AN-06 exit motion duration exposed for consumer CSS. Default: 120ms */
     exitMs?: number;
+    /**
+     * Max colSpan supported by the grid (D-13 — right-edge-only grow). Default: 3.
+     * Used to clamp ghostWidth writes during drag so the ghost cannot grow
+     * past the maximum-allowed column width at any cursor position (debug
+     * session 260419-ghost-slides-across-page — AP-17 companion invariant).
+     */
+    maxColSpan?: 1 | 2 | 3;
 }
 export interface UseEdgeHoverResizeReturn {
     state: ResizeState;
@@ -43,8 +57,15 @@ export interface UseEdgeHoverResizeReturn {
     ghostProps: {
         visible: boolean;
         targetColSpan: 1 | 2 | 3;
-        /** D-07 — MotionValue driving ghost translateX. Zero React re-renders per pointermove. */
-        motionX: MotionValue<number>;
+        /**
+         * D-07 rework 260419-v2 — MotionValue driving ghost WIDTH (left-anchored).
+         * The ghost LEFT edge is pinned at the slot origin; the ghost RIGHT edge
+         * follows the cursor; `ghostWidth` carries that width imperatively with
+         * zero React re-renders per pointermove. Supersedes the prior `motionX`
+         * translateX semantic (which slid the entire ghost horizontally — see
+         * debug session 260419-ghost-slides-across-page).
+         */
+        ghostWidth: MotionValue<number>;
         enterMs: number;
         exitMs: number;
     };
@@ -77,4 +98,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, tuning, dwellMs, enterMs, exitMs, }: UseEdgeHoverResizeArgs): UseEdgeHoverResizeReturn;
+export declare function useEdgeHoverResize({ currentColSpan, stackable, onResize, onCancel, step, gap, tuning, dwellMs, enterMs, exitMs, maxColSpan, }: UseEdgeHoverResizeArgs): UseEdgeHoverResizeReturn;

package/package.json

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