@sheetxl/grid-react 0.8.0-beta.12 → 0.8.0-beta.14

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@sheetxl/grid-react",
   "description": "Grid React - Advanced grid component for React",
-  "version": "0.8.0-beta.12",
+  "version": "0.8.0-beta.14",
   "license": "SEE LICENSE IN <LICENSE>",
   "type": "module",
   "exports": {
@@ -40,8 +40,8 @@
     "table"
   ],
   "dependencies": {
-    "@sheetxl/utils": "^0.8.0-beta.12",
-    "@sheetxl/utils-react": "^0.8.0-beta.12",
+    "@sheetxl/utils": "^0.8.0-beta.14",
+    "@sheetxl/utils-react": "^0.8.0-beta.14",
     "clsx": "^2.1.1",
     "react-merge-refs": "^3.0.2"
   },

package/types/src/layer/RangeFloatLayer.d.ts

@@ -108,7 +108,7 @@ export interface RangeFloatOptions<T = unknown> {
     /** Grace (ms) before a hovered float hides (bridges the gap to the float). @defaultValue the group's `leaveDelay` (400) */
     closeDelay?: number;
     /**
-     * A hovered float joins the grid's tooltip group (one tip at a time, closed by any press or key).
+     * A hovered float joins the grid's tooltip group (one tip at a time, closed by a press outside it or Escape).
      * `false` for a hover-opened float that is not a tooltip — a toolbar — which must survive a tip
      * opening beside it and a press on its own buttons.
      * @defaultValue true
@@ -202,6 +202,11 @@ export interface RangeFloatLayerProps<T = unknown> extends Omit<LayerProps, 'chi
      * selection — the layer only ever reads the active cell and subscribes to it.
      */
     selection?: ICellAnchor;
+    /**
+     * What the pointer is over that the cells cannot tell the tap: something drawn above them, which
+     * takes the pointer first. Wins over the probed cell while it is set.
+     */
+    hoveredOver?: RangeFloatTarget<T> | null;
 }
 /**
  * The **range float layer**: a {@link VirtualRangeFloat} as a layer of its own, whose tap probes the

package/types/src/layer/RangeTooltip.d.ts

@@ -113,6 +113,11 @@ export declare const RangeTooltipProvider: React.FC<RangeTooltipProviderProps>;
 export declare const RangeTooltip: (props: RangeTooltipProps) => null;
 export interface RangeTooltipHostProps extends Omit<LayerProps, 'children'> {
     className?: string;
+    /**
+     * Close the open tip and open no other while this holds, for whatever reason the host's owner has
+     * (the cell under the pointer is being edited, say).
+     */
+    dismiss?: boolean;
 }
 /**
  * The layer that draws the {@link RangeTooltip}s of the nearest {@link RangeTooltipProvider}: one tap,

package/types/src/layer/RangeTooltipLayer.d.ts

@@ -42,7 +42,7 @@ export interface RangeTooltipLayerProps<T = unknown> extends Omit<RangeFloatLaye
  * The **tooltip kind** of range float: transient, opened by hovering a cell the probe recognizes, one
  * at a time grid-wide. A preset of {@link RangeFloatLayer} (`activateOn: 'hover'`) whose hover intent is
  * the tooltip group's client — so it inherits the group's timing, single-open rule, armed re-open, and
- * closes on any press or key — drawn in the group's bubble, in the tooltip band.
+ * closes on a press outside it or Escape — drawn in the group's bubble, under any menu.
  *
  * @remarks
  * Reach for `RangeFloatLayer` directly when the float is activated by the selection, driven by a

package/types/src/layer/TooltipProvider.d.ts

@@ -40,19 +40,21 @@ export interface TooltipClient {
     readonly key: string;
     /**
      * A gesture tip holds the group: hover tips may not open while it is up. It is not closed by a press
-     * or a key (its gesture's modifiers), and its close does not arm the group.
+     * or Escape, and its close does not arm the group.
      */
     readonly gesture: boolean;
     /** The tip's element once mounted — a pointerdown inside it does not close it. */
     getElement(): Element | null;
-    /** Close now, no grace (the group took the slot, or the user pressed / typed). */
+    /** Close now, no grace (the group took the slot, or the user pressed elsewhere or hit Escape). */
     forceClose(): void;
 }
 /**
  * The single-open coordinator: at most one tip (by key) is up at a time, the next open is fast for
- * {@link TooltipTiming.armedFor} after a close, a gesture tip preempts hover, and any pointerdown or
- * keydown closes an open hover tip (a gesture tip closes with its gesture). Owned by the top {@link TooltipProvider} (or one that `isolate`s);
- * a built-in default serves a tree with no provider.
+ * {@link TooltipTiming.armedFor} after a close, a gesture tip preempts hover, and a pointerdown outside
+ * an open hover tip or Escape closes it (a gesture tip closes with its gesture). No other key and no
+ * selection change closes a tip; a layer's owner closes one for its own reasons through `dismiss`. Owned
+ * by the top {@link TooltipProvider} (or one that `isolate`s); a built-in default serves a tree with no
+ * provider.
  */
 export interface TooltipGroup {
     /** `client` is opening: every client open on another key closes first, with no grace. */

package/types/src/layer/_Utils.d.ts

@@ -2,6 +2,8 @@ import { RangeCoords } from '@sheetxl/utils';
 import { LayerNode } from './LayerTypes';
 /** Content key for a range — stable across object identity (dedupe / memo / hover-target keys). */
 export declare const rangeKey: (r: RangeCoords) => string;
+/** Where a cell's hover tip stacks: over the grid's other floats, and under any menu. */
+export declare const GRID_TIP_Z_INDEX: string;
 /**
  * A layer's **derived stacking order** — its index in the normalized layer list, i.e. the react list
  * order with explicit-`zIndex` overrides already folded in (see {@link normalizeLayers}). This is the

package/types/src/layer/useHoverIntent.d.ts

@@ -13,8 +13,8 @@ export interface UseHoverIntentOptions {
      */
     closeDelay?: number;
     /**
-     * Join the grid's tooltip group: one tip open at a time, a fast re-open while armed, closed by any
-     * pointerdown or key, refused while a gesture tip is up. `false` for a hover-opened float that is not
+     * Join the grid's tooltip group: one tip open at a time, a fast re-open while armed, closed by a
+     * pointerdown outside it or Escape, refused while a gesture tip or a popup is up. `false` for a hover-opened float that is not
      * a tooltip — a table toolbar, a note's box — which must survive a tip opening beside it.
      * @defaultValue true
      */
@@ -65,7 +65,7 @@ export interface UseHoverIntentResult {
 /**
  * The **hover-intent state machine** behind a tip — the per-tip client of the grid's tooltip group
  * ({@link TooltipProvider}): dwell / grace timing, keep-open-on-tip-hover, and the group's rules
- * (single open, armed re-open, gesture preempts hover, closed by a press or a key). It does NO
+ * (single open, armed re-open, gesture and popup preempt hover, closed by a press outside it or Escape). It does NO
  * hit-testing: feed it a target key via {@link UseHoverIntentResult.setTarget} (`null` = nothing) and
  * spread {@link UseHoverIntentResult.tipProps} on the float.
  *