@sheetxl/grid-react 0.8.0-beta.4 → 0.8.0-beta.6

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@sheetxl/grid-react",
   "description": "Grid React - Advanced grid component for React",
-  "version": "0.8.0-beta.4",
+  "version": "0.8.0-beta.6",
   "license": "SEE LICENSE IN <LICENSE>",
   "type": "module",
   "exports": {
@@ -42,8 +42,8 @@
   ],
   "dependencies": {
     "@floating-ui/react-dom": "^2.1.9",
-    "@sheetxl/utils": "^0.8.0-beta.4",
-    "@sheetxl/utils-react": "^0.8.0-beta.4",
+    "@sheetxl/utils": "^0.8.0-beta.6",
+    "@sheetxl/utils-react": "^0.8.0-beta.6",
     "clsx": "^2.1.1",
     "react-merge-refs": "^3.0.2",
     "react-use": "^17.6.1",

package/types/src/editor/EditorLayer.d.ts

@@ -60,10 +60,15 @@ export interface EditorLayerProps<C, D = string, A = EditCommitArgs> extends Vir
  * Always-mounted inline cell editor, as a grid layer.
  *
  * @remarks
- * The input is mounted for the life of the grid (hidden when idle);
- * starting an edit just seeds the first character **by value** into the {@link IEditable} and
- * focuses the input. Render it inside `renderLayers`; with frozen panes each pane instantiates one,
- * and only the pane containing the active cell shows it.
+ * The input is mounted for the life of the grid (hidden when idle); starting an edit seeds the first
+ * character **by value** into the {@link IEditable} and focuses the input. Mount it as the grid's LAST
+ * child so the box paints over everything; with frozen panes each pane instantiates one, and only the
+ * pane containing the active cell shows it.
+ *
+ * This layer carries no event handlers. The ready-mode starters (typed key / F2 / double-click) are
+ * the {@link EditorStartLayer}, mounted as the grid's FIRST child: a Layer's handlers are its slot's
+ * tap, heard on every layer's turn top first, so start handlers on the top layer would intercept keys
+ * and double-clicks aimed at any widget below it before that widget's own handlers ran.
  */
 export declare function EditorLayer<C, D = string, A = EditCommitArgs>(props: EditorLayerProps<C, D, A>): React.ReactElement;
 //# sourceMappingURL=EditorLayer.d.ts.map

package/types/src/editor/EditorStartLayer.d.ts

@@ -0,0 +1,32 @@
+import { EditCommitArgs } from './EditState';
+import { IEditable } from './DefaultEditable';
+/**
+ * Props for {@link EditorStartLayer}.
+ *
+ * @typeParam C - The clean value type. @typeParam D - The dirty value type. @typeParam A - Commit args.
+ */
+export interface EditorStartLayerProps<C, D = string, A = EditCommitArgs> {
+    /** The editable to start edits on — the same instance the {@link EditorLayer} renders. */
+    editable: IEditable<C, D, A>;
+}
+/**
+ * The grid's **ready-mode** edit starters, as a content-less grid layer: a typed character / `F2` /
+ * `Backspace` opens an edit on the anchor, a double-click opens one on the cell under the pointer.
+ *
+ * @remarks
+ * This is deliberately a separate layer from the {@link EditorLayer} that paints the box. The box must
+ * sit at the **top** of the stack to paint over everything, but a Layer's handlers are its slot's tap
+ * — grid-wide ears that fire on every layer's turn, top first — so handlers on the top layer would
+ * intercept keys and double-clicks aimed at any widget below it (a chart, a note) before that widget's
+ * own handlers ran. Starting an edit is the grid *floor's* behavior: it belongs at the **bottom** of
+ * the stack, where it only hears what no widget above consumed. Mount it as the grid's first child.
+ *
+ * Keys are positionless, so the floor position alone is not enough for them: a focused widget that
+ * does not consume a printable key (it has no use for it, and must let keys through so its own
+ * commands can resolve) would otherwise still reach this tap. The key start therefore acts only when
+ * the key is aimed at the grid surface itself — the surface is the focused element — which is what
+ * "the grid is in ready mode" means. A double-click needs no such guard: it has a position, and a
+ * widget that owns that position consumes it.
+ */
+export declare function EditorStartLayer<C, D = string, A = EditCommitArgs>(props: EditorStartLayerProps<C, D, A>): React.ReactElement;
+//# sourceMappingURL=EditorStartLayer.d.ts.map

package/types/src/editor/index.d.ts

@@ -6,5 +6,6 @@ export * from './DefaultEditable';
 export * from './EditorPlacement';
 export * from './EditorInput';
 export * from './EditorLayer';
+export * from './EditorStartLayer';
 export * from './EditorDiv';
 //# sourceMappingURL=index.d.ts.map