@dxos/lit-grid 0.6.12-main.78ddbdf → 0.6.12-main.89e9959

package/dist/lib/browser/index.mjs

@@ -1,7 +1,8 @@
 // packages/ui/lit-grid/src/dx-grid.ts
 import { LitElement as LitElement2, html as html2, nothing } from "lit";
-import { customElement as customElement2, state, property as property2, eventOptions } from "lit/decorators.js";
+import { customElement as customElement2, state, property as property2 } from "lit/decorators.js";
 import { ref as ref2, createRef } from "lit/directives/ref.js";
+import { styleMap } from "lit/directives/style-map.js";
 
 // packages/ui/lit-grid/src/dx-grid-axis-resize-handle.ts
 import { draggable } from "@atlaskit/pragmatic-drag-and-drop/element/adapter";
@@ -14,12 +15,19 @@ import { ref } from "lit/directives/ref.js";
 // packages/ui/lit-grid/src/util.ts
 var separator = ",";
 var toCellIndex = (cellCoords) => `${cellCoords.col}${separator}${cellCoords.row}`;
+var colToA1Notation = (col) => {
+  return (col >= 26 ? String.fromCharCode("A".charCodeAt(0) + Math.floor(col / 26) - 1) : "") + String.fromCharCode("A".charCodeAt(0) + col % 26);
+};
+var rowToA1Notation = (row) => {
+  return `${row + 1}`;
+};
 
 // packages/ui/lit-grid/src/types.ts
 var DxAxisResize = class extends Event {
   constructor(props) {
     super("dx-axis-resize");
     this.axis = props.axis;
+    this.plane = props.plane;
     this.index = props.index;
     this.size = props.size;
   }
@@ -31,6 +39,7 @@ var DxAxisResizeInternal = class extends Event {
       bubbles: true
     });
     this.axis = props.axis;
+    this.plane = props.plane;
     this.index = props.index;
     this.size = props.size;
     this.delta = props.delta;
@@ -68,13 +77,14 @@ var DxGridAxisResizeHandle = class extends LitElement {
   constructor() {
     super(...arguments);
     this.axis = "row";
+    this.plane = "grid";
     this.index = "-1";
     this.size = 128;
     this.dragStartSize = 128;
     this.cleanup = null;
   }
   render() {
-    return html`<button class="dx-grid__resize-handle" ${ref(this.mount)}>
+    return html`<button class="dx-grid__resize-handle" data-dx-grid-axis=${this.axis} ${ref(this.mount)}>
       <span class="sr-only">Resize</span>
     </button>`;
   }
@@ -82,6 +92,7 @@ var DxGridAxisResizeHandle = class extends LitElement {
     const client = this.axis === "row" ? "clientY" : "clientX";
     const event = new DxAxisResizeInternal({
       axis: this.axis,
+      plane: this.plane,
       size: this.dragStartSize,
       index: this.index,
       delta: location.current.input[client] - location.initial.input[client],
@@ -126,6 +137,11 @@ _ts_decorate([
     type: String
   })
 ], DxGridAxisResizeHandle.prototype, "axis", void 0);
+_ts_decorate([
+  property({
+    type: String
+  })
+], DxGridAxisResizeHandle.prototype, "plane", void 0);
 _ts_decorate([
   property({
     type: String
@@ -148,18 +164,39 @@ function _ts_decorate2(decorators, target, key, desc) {
   return c > 3 && r && Object.defineProperty(target, key, r), r;
 }
 var gap = 1;
-var resizeTolerance = 8;
+var resizeTolerance = 1;
+var selectTolerance = 4;
 var overscanCol = 1;
 var overscanRow = 1;
 var sizeColMin = 32;
 var sizeColMax = 1024;
 var sizeRowMin = 16;
 var sizeRowMax = 1024;
-var colToA1Notation = (col) => {
-  return (col >= 26 ? String.fromCharCode("A".charCodeAt(0) + Math.floor(col / 26) - 1) : "") + String.fromCharCode("A".charCodeAt(0) + col % 26);
+var shouldSelect = (pointer, { pageX, pageY }) => {
+  if (pointer?.state === "maybeSelecting") {
+    return Math.hypot(Math.abs(pointer.pageX - pageX), Math.abs(pointer.pageY - pageY)) >= selectTolerance;
+  } else {
+    return false;
+  }
 };
-var rowToA1Notation = (row) => {
-  return `${row + 1}`;
+var selectionProps = (selectionStart, selectionEnd) => {
+  const colMin = Math.min(selectionStart.col, selectionEnd.col);
+  const colMax = Math.max(selectionStart.col, selectionEnd.col);
+  const rowMin = Math.min(selectionStart.row, selectionEnd.row);
+  const rowMax = Math.max(selectionStart.row, selectionEnd.row);
+  const plane = selectionStart.plane;
+  const visible = colMin !== colMax || rowMin !== rowMax;
+  return {
+    colMin,
+    colMax,
+    rowMin,
+    rowMax,
+    plane,
+    visible
+  };
+};
+var cellSelected = (col, row, plane, selection) => {
+  return plane === selection.plane && col >= selection.colMin && col <= selection.colMax && row >= selection.rowMin && row <= selection.rowMax;
 };
 var closestAction = (target) => {
   const actionEl = target?.closest("[data-dx-grid-action]") ?? null;
@@ -179,7 +216,9 @@ var closestCell = (target, actionEl) => {
   if (cellElement) {
     const col = parseInt(cellElement.getAttribute("aria-colindex") ?? "never");
     const row = parseInt(cellElement.getAttribute("aria-rowindex") ?? "never");
+    const plane = cellElement.closest("[data-dx-grid-plane]")?.getAttribute("data-dx-grid-plane") ?? "grid";
     return {
+      plane,
       col,
       row
     };
@@ -187,30 +226,92 @@ var closestCell = (target, actionEl) => {
     return null;
   }
 };
-var isSameCell = (a, b) => a && b && Number.isFinite(a.col) && Number.isFinite(a.row) && a.col === b.col && a.row === b.row;
-var localChId = (c0) => `ch--${c0}`;
-var localRhId = (r0) => `rh--${r0}`;
-var getPage = (axis, event) => axis === "col" ? event.pageX : event.pageY;
+var resolveRowPlane = (plane) => {
+  switch (plane) {
+    case "fixedStartStart":
+    case "fixedStartEnd":
+    case "frozenRowsStart":
+      return "frozenRowsStart";
+    case "fixedEndStart":
+    case "fixedEndEnd":
+    case "frozenRowsEnd":
+      return "frozenRowsEnd";
+    default:
+      return "grid";
+  }
+};
+var resolveColPlane = (plane) => {
+  switch (plane) {
+    case "fixedStartStart":
+    case "fixedEndStart":
+    case "frozenColsStart":
+      return "frozenColsStart";
+    case "fixedStartEnd":
+    case "fixedEndEnd":
+    case "frozenColsEnd":
+      return "frozenColsEnd";
+    default:
+      return "grid";
+  }
+};
+var resolveResizePlane = (resizeAxis, cellPlane) => {
+  switch (cellPlane) {
+    case "fixedStartStart":
+      return resizeAxis === "col" ? "frozenColsStart" : "frozenRowsStart";
+    case "fixedStartEnd":
+      return resizeAxis === "col" ? "frozenColsEnd" : "frozenRowsStart";
+    case "fixedEndStart":
+      return resizeAxis === "col" ? "frozenColsStart" : "frozenRowsEnd";
+    case "fixedEndEnd":
+      return resizeAxis === "col" ? "frozenColsEnd" : "frozenRowsEnd";
+    case "frozenColsStart":
+    case "frozenColsEnd":
+      return resizeAxis === "col" ? cellPlane : "grid";
+    case "frozenRowsStart":
+    case "frozenRowsEnd":
+      return resizeAxis === "row" ? cellPlane : "grid";
+    default:
+      return cellPlane;
+  }
+};
+var isSameCell = (a, b) => a && b && a.plane === b.plane && Number.isFinite(a.col) && Number.isFinite(a.row) && a.col === b.col && a.row === b.row;
+var defaultRowSize = 32;
+var defaultColSize = 180;
 var DxGrid = class extends LitElement2 {
   constructor() {
     super();
     this.gridId = "default-grid-id";
     this.rowDefault = {
-      size: 32
+      grid: {
+        size: defaultRowSize
+      }
     };
     this.columnDefault = {
-      size: 180
+      grid: {
+        size: defaultColSize
+      }
+    };
+    this.rows = {
+      grid: {}
+    };
+    this.columns = {
+      grid: {}
+    };
+    this.initialCells = {
+      grid: {}
     };
-    this.rows = {};
-    this.columns = {};
-    this.initialCells = {};
     this.mode = "browse";
+    this.limitColumns = Infinity;
+    this.limitRows = Infinity;
+    this.frozen = {};
     /**
     * When this function is defined, it is used first to try to get a value for a cell, and otherwise will fall back
     * to `cells`.
     */
     this.getCells = null;
-    this.cells = {};
+    this.cells = {
+      grid: {}
+    };
     //
     // `pos`, short for ‘position’, is the position in pixels of the viewport from the origin.
     //
@@ -230,9 +331,9 @@ var DxGrid = class extends LitElement2 {
     // `bin`, not short for anything, is the range in pixels within which virtualization does not need to reassess.
     //
     this.binInlineMin = 0;
-    this.binInlineMax = this.colSize(0);
+    this.binInlineMax = defaultColSize;
     this.binBlockMin = 0;
-    this.binBlockMax = this.rowSize(0);
+    this.binBlockMax = defaultRowSize;
     //
     // `vis`, short for ‘visible’, is the range in numeric index of the columns or rows which should be rendered within
     // the viewport. These start with naïve values that are updated before first contentful render.
@@ -244,48 +345,57 @@ var DxGrid = class extends LitElement2 {
     //
     // `template` is the rendered value of `grid-{axis}-template`.
     //
-    this.templateColumns = `${this.colSize(0)}px`;
-    this.templateRows = `${this.rowSize(0)}px`;
+    this.templateGridColumns = "0";
+    this.templatefrozenColsStart = "";
+    this.templatefrozenColsEnd = "";
+    this.templateGridRows = "0";
+    this.templatefrozenRowsStart = "";
+    this.templatefrozenRowsEnd = "";
     //
     // Focus, selection, and resize states
     //
     this.pointer = null;
-    this.colSizes = {};
-    this.rowSizes = {};
+    this.colSizes = {
+      grid: {}
+    };
+    this.rowSizes = {
+      grid: {}
+    };
     this.focusActive = false;
     this.focusedCell = {
+      plane: "grid",
       col: 0,
       row: 0
     };
     this.selectionStart = {
+      plane: "grid",
       col: 0,
       row: 0
     };
     this.selectionEnd = {
+      plane: "grid",
       col: 0,
       row: 0
     };
+    //
+    // Limits
+    //
+    this.intrinsicInlineSize = Infinity;
+    this.intrinsicBlockSize = Infinity;
     this.handlePointerDown = (event) => {
       if (event.isPrimary) {
         const { action, actionEl } = closestAction(event.target);
         if (action) {
-          if (action.startsWith("resize") && this.mode === "browse") {
-            const [resize, index] = action.split(",");
-            const [_, axis] = resize.split("-");
-            this.pointer = {
-              state: "resizing",
-              axis,
-              size: axis === "col" ? this.colSize(index) : this.rowSize(index),
-              page: getPage(axis, event),
-              index
-            };
-          } else if (action === "cell") {
+          if (action === "cell") {
             const cellCoords = closestCell(event.target, actionEl);
             if (cellCoords) {
               this.pointer = {
-                state: "selecting"
+                state: "maybeSelecting",
+                pageX: event.pageX,
+                pageY: event.pageY
               };
               this.selectionStart = cellCoords;
+              this.selectionEnd = cellCoords;
             }
             if (this.mode === "edit") {
               event.preventDefault();
@@ -299,23 +409,24 @@ var DxGrid = class extends LitElement2 {
       }
     };
     this.handlePointerUp = (event) => {
-      if (this.pointer?.state === "resizing") {
-      } else {
-        const cell = closestCell(event.target);
-        if (cell) {
-          this.selectionEnd = cell;
-          this.dispatchEvent(new DxGridCellsSelect({
-            start: this.selectionStart,
-            end: this.selectionEnd
-          }));
-        }
+      const cell = closestCell(event.target);
+      if (cell) {
+        this.selectionEnd = cell;
+        this.dispatchEvent(new DxGridCellsSelect({
+          start: this.selectionStart,
+          end: this.selectionEnd
+        }));
       }
       this.pointer = null;
     };
     this.handlePointerMove = (event) => {
-      if (this.pointer?.state === "selecting") {
+      if (shouldSelect(this.pointer, event)) {
+        this.pointer = {
+          state: "selecting"
+        };
+      } else if (this.pointer?.state === "selecting") {
         const cell = closestCell(event.target);
-        if (cell && (cell.col !== this.selectionEnd.col || cell.row !== this.selectionEnd.row)) {
+        if (cell && cell.plane === this.selectionStart.plane && (cell.col !== this.selectionEnd.col || cell.row !== this.selectionEnd.row)) {
           this.selectionEnd = cell;
         }
       }
@@ -332,6 +443,7 @@ var DxGrid = class extends LitElement2 {
         this.sizeInline = inlineSize;
         this.sizeBlock = blockSize;
         this.updateVis();
+        queueMicrotask(() => this.updatePos());
       }
     });
     this.viewportRef = createRef();
@@ -343,13 +455,13 @@ var DxGrid = class extends LitElement2 {
     };
     this.handleWheel = ({ deltaX, deltaY }) => {
       if (this.mode === "browse") {
-        this.posInline = Math.max(0, this.posInline + deltaX);
-        this.posBlock = Math.max(0, this.posBlock + deltaY);
-        this.maybeUpdateVis();
+        this.updatePos(this.posInline + deltaX, this.posBlock + deltaY);
       }
     };
     this.addEventListener("dx-axis-resize-internal", this.handleAxisResizeInternal);
-    this.addEventListener("wheel", this.handleWheel);
+    this.addEventListener("wheel", this.handleWheel, {
+      passive: true
+    });
     this.addEventListener("pointerdown", this.handlePointerDown);
     this.addEventListener("pointermove", this.handlePointerMove);
     this.addEventListener("pointerup", this.handlePointerUp);
@@ -379,7 +491,7 @@ var DxGrid = class extends LitElement2 {
         case "ArrowDown":
           this.focusedCell = {
             ...this.focusedCell,
-            row: this.focusedCell.row + 1
+            row: Math.min(this.limitRows - 1, this.focusedCell.row + 1)
           };
           break;
         case "ArrowUp":
@@ -391,7 +503,7 @@ var DxGrid = class extends LitElement2 {
         case "ArrowRight":
           this.focusedCell = {
             ...this.focusedCell,
-            col: this.focusedCell.col + 1
+            col: Math.min(this.limitColumns - 1, this.focusedCell.col + 1)
           };
           break;
         case "ArrowLeft":
@@ -425,21 +537,26 @@ var DxGrid = class extends LitElement2 {
   //
   // Accessors
   //
-  colSize(c) {
-    return this.colSizes?.[c] ?? this.columnDefault.size;
+  colSize(c, plane) {
+    const resolvedPlane = resolveColPlane(plane);
+    return this.colSizes?.[resolvedPlane]?.[c] ?? this.columnDefault[resolvedPlane]?.size ?? defaultColSize;
   }
-  rowSize(r) {
-    return this.rowSizes?.[r] ?? this.rowDefault.size;
+  rowSize(r, plane) {
+    const resolvedPlane = resolveRowPlane(plane);
+    return this.rowSizes?.[resolvedPlane]?.[r] ?? this.rowDefault[resolvedPlane]?.size ?? defaultRowSize;
   }
-  cell(c, r) {
+  cell(c, r, plane) {
     const index = `${c}${separator}${r}`;
-    return this.cells[index] ?? this.initialCells[index];
+    return this.cells?.[plane]?.[index] ?? this.initialCells?.[plane]?.[index];
+  }
+  cellActive(c, r, plane) {
+    return this.focusActive && this.focusedCell.plane === plane && this.focusedCell.col === c && this.focusedCell.row === r;
   }
   focusedCellBox() {
     const cellElement = this.focusedCellElement();
     const cellSize = {
-      inlineSize: this.colSize(this.focusedCell.col),
-      blockSize: this.rowSize(this.focusedCell.row)
+      inlineSize: this.colSize(this.focusedCell.col, this.focusedCell.plane),
+      blockSize: this.rowSize(this.focusedCell.row, this.focusedCell.plane)
     };
     if (!cellElement) {
       return {
@@ -459,60 +576,160 @@ var DxGrid = class extends LitElement2 {
       ...cellSize
     };
   }
+  updatePos(inline, block) {
+    this.posInline = Math.max(0, Math.min(this.intrinsicInlineSize - this.sizeInline, inline ?? this.posInline));
+    this.posBlock = Math.max(0, Math.min(this.intrinsicBlockSize - this.sizeBlock, block ?? this.posBlock));
+    this.maybeUpdateVis();
+  }
   updateVisInline() {
     let colIndex = 0;
-    let pxInline = this.colSize(colIndex);
+    let pxInline = this.colSize(colIndex, "grid");
     while (pxInline < this.posInline) {
       colIndex += 1;
-      pxInline += this.colSize(colIndex) + gap;
+      pxInline += this.colSize(colIndex, "grid") + gap;
     }
     this.visColMin = colIndex - overscanCol;
-    this.binInlineMin = pxInline - this.colSize(colIndex) - gap;
+    this.binInlineMin = pxInline - this.colSize(colIndex, "grid") - gap;
     this.binInlineMax = pxInline + gap;
     this.overscanInline = [
       ...Array(overscanCol)
     ].reduce((acc, _, c0) => {
-      acc += this.colSize(this.visColMin + c0);
+      acc += this.colSize(this.visColMin + c0, "grid");
       return acc;
     }, 0) + gap * (overscanCol - 1);
     while (pxInline < this.binInlineMax + this.sizeInline + gap) {
       colIndex += 1;
-      pxInline += this.colSize(colIndex) + gap;
+      pxInline += this.colSize(colIndex, "grid") + gap;
     }
-    this.visColMax = colIndex + overscanCol;
-    this.templateColumns = [
+    this.visColMax = Math.min(this.limitColumns, colIndex + overscanCol);
+    this.templateGridColumns = [
       ...Array(this.visColMax - this.visColMin)
-    ].map((_, c0) => `${this.colSize(this.visColMin + c0)}px`).join(" ");
+    ].map((_, c0) => `${this.colSize(this.visColMin + c0, "grid")}px`).join(" ");
+    this.templatefrozenColsStart = [
+      ...Array(this.frozen.frozenColsStart ?? 0)
+    ].map((_, c0) => `${this.colSize(c0, "frozenColsStart")}px`).join(" ");
+    this.templatefrozenColsEnd = [
+      ...Array(this.frozen.frozenColsEnd ?? 0)
+    ].map((_, c0) => `${this.colSize(c0, "frozenColsEnd")}px`).join(" ");
   }
   updateVisBlock() {
     let rowIndex = 0;
-    let pxBlock = this.rowSize(rowIndex);
+    let pxBlock = this.rowSize(rowIndex, "grid");
     while (pxBlock < this.posBlock) {
       rowIndex += 1;
-      pxBlock += this.rowSize(rowIndex) + gap;
+      pxBlock += this.rowSize(rowIndex, "grid") + gap;
     }
     this.visRowMin = rowIndex - overscanRow;
-    this.binBlockMin = pxBlock - this.rowSize(rowIndex) - gap;
+    this.binBlockMin = pxBlock - this.rowSize(rowIndex, "grid") - gap;
     this.binBlockMax = pxBlock + gap;
     this.overscanBlock = [
       ...Array(overscanRow)
     ].reduce((acc, _, r0) => {
-      acc += this.rowSize(this.visRowMin + r0);
+      acc += this.rowSize(this.visRowMin + r0, "grid");
       return acc;
     }, 0) + gap * (overscanRow - 1);
     while (pxBlock < this.binBlockMax + this.sizeBlock) {
       rowIndex += 1;
-      pxBlock += this.rowSize(rowIndex) + gap;
+      pxBlock += this.rowSize(rowIndex, "grid") + gap;
     }
-    this.visRowMax = rowIndex + overscanRow;
-    this.templateRows = [
+    this.visRowMax = Math.min(this.limitRows, rowIndex + overscanRow);
+    this.templateGridRows = [
       ...Array(this.visRowMax - this.visRowMin)
-    ].map((_, r0) => `${this.rowSize(this.visRowMin + r0)}px`).join(" ");
+    ].map((_, r0) => `${this.rowSize(this.visRowMin + r0, "grid")}px`).join(" ");
+    this.templatefrozenRowsStart = [
+      ...Array(this.frozen.frozenRowsStart ?? 0)
+    ].map((_, r0) => `${this.rowSize(r0, "frozenRowsStart")}px`).join(" ");
+    this.templatefrozenRowsEnd = [
+      ...Array(this.frozen.frozenRowsEnd ?? 0)
+    ].map((_, r0) => `${this.rowSize(r0, "frozenRowsEnd")}px`).join(" ");
   }
   updateVis() {
     this.updateVisInline();
     this.updateVisBlock();
   }
+  updateCells(includeFixed) {
+    this.cells.grid = this.getCells({
+      start: {
+        col: this.visColMin,
+        row: this.visRowMin
+      },
+      end: {
+        col: this.visColMax,
+        row: this.visRowMax
+      }
+    }, "grid");
+    Object.entries(this.frozen).filter(([_, limit]) => limit && limit > 0).forEach(([plane, limit]) => {
+      this.cells[plane] = this.getCells(plane.startsWith("frozenRows") ? {
+        start: {
+          col: this.visColMin,
+          row: 0
+        },
+        end: {
+          col: this.visColMax,
+          row: limit
+        }
+      } : {
+        start: {
+          col: 0,
+          row: this.visRowMin
+        },
+        end: {
+          col: limit,
+          row: this.visRowMax
+        }
+      }, plane);
+    });
+    if (includeFixed) {
+      if ((this.frozen.frozenColsStart ?? 0) > 0 && (this.frozen.frozenRowsStart ?? 0) > 0) {
+        this.cells.fixedStartStart = this.getCells({
+          start: {
+            col: 0,
+            row: 0
+          },
+          end: {
+            col: this.frozen.frozenColsStart,
+            row: this.frozen.frozenRowsStart
+          }
+        }, "fixedStartStart");
+      }
+      if ((this.frozen.frozenColsEnd ?? 0) > 0 && (this.frozen.frozenRowsStart ?? 0) > 0) {
+        this.cells.fixedStartEnd = this.getCells({
+          start: {
+            col: 0,
+            row: 0
+          },
+          end: {
+            col: this.frozen.frozenColsEnd,
+            row: this.frozen.frozenRowsStart
+          }
+        }, "fixedStartEnd");
+      }
+      if ((this.frozen.frozenColsStart ?? 0) > 0 && (this.frozen.frozenRowsEnd ?? 0) > 0) {
+        this.cells.fixedEndStart = this.getCells({
+          start: {
+            col: 0,
+            row: 0
+          },
+          end: {
+            col: this.frozen.frozenColsStart,
+            row: this.frozen.frozenRowsEnd
+          }
+        }, "fixedEndStart");
+      }
+      if ((this.frozen.frozenColsEnd ?? 0) > 0 && (this.frozen.frozenRowsEnd ?? 0) > 0) {
+        this.cells.fixedEndEnd = this.getCells({
+          start: {
+            col: 0,
+            row: 0
+          },
+          end: {
+            col: this.frozen.frozenColsEnd,
+            row: this.frozen.frozenRowsEnd
+          }
+        }, "fixedEndEnd");
+      }
+    }
+  }
   // Focus handlers
   handleFocus(event) {
     const cellCoords = closestCell(event.target);
@@ -527,7 +744,27 @@ var DxGrid = class extends LitElement2 {
     }
   }
   focusedCellElement() {
-    return this.viewportRef.value?.querySelector(`[aria-colindex="${this.focusedCell.col}"][aria-rowindex="${this.focusedCell.row}"]`);
+    return this.viewportRef.value?.querySelector(`[data-dx-grid-plane=${this.focusedCell.plane}] > [aria-colindex="${this.focusedCell.col}"][aria-rowindex="${this.focusedCell.row}"]`);
+  }
+  focusedCellRowOutOfVis(minDelta = 0, maxDelta = minDelta) {
+    return this.focusedCell.row < this.visRowMin + minDelta || this.focusedCell.row > this.visRowMax - maxDelta;
+  }
+  focusedCellColOutOfVis(minDelta = 0, maxDelta = minDelta) {
+    return this.focusedCell.col < this.visColMin + minDelta || this.focusedCell.col > this.visColMax - maxDelta;
+  }
+  focusedCellOutOfVis(colDelta = 0, rowDelta = colDelta) {
+    switch (this.focusedCell.plane) {
+      case "grid":
+        return this.focusedCellRowOutOfVis(rowDelta) || this.focusedCellColOutOfVis(colDelta);
+      case "frozenRowsStart":
+      case "frozenRowsEnd":
+        return this.focusedCellColOutOfVis(colDelta);
+      case "frozenColsStart":
+      case "frozenColsEnd":
+        return this.focusedCellRowOutOfVis(rowDelta);
+      default:
+        return false;
+    }
   }
   /**
   * Moves focus to the cell with actual focus, otherwise moves focus to the viewport.
@@ -546,20 +783,18 @@ var DxGrid = class extends LitElement2 {
           col: this.focusedCell.col + delta
         };
     }
-    (this.focusedCell.row < this.visRowMin || this.focusedCell.row > this.visRowMax || this.focusedCell.col < this.visColMin || this.focusedCell.col > this.visColMax ? this.viewportRef.value : this.focusedCellElement())?.focus({
-      preventScroll: true
-    });
     if (increment) {
       this.snapPosToFocusedCell();
     }
+    queueMicrotask(() => (this.focusedCellOutOfVis() ? this.viewportRef.value : this.focusedCellElement())?.focus({
+      preventScroll: true
+    }));
   }
   /**
   * Updates `pos` so that a cell in focus is fully within the viewport
   */
   snapPosToFocusedCell() {
-    if (this.focusedCell.col < this.visColMin || this.focusedCell.col > this.visColMax || this.focusedCell.row < this.visRowMin || this.focusedCell.row > this.visRowMax) {
-    } else if (this.focusedCell.col > this.visColMin + overscanCol && this.focusedCell.col < this.visColMax - overscanCol - 1 && this.focusedCell.row > this.visRowMin + overscanRow && this.focusedCell.row < this.visRowMax - overscanRow - 1) {
-    } else {
+    if (this.focusedCellOutOfVis(overscanCol + 1, overscanRow + 1)) {
       if (this.focusedCell.col <= this.visColMin + overscanCol) {
         this.posInline = this.binInlineMin;
         this.updateVisInline();
@@ -567,10 +802,10 @@ var DxGrid = class extends LitElement2 {
         const sizeSumCol = [
           ...Array(this.focusedCell.col - this.visColMin)
         ].reduce((acc, _, c0) => {
-          acc += this.colSize(this.visColMin + overscanCol + c0) + gap;
+          acc += this.colSize(this.visColMin + overscanCol + c0, "grid") + gap;
           return acc;
         }, 0);
-        this.posInline = Math.max(0, this.binInlineMin + sizeSumCol + gap * 2 - this.sizeInline);
+        this.posInline = Math.max(0, Math.min(this.intrinsicInlineSize - this.sizeInline, this.binInlineMin + sizeSumCol - this.sizeInline));
         this.updateVisInline();
       }
       if (this.focusedCell.row <= this.visRowMin + overscanRow) {
@@ -580,10 +815,10 @@ var DxGrid = class extends LitElement2 {
         const sizeSumRow = [
           ...Array(this.focusedCell.row - this.visRowMin)
         ].reduce((acc, _, r0) => {
-          acc += this.rowSize(this.visRowMin + overscanRow + r0) + gap;
+          acc += this.rowSize(this.visRowMin + overscanRow + r0, "grid") + gap;
           return acc;
         }, 0);
-        this.posBlock = Math.max(0, this.binBlockMin + sizeSumRow + gap * 2 - this.sizeBlock);
+        this.posBlock = Math.max(0, Math.min(this.intrinsicBlockSize - this.sizeBlock, this.binBlockMin + sizeSumRow - this.sizeBlock));
         this.updateVisBlock();
       }
     }
@@ -608,106 +843,166 @@ var DxGrid = class extends LitElement2 {
   //
   // Resize handlers
   //
+  axisResizeable(plane, axis, index) {
+    return axis === "col" ? !!(this.columns[plane]?.[index]?.resizeable ?? this.columnDefault[plane]?.resizeable) : !!(this.rows[plane]?.[index]?.resizeable ?? this.rowDefault[plane]?.resizeable);
+  }
   handleAxisResizeInternal(event) {
     event.stopPropagation();
-    const { axis, delta, size, index, type } = event;
+    const { plane, axis, delta, size, index, type } = event;
     if (axis === "col") {
       const nextSize = Math.max(sizeColMin, Math.min(sizeColMax, size + delta));
       this.colSizes = {
         ...this.colSizes,
-        [index]: nextSize
+        [plane]: {
+          ...this.colSizes[plane],
+          [index]: nextSize
+        }
       };
       this.updateVisInline();
+      this.updateIntrinsicInlineSize();
     } else {
       const nextSize = Math.max(sizeRowMin, Math.min(sizeRowMax, size + delta));
       this.rowSizes = {
-        ...this.rowSizes,
-        [index]: nextSize
+        ...this.colSizes,
+        [plane]: {
+          ...this.rowSizes[plane],
+          [index]: nextSize
+        }
       };
       this.updateVisBlock();
+      this.updateIntrinsicBlockSize();
     }
     if (type === "dropped") {
       this.dispatchEvent(new DxAxisResize({
+        plane,
         axis,
         index,
-        size: this[axis === "col" ? "colSize" : "rowSize"](index)
+        size: this[`${axis}Size`](index, plane)
       }));
     }
   }
   //
   // Render and other lifecycle methods
   //
+  renderFixed(plane, selection) {
+    const colPlane = resolveColPlane(plane);
+    const rowPlane = resolveRowPlane(plane);
+    const cols = this.frozen[colPlane];
+    const rows = this.frozen[rowPlane];
+    return (cols ?? 0) > 0 && (rows ?? 0) > 0 ? html2`<div
+          role="none"
+          data-dx-grid-plane=${plane}
+          class="dx-grid__plane--fixed"
+          style=${styleMap({
+      "grid-template-columns": this[`template${colPlane}`],
+      "grid-template-rows": this[`template${rowPlane}`]
+    })}
+        >
+          ${[
+      ...Array(cols)
+    ].map((_, c) => {
+      return [
+        ...Array(rows)
+      ].map((_2, r) => {
+        return this.renderCell(c, r, plane, cellSelected(c, r, plane, selection));
+      });
+    })}
+        </div>` : null;
+  }
+  renderFrozenRows(plane, visibleCols, offsetInline, selection) {
+    const rowPlane = resolveRowPlane(plane);
+    const rows = this.frozen[rowPlane];
+    return (rows ?? 0) > 0 ? html2`<div role="none" class="dx-grid__plane--frozen-row">
+          <div
+            role="none"
+            data-dx-grid-plane=${plane}
+            class="dx-grid__plane--frozen-row__content"
+            style="transform:translate3d(${offsetInline}px,0,0);grid-template-columns:${this.templateGridColumns};grid-template-rows:${this[`template${rowPlane}`]}"
+          >
+            ${[
+      ...Array(visibleCols)
+    ].map((_, c0) => {
+      return [
+        ...Array(rows)
+      ].map((_2, r) => {
+        const c = this.visColMin + c0;
+        return this.renderCell(c, r, plane, cellSelected(c, r, plane, selection), c0, r);
+      });
+    })}
+          </div>
+        </div>` : null;
+  }
+  renderFrozenColumns(plane, visibleRows, offsetBlock, selection) {
+    const colPlane = resolveColPlane(plane);
+    const cols = this.frozen[colPlane];
+    return (cols ?? 0) > 0 ? html2`<div role="none" class="dx-grid__plane--frozen-col">
+          <div
+            role="none"
+            data-dx-grid-plane=${plane}
+            class="dx-grid__plane--frozen-col__content"
+            style="transform:translate3d(0,${offsetBlock}px,0);grid-template-rows:${this.templateGridRows};grid-template-columns:${this[`template${colPlane}`]}"
+          >
+            ${[
+      ...Array(cols)
+    ].map((_, c) => {
+      return [
+        ...Array(visibleRows)
+      ].map((_2, r0) => {
+        const r = this.visRowMin + r0;
+        return this.renderCell(c, r, plane, cellSelected(c, r, plane, selection), c, r0);
+      });
+    })}
+          </div>
+        </div>` : null;
+  }
+  renderCell(col, row, plane, selected, visCol = col, visRow = row) {
+    const cell = this.cell(col, row, plane);
+    const active = this.cellActive(col, row, plane);
+    const resizeIndex = cell?.resizeHandle ? cell.resizeHandle === "col" ? col : row : void 0;
+    const resizePlane = cell?.resizeHandle ? resolveResizePlane(cell.resizeHandle, plane) : void 0;
+    return html2`<div
+      role="gridcell"
+      tabindex="0"
+      ?inert=${col < 0 || row < 0}
+      ?aria-selected=${selected}
+      class=${cell || active ? (cell?.className ? cell.className + " " : "") + (active ? "dx-grid__cell--active" : "") : nothing}
+      aria-colindex=${col}
+      aria-rowindex=${row}
+      data-dx-grid-action="cell"
+      style="grid-column:${visCol + 1};grid-row:${visRow + 1}"
+    >
+      ${cell?.value}${cell?.resizeHandle && this.axisResizeable(resizePlane, cell.resizeHandle, resizeIndex) ? html2`<dx-grid-axis-resize-handle
+            axis=${cell.resizeHandle}
+            plane=${resizePlane}
+            index=${resizeIndex}
+            size=${this[`${cell.resizeHandle}Size`](resizeIndex, plane)}
+          ></dx-grid-axis-resize-handle>` : null}
+    </div>`;
+  }
   render() {
     const visibleCols = this.visColMax - this.visColMin;
     const visibleRows = this.visRowMax - this.visRowMin;
     const offsetInline = this.binInlineMin - this.posInline - this.overscanInline;
     const offsetBlock = this.binBlockMin - this.posBlock - this.overscanBlock;
-    const selectColMin = Math.min(this.selectionStart.col, this.selectionEnd.col);
-    const selectColMax = Math.max(this.selectionStart.col, this.selectionEnd.col);
-    const selectRowMin = Math.min(this.selectionStart.row, this.selectionEnd.row);
-    const selectRowMax = Math.max(this.selectionStart.row, this.selectionEnd.row);
-    const selectVisible = selectColMin !== selectColMax || selectRowMin !== selectRowMax;
+    const selection = selectionProps(this.selectionStart, this.selectionEnd);
     return html2`<div
       role="none"
       class="dx-grid"
+      style=${styleMap({
+      "grid-template-columns": `${this.templatefrozenColsStart ? "min-content " : ""}minmax(0, ${Number.isFinite(this.limitColumns) ? `${this.intrinsicInlineSize}px` : "1fr"})${this.templatefrozenColsEnd ? " min-content" : ""}`,
+      "grid-template-rows": `${this.templatefrozenRowsStart ? "min-content " : ""}minmax(0, ${Number.isFinite(this.limitRows) ? `${this.intrinsicBlockSize}px` : "1fr"})${this.templatefrozenRowsEnd ? " min-content" : ""}`
+    })}
       data-grid=${this.gridId}
       data-grid-mode=${this.mode}
-      ?data-grid-select=${selectVisible}
+      ?data-grid-select=${selection.visible}
     >
-      <div role="none" class="dx-grid__corner"></div>
-      <div role="none" class="dx-grid__columnheader">
-        <div
-          role="none"
-          class="dx-grid__columnheader__content"
-          style="transform:translate3d(${offsetInline}px,0,0);grid-template-columns:${this.templateColumns};"
-        >
-          ${[
-      ...Array(visibleCols)
-    ].map((_, c0) => {
-      const c = this.visColMin + c0;
-      return html2`<div
-              role="columnheader"
-              ?inert=${c < 0}
-              style="block-size:${this.rowDefault.size}px;grid-column:${c0 + 1}/${c0 + 2};"
-            >
-              <span id=${localChId(c0)}>${colToA1Notation(c)}</span>
-              ${(this.columns[c]?.resizeable ?? this.columnDefault.resizeable) && html2`<dx-grid-axis-resize-handle
-                axis="col"
-                index=${c}
-                size=${this.colSize(c)}
-                @dxaxisresizeinternal=${this.handleAxisResizeInternal}
-              ></dx-grid-axis-resize-handle>`}
-            </div>`;
-    })}
-        </div>
-      </div>
-      <div role="none" class="dx-grid__corner"></div>
-      <div role="none" class="dx-grid__rowheader">
-        <div
-          role="none"
-          class="dx-grid__rowheader__content"
-          style="transform:translate3d(0,${offsetBlock}px,0);grid-template-rows:${this.templateRows};"
-        >
-          ${[
-      ...Array(visibleRows)
-    ].map((_, r0) => {
-      const r = this.visRowMin + r0;
-      return html2`<div role="rowheader" ?inert=${r < 0} style="grid-row:${r0 + 1}/${r0 + 2}">
-              <span id=${localRhId(r0)}>${rowToA1Notation(r)}</span>
-              ${(this.rows[r]?.resizeable ?? this.rowDefault.resizeable) && html2`<dx-grid-axis-resize-handle
-                axis="row"
-                index=${r}
-                size=${this.rowSize(r)}
-              ></dx-grid-axis-resize-handle>`}
-            </div>`;
-    })}
-        </div>
-      </div>
-      <div role="grid" class="dx-grid__viewport" tabindex="0" @wheel=${this.handleWheel} ${ref2(this.viewportRef)}>
+      ${this.renderFixed("fixedStartStart", selection)}${this.renderFrozenRows("frozenRowsStart", visibleCols, offsetInline, selection)}${this.renderFixed("fixedStartEnd", selection)}${this.renderFrozenColumns("frozenColsStart", visibleRows, offsetBlock, selection)}
+      <div role="grid" class="dx-grid__plane--grid" tabindex="0" ${ref2(this.viewportRef)}>
         <div
           role="none"
-          class="dx-grid__content"
-          style="transform:translate3d(${offsetInline}px,${offsetBlock}px,0);grid-template-columns:${this.templateColumns};grid-template-rows:${this.templateRows};"
+          class="dx-grid__plane--grid__content"
+          data-dx-grid-plane="grid"
+          style="transform:translate3d(${offsetInline}px,${offsetBlock}px,0);grid-template-columns:${this.templateGridColumns};grid-template-rows:${this.templateGridRows};"
         >
           ${[
       ...Array(visibleCols)
@@ -717,75 +1012,60 @@ var DxGrid = class extends LitElement2 {
       ].map((_2, r0) => {
         const c = c0 + this.visColMin;
         const r = r0 + this.visRowMin;
-        const cell = this.cell(c, r);
-        const active = this.focusActive && this.focusedCell.col === c && this.focusedCell.row === r;
-        const selected = c >= selectColMin && c <= selectColMax && r >= selectRowMin && r <= selectRowMax;
-        return html2`<div
-                role="gridcell"
-                tabindex="0"
-                ?inert=${c < 0 || r < 0}
-                ?aria-selected=${selected}
-                class=${cell || active ? (cell?.className ? cell.className + " " : "") + (active ? "dx-grid__cell--active" : "") : nothing}
-                aria-rowindex=${r}
-                aria-colindex=${c}
-                data-dx-grid-action="cell"
-                style="grid-column:${c0 + 1};grid-row:${r0 + 1}"
-              >
-                ${cell?.value}
-              </div>`;
+        return this.renderCell(c, r, "grid", cellSelected(c, r, "grid", selection), c0, r0);
       });
     })}
         </div>
       </div>
-      <div role="none" class="dx-grid__scrollbar" aria-orientation="vertical">
-        <div role="none" class="dx-grid__scrollbar__thumb"></div>
-      </div>
-      <div role="none" class="dx-grid__corner"></div>
-      <div role="none" class="dx-grid__scrollbar" aria-orientation="horizontal">
-        <div role="none" class="dx-grid__scrollbar__thumb"></div>
-      </div>
-      <div role="none" class="dx-grid__corner"></div>
+      ${this.renderFrozenColumns("frozenColsEnd", visibleRows, offsetBlock, selection)}${this.renderFixed("fixedEndStart", selection)}${this.renderFrozenRows("frozenRowsEnd", visibleCols, offsetInline, selection)}${this.renderFixed("fixedEndEnd", selection)}
     </div>`;
   }
+  updateIntrinsicInlineSize() {
+    this.intrinsicInlineSize = Number.isFinite(this.limitColumns) ? [
+      ...Array(this.limitColumns)
+    ].reduce((acc, _, c0) => acc + this.colSize(c0, "grid"), 0) + gap * (this.limitColumns - 1) : Infinity;
+  }
+  updateIntrinsicBlockSize() {
+    this.intrinsicBlockSize = Number.isFinite(this.limitRows) ? [
+      ...Array(this.limitRows)
+    ].reduce((acc, _, r0) => acc + this.rowSize(r0, "grid"), 0) + gap * (this.limitRows - 1) : Infinity;
+  }
+  updateIntrinsicSizes() {
+    this.updateIntrinsicInlineSize();
+    this.updateIntrinsicBlockSize();
+  }
   firstUpdated() {
     if (this.getCells) {
-      this.cells = this.getCells({
-        start: {
-          col: this.visColMin,
-          row: this.visRowMin
-        },
-        end: {
-          col: this.visColMax,
-          row: this.visRowMax
-        }
-      });
+      this.updateCells(true);
     }
     this.observer.observe(this.viewportRef.value);
-    this.colSizes = Object.entries(this.columns).reduce((acc, [colId, colMeta]) => {
-      if (colMeta?.size) {
-        acc[colId] = colMeta.size;
-      }
+    this.colSizes = Object.entries(this.columns).reduce((acc, [plane, planeColMeta]) => {
+      acc[plane] = Object.entries(planeColMeta).reduce((planeAcc, [col, colMeta]) => {
+        if (colMeta?.size) {
+          planeAcc[col] = colMeta.size;
+        }
+        return planeAcc;
+      }, {});
       return acc;
-    }, {});
-    this.rowSizes = Object.entries(this.rows).reduce((acc, [rowId, rowMeta]) => {
-      if (rowMeta?.size) {
-        acc[rowId] = rowMeta.size;
-      }
+    }, {
+      grid: {}
+    });
+    this.rowSizes = Object.entries(this.rows).reduce((acc, [plane, planeRowMeta]) => {
+      acc[plane] = Object.entries(planeRowMeta).reduce((planeAcc, [row, rowMeta]) => {
+        if (rowMeta?.size) {
+          planeAcc[row] = rowMeta.size;
+        }
+        return planeAcc;
+      }, {});
       return acc;
-    }, {});
+    }, {
+      grid: {}
+    });
+    this.updateIntrinsicSizes();
   }
   willUpdate(changedProperties) {
     if (this.getCells && (changedProperties.has("initialCells") || changedProperties.has("visColMin") || changedProperties.has("visColMax") || changedProperties.has("visRowMin") || changedProperties.has("visRowMax"))) {
-      this.cells = this.getCells({
-        start: {
-          col: this.visColMin,
-          row: this.visRowMin
-        },
-        end: {
-          col: this.visColMax,
-          row: this.visRowMax
-        }
-      });
+      this.updateCells();
     }
   }
   updated(changedProperties) {
@@ -838,6 +1118,21 @@ _ts_decorate2([
     type: String
   })
 ], DxGrid.prototype, "mode", void 0);
+_ts_decorate2([
+  property2({
+    type: Number
+  })
+], DxGrid.prototype, "limitColumns", void 0);
+_ts_decorate2([
+  property2({
+    type: Number
+  })
+], DxGrid.prototype, "limitRows", void 0);
+_ts_decorate2([
+  property2({
+    type: Object
+  })
+], DxGrid.prototype, "frozen", void 0);
 _ts_decorate2([
   state()
 ], DxGrid.prototype, "cells", void 0);
@@ -885,10 +1180,22 @@ _ts_decorate2([
 ], DxGrid.prototype, "visRowMax", void 0);
 _ts_decorate2([
   state()
-], DxGrid.prototype, "templateColumns", void 0);
+], DxGrid.prototype, "templateGridColumns", void 0);
+_ts_decorate2([
+  state()
+], DxGrid.prototype, "templatefrozenColsStart", void 0);
+_ts_decorate2([
+  state()
+], DxGrid.prototype, "templatefrozenColsEnd", void 0);
+_ts_decorate2([
+  state()
+], DxGrid.prototype, "templateGridRows", void 0);
 _ts_decorate2([
   state()
-], DxGrid.prototype, "templateRows", void 0);
+], DxGrid.prototype, "templatefrozenRowsStart", void 0);
+_ts_decorate2([
+  state()
+], DxGrid.prototype, "templatefrozenRowsEnd", void 0);
 _ts_decorate2([
   state()
 ], DxGrid.prototype, "pointer", void 0);
@@ -912,17 +1219,13 @@ _ts_decorate2([
 ], DxGrid.prototype, "selectionEnd", void 0);
 _ts_decorate2([
   state()
-], DxGrid.prototype, "observer", void 0);
+], DxGrid.prototype, "intrinsicInlineSize", void 0);
 _ts_decorate2([
-  eventOptions({
-    capture: true
-  })
-], DxGrid.prototype, "handleFocus", null);
+  state()
+], DxGrid.prototype, "intrinsicBlockSize", void 0);
 _ts_decorate2([
-  eventOptions({
-    capture: true
-  })
-], DxGrid.prototype, "handleBlur", null);
+  state()
+], DxGrid.prototype, "observer", void 0);
 DxGrid = _ts_decorate2([
   customElement2("dx-grid")
 ], DxGrid);
@@ -931,6 +1234,8 @@ export {
   DxAxisResizeInternal,
   DxEditRequest,
   DxGrid,
-  DxGridCellsSelect
+  DxGridCellsSelect,
+  colToA1Notation,
+  rowToA1Notation
 };
 //# sourceMappingURL=index.mjs.map