@mt-gloss/ui 0.1.60 → 0.1.61

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

@@ -23,13 +23,13 @@ import * as React from 'react';
  * Without it, clicking a glyph would pack/add AND open the catalog
  * simultaneously.
  *
- * PKG-04 hide-during-drag is NOT implemented in this primitive — it is
- * deferred to Phase 12 (Track D — AFF-01) via the `useAffordanceVisibility()`
- * hook seam declared in `../hooks/useAffordanceVisibility.ts`. Phase 13 ships
- * the seam with a `{ affordancesVisible: true }` stub; Phase 12 fills the
- * gridChannels-driven implementation. Until then, glyphs remain visible
- * during drag/resize — Phase 13's UAT scenarios for hide-during-drag verify
- * the seam exists but cannot exercise the gate behaviour.
+ * PKG-04 hide-during-drag IS implemented via `useAffordanceVisibility()`
+ * (single-source gate; migrated 2026-05-03 quick/260503-aff). The hook
+ * subscribes to `GestureStateProvider` and applies a 200ms idle dwell-delay
+ * before re-emergence per A-01-affordance-dwell-reemergence.svg. Both the
+ * `+` and `×` SwingReveal wrappers AND-gate `visible` on `affordancesVisible`
+ * — the consumer-side `enabled` for `×` continues to express the D-19
+ * predicate independently.
  *
  * @see .planning/phases/13-track-g-add-remove-collapse/13-CONTEXT.md §D-04, §D-06, §D-10, §D-18
  */

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

@@ -49,5 +49,18 @@ export interface EdgeHoverHandleProps {
  * first few px — pointerup then fires on whatever is underneath, the handle's
  * React onPointerUp never runs, and the state machine stays stuck at
  * 'dragging' (so onResize is never called and the card never commits).
+ *
+ * Cross-card gesture suppression (260503-aff): during ANY drag/resize, the
+ * resize handles on NON-source cards must hide so they don't compete with
+ * the in-flight gesture's chrome. Achieved by AND-gating ONLY the
+ * `'handle-visible'` branch on `useAffordanceVisibility().affordancesVisible`.
+ * The `'dragging'` and `'settling'` branches stay un-gated to preserve the
+ * SOURCE card's pointer-capture invariant — the source card's own handle MUST
+ * remain visible (and pointer-capture-eligible) throughout its own gesture,
+ * regardless of `affordancesVisible`. Non-source cards sit at
+ * `'handle-visible'` or earlier, so when `affordancesVisible=false` (during
+ * any global gesture + 200ms idle dwell), they hide. After the global
+ * gesture settles back to idle and the dwell elapses, all handles re-emerge
+ * together with the rest of the affordance chrome.
  */
 export declare const EdgeHoverHandle: import('react').ForwardRefExoticComponent<EdgeHoverHandleProps & import('react').RefAttributes<HTMLButtonElement>>;

package/lib/primitives/dashboard/hooks/useAffordanceVisibility.d.ts

@@ -1,28 +1,5 @@
-/**
- * useAffordanceVisibility — Phase 13 D-10 / D-18 contract section 3.
- *
- * Returns the visibility flag for empty-cell affordance glyphs (+ and ×) during
- * drag/resize gestures (PKG-04 hide-on-active rule).
- *
- * **Phase 13 ships a stub** that returns `{ affordancesVisible: true }` unconditionally.
- * **Phase 12 fills the real implementation** when its affordance state machine ships
- * (Track D — AFF-01). The contract Phase 12 must honor:
- *
- * - Read gridChannels lifecycle state for the `chrome` channel.
- * - Return `{ affordancesVisible: true }` when LifecycleState ∈ ['idle', 'arming']
- *   (matches `gridChannels.chrome.applicableStates`).
- * - Return `{ affordancesVisible: false }` when LifecycleState === 'active' or 'settling'
- *   (matches `gridChannels.hideOnActive.applicableStates`).
- *
- * The DropAnchorCell `state='empty'` dashed border is NOT gated by this hook —
- * the border persists during drag/resize because it IS the drop-target affordance
- * (D-07 critical invariant).
- *
- * @see .planning/phases/13-track-g-add-remove-collapse/13-CONTEXT.md §D-10, §D-18
- * @see .planning/phases/09-track-a-gev-foundation/HANDOFF.json#contracts.channels (chrome, hideOnActive)
- */
 export interface UseAffordanceVisibilityReturn {
-    /** true when affordance glyphs (+ and ×) should render; false during drag/resize. */
+    /** true when affordance glyphs should render; false during gesture + 200ms idle dwell. */
     affordancesVisible: boolean;
 }
 export declare function useAffordanceVisibility(): UseAffordanceVisibilityReturn;

package/package.json

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