@react-aria/grid 3.10.5 → 3.11.1

package/dist/GridKeyboardDelegate.mjs

@@ -28,149 +28,202 @@ class $d1c300d9c497e402$export$de9feff04fda126e {
         let key = fromKey != null ? this.collection.getKeyBefore(fromKey) : this.collection.getLastKey();
         while(key != null){
             let item = this.collection.getItem(key);
+            if (!item) return null;
             if (!this.isDisabled(item) && (!pred || pred(item))) return key;
             key = this.collection.getKeyBefore(key);
         }
+        return null;
     }
     findNextKey(fromKey, pred) {
         let key = fromKey != null ? this.collection.getKeyAfter(fromKey) : this.collection.getFirstKey();
         while(key != null){
             let item = this.collection.getItem(key);
+            if (!item) return null;
             if (!this.isDisabled(item) && (!pred || pred(item))) return key;
             key = this.collection.getKeyAfter(key);
+            if (key == null) return null;
         }
+        return null;
     }
-    getKeyBelow(key) {
+    getKeyBelow(fromKey) {
+        let key = fromKey;
         let startItem = this.collection.getItem(key);
-        if (!startItem) return;
+        if (!startItem) return null;
+        var _startItem_parentKey;
         // If focus was on a cell, start searching from the parent row
-        if (this.isCell(startItem)) key = startItem.parentKey;
+        if (this.isCell(startItem)) key = (_startItem_parentKey = startItem.parentKey) !== null && _startItem_parentKey !== void 0 ? _startItem_parentKey : null;
+        if (key == null) return null;
         // Find the next item
         key = this.findNextKey(key, (item)=>item.type === 'item');
         if (key != null) {
             // If focus was on a cell, focus the cell with the same index in the next row.
             if (this.isCell(startItem)) {
+                var _getNthItem;
                 let item = this.collection.getItem(key);
-                return (0, $kbsd1$getNthItem)((0, $kbsd1$getChildNodes)(item, this.collection), startItem.index).key;
+                if (!item) return null;
+                var _startItem_index, _getNthItem_key;
+                return (_getNthItem_key = (_getNthItem = (0, $kbsd1$getNthItem)((0, $kbsd1$getChildNodes)(item, this.collection), (_startItem_index = startItem.index) !== null && _startItem_index !== void 0 ? _startItem_index : 0)) === null || _getNthItem === void 0 ? void 0 : _getNthItem.key) !== null && _getNthItem_key !== void 0 ? _getNthItem_key : null;
             }
             // Otherwise, focus the next row
             if (this.focusMode === 'row') return key;
         }
+        return null;
     }
-    getKeyAbove(key) {
+    getKeyAbove(fromKey) {
+        let key = fromKey;
         let startItem = this.collection.getItem(key);
-        if (!startItem) return;
+        if (!startItem) return null;
+        var _startItem_parentKey;
         // If focus is on a cell, start searching from the parent row
-        if (this.isCell(startItem)) key = startItem.parentKey;
+        if (this.isCell(startItem)) key = (_startItem_parentKey = startItem.parentKey) !== null && _startItem_parentKey !== void 0 ? _startItem_parentKey : null;
+        if (key == null) return null;
         // Find the previous item
         key = this.findPreviousKey(key, (item)=>item.type === 'item');
         if (key != null) {
             // If focus was on a cell, focus the cell with the same index in the previous row.
             if (this.isCell(startItem)) {
+                var _getNthItem;
                 let item = this.collection.getItem(key);
-                return (0, $kbsd1$getNthItem)((0, $kbsd1$getChildNodes)(item, this.collection), startItem.index).key;
+                if (!item) return null;
+                var _startItem_index;
+                return ((_getNthItem = (0, $kbsd1$getNthItem)((0, $kbsd1$getChildNodes)(item, this.collection), (_startItem_index = startItem.index) !== null && _startItem_index !== void 0 ? _startItem_index : 0)) === null || _getNthItem === void 0 ? void 0 : _getNthItem.key) || null;
             }
             // Otherwise, focus the previous row
             if (this.focusMode === 'row') return key;
         }
+        return null;
     }
     getKeyRightOf(key) {
         let item = this.collection.getItem(key);
-        if (!item) return;
+        if (!item) return null;
         // If focus is on a row, focus the first child cell.
         if (this.isRow(item)) {
+            var _getLastItem, _getFirstItem;
             let children = (0, $kbsd1$getChildNodes)(item, this.collection);
-            return this.direction === 'rtl' ? (0, $kbsd1$getLastItem)(children).key : (0, $kbsd1$getFirstItem)(children).key;
+            var _ref;
+            return (_ref = this.direction === 'rtl' ? (_getLastItem = (0, $kbsd1$getLastItem)(children)) === null || _getLastItem === void 0 ? void 0 : _getLastItem.key : (_getFirstItem = (0, $kbsd1$getFirstItem)(children)) === null || _getFirstItem === void 0 ? void 0 : _getFirstItem.key) !== null && _ref !== void 0 ? _ref : null;
         }
         // If focus is on a cell, focus the next cell if any,
         // otherwise focus the parent row.
-        if (this.isCell(item)) {
+        if (this.isCell(item) && item.parentKey != null) {
             let parent = this.collection.getItem(item.parentKey);
+            if (!parent) return null;
             let children = (0, $kbsd1$getChildNodes)(parent, this.collection);
-            let next = this.direction === 'rtl' ? (0, $kbsd1$getNthItem)(children, item.index - 1) : (0, $kbsd1$getNthItem)(children, item.index + 1);
-            if (next) return next.key;
+            var _ref1;
+            let next = (_ref1 = this.direction === 'rtl' ? (0, $kbsd1$getNthItem)(children, item.index - 1) : (0, $kbsd1$getNthItem)(children, item.index + 1)) !== null && _ref1 !== void 0 ? _ref1 : null;
+            var _next_key;
+            if (next) return (_next_key = next.key) !== null && _next_key !== void 0 ? _next_key : null;
+            var _item_parentKey;
             // focus row only if focusMode is set to row
-            if (this.focusMode === 'row') return item.parentKey;
-            return this.direction === 'rtl' ? this.getFirstKey(key) : this.getLastKey(key);
+            if (this.focusMode === 'row') return (_item_parentKey = item.parentKey) !== null && _item_parentKey !== void 0 ? _item_parentKey : null;
+            var _ref2;
+            return (_ref2 = this.direction === 'rtl' ? this.getFirstKey(key) : this.getLastKey(key)) !== null && _ref2 !== void 0 ? _ref2 : null;
         }
+        return null;
     }
     getKeyLeftOf(key) {
         let item = this.collection.getItem(key);
-        if (!item) return;
+        if (!item) return null;
         // If focus is on a row, focus the last child cell.
         if (this.isRow(item)) {
+            var _getFirstItem, _getLastItem;
             let children = (0, $kbsd1$getChildNodes)(item, this.collection);
-            return this.direction === 'rtl' ? (0, $kbsd1$getFirstItem)(children).key : (0, $kbsd1$getLastItem)(children).key;
+            var _ref;
+            return (_ref = this.direction === 'rtl' ? (_getFirstItem = (0, $kbsd1$getFirstItem)(children)) === null || _getFirstItem === void 0 ? void 0 : _getFirstItem.key : (_getLastItem = (0, $kbsd1$getLastItem)(children)) === null || _getLastItem === void 0 ? void 0 : _getLastItem.key) !== null && _ref !== void 0 ? _ref : null;
         }
         // If focus is on a cell, focus the previous cell if any,
         // otherwise focus the parent row.
-        if (this.isCell(item)) {
+        if (this.isCell(item) && item.parentKey != null) {
             let parent = this.collection.getItem(item.parentKey);
+            if (!parent) return null;
             let children = (0, $kbsd1$getChildNodes)(parent, this.collection);
-            let prev = this.direction === 'rtl' ? (0, $kbsd1$getNthItem)(children, item.index + 1) : (0, $kbsd1$getNthItem)(children, item.index - 1);
-            if (prev) return prev.key;
+            var _ref1;
+            let prev = (_ref1 = this.direction === 'rtl' ? (0, $kbsd1$getNthItem)(children, item.index + 1) : (0, $kbsd1$getNthItem)(children, item.index - 1)) !== null && _ref1 !== void 0 ? _ref1 : null;
+            var _prev_key;
+            if (prev) return (_prev_key = prev.key) !== null && _prev_key !== void 0 ? _prev_key : null;
+            var _item_parentKey;
             // focus row only if focusMode is set to row
-            if (this.focusMode === 'row') return item.parentKey;
-            return this.direction === 'rtl' ? this.getLastKey(key) : this.getFirstKey(key);
+            if (this.focusMode === 'row') return (_item_parentKey = item.parentKey) !== null && _item_parentKey !== void 0 ? _item_parentKey : null;
+            var _ref2;
+            return (_ref2 = this.direction === 'rtl' ? this.getLastKey(key) : this.getFirstKey(key)) !== null && _ref2 !== void 0 ? _ref2 : null;
         }
+        return null;
     }
-    getFirstKey(key, global) {
+    getFirstKey(fromKey, global) {
+        let key = fromKey !== null && fromKey !== void 0 ? fromKey : null;
         let item;
         if (key != null) {
             item = this.collection.getItem(key);
-            if (!item) return;
+            if (!item) return null;
             // If global flag is not set, and a cell is currently focused,
             // move focus to the first cell in the parent row.
-            if (this.isCell(item) && !global) {
+            if (this.isCell(item) && !global && item.parentKey != null) {
+                var _getFirstItem;
                 let parent = this.collection.getItem(item.parentKey);
-                return (0, $kbsd1$getFirstItem)((0, $kbsd1$getChildNodes)(parent, this.collection)).key;
+                if (!parent) return null;
+                var _getFirstItem_key;
+                return (_getFirstItem_key = (_getFirstItem = (0, $kbsd1$getFirstItem)((0, $kbsd1$getChildNodes)(parent, this.collection))) === null || _getFirstItem === void 0 ? void 0 : _getFirstItem.key) !== null && _getFirstItem_key !== void 0 ? _getFirstItem_key : null;
             }
         }
         // Find the first row
-        key = this.findNextKey(null, (item)=>item.type === 'item');
+        key = this.findNextKey(undefined, (item)=>item.type === 'item');
         // If global flag is set (or if focus mode is cell), focus the first cell in the first row.
-        if (key != null && item && this.isCell(item) && global || this.focusMode === 'cell') {
+        if (key != null && (item && this.isCell(item) && global || this.focusMode === 'cell')) {
+            var _getFirstItem1;
             let item = this.collection.getItem(key);
-            key = (0, $kbsd1$getFirstItem)((0, $kbsd1$getChildNodes)(item, this.collection)).key;
+            if (!item) return null;
+            var _getFirstItem_key1;
+            key = (_getFirstItem_key1 = (_getFirstItem1 = (0, $kbsd1$getFirstItem)((0, $kbsd1$getChildNodes)(item, this.collection))) === null || _getFirstItem1 === void 0 ? void 0 : _getFirstItem1.key) !== null && _getFirstItem_key1 !== void 0 ? _getFirstItem_key1 : null;
         }
         // Otherwise, focus the row itself.
         return key;
     }
-    getLastKey(key, global) {
+    getLastKey(fromKey, global) {
+        let key = fromKey !== null && fromKey !== void 0 ? fromKey : null;
         let item;
         if (key != null) {
             item = this.collection.getItem(key);
-            if (!item) return;
+            if (!item) return null;
             // If global flag is not set, and a cell is currently focused,
             // move focus to the last cell in the parent row.
-            if (this.isCell(item) && !global) {
+            if (this.isCell(item) && !global && item.parentKey != null) {
+                var _getLastItem;
                 let parent = this.collection.getItem(item.parentKey);
+                if (!parent) return null;
                 let children = (0, $kbsd1$getChildNodes)(parent, this.collection);
-                return (0, $kbsd1$getLastItem)(children).key;
+                var _getLastItem_key;
+                return (_getLastItem_key = (_getLastItem = (0, $kbsd1$getLastItem)(children)) === null || _getLastItem === void 0 ? void 0 : _getLastItem.key) !== null && _getLastItem_key !== void 0 ? _getLastItem_key : null;
             }
         }
         // Find the last row
-        key = this.findPreviousKey(null, (item)=>item.type === 'item');
+        key = this.findPreviousKey(undefined, (item)=>item.type === 'item');
         // If global flag is set (or if focus mode is cell), focus the last cell in the last row.
-        if (key != null && item && this.isCell(item) && global || this.focusMode === 'cell') {
+        if (key != null && (item && this.isCell(item) && global || this.focusMode === 'cell')) {
+            var _getLastItem1;
             let item = this.collection.getItem(key);
+            if (!item) return null;
             let children = (0, $kbsd1$getChildNodes)(item, this.collection);
-            key = (0, $kbsd1$getLastItem)(children).key;
+            var _getLastItem_key1;
+            key = (_getLastItem_key1 = (_getLastItem1 = (0, $kbsd1$getLastItem)(children)) === null || _getLastItem1 === void 0 ? void 0 : _getLastItem1.key) !== null && _getLastItem_key1 !== void 0 ? _getLastItem_key1 : null;
         }
         // Otherwise, focus the row itself.
         return key;
     }
-    getKeyPageAbove(key) {
+    getKeyPageAbove(fromKey) {
+        let key = fromKey;
         let itemRect = this.layoutDelegate.getItemRect(key);
         if (!itemRect) return null;
         let pageY = Math.max(0, itemRect.y + itemRect.height - this.layoutDelegate.getVisibleRect().height);
-        while(itemRect && itemRect.y > pageY){
-            key = this.getKeyAbove(key);
+        while(itemRect && itemRect.y > pageY && key != null){
+            var _this_getKeyAbove;
+            key = (_this_getKeyAbove = this.getKeyAbove(key)) !== null && _this_getKeyAbove !== void 0 ? _this_getKeyAbove : null;
+            if (key == null) break;
             itemRect = this.layoutDelegate.getItemRect(key);
         }
         return key;
     }
-    getKeyPageBelow(key) {
+    getKeyPageBelow(fromKey) {
+        let key = fromKey;
         let itemRect = this.layoutDelegate.getItemRect(key);
         if (!itemRect) return null;
         let pageHeight = this.layoutDelegate.getVisibleRect().height;
@@ -185,20 +238,27 @@ class $d1c300d9c497e402$export$de9feff04fda126e {
         return key;
     }
     getKeyForSearch(search, fromKey) {
+        let key = fromKey !== null && fromKey !== void 0 ? fromKey : null;
         if (!this.collator) return null;
         let collection = this.collection;
-        let key = fromKey !== null && fromKey !== void 0 ? fromKey : this.getFirstKey();
+        key = fromKey !== null && fromKey !== void 0 ? fromKey : this.getFirstKey();
+        if (key == null) return null;
         // If the starting key is a cell, search from its parent row.
         let startItem = collection.getItem(key);
-        if (startItem.type === 'cell') key = startItem.parentKey;
+        if (!startItem) return null;
+        var _startItem_parentKey;
+        if (startItem.type === 'cell') key = (_startItem_parentKey = startItem.parentKey) !== null && _startItem_parentKey !== void 0 ? _startItem_parentKey : null;
         let hasWrapped = false;
         while(key != null){
             let item = collection.getItem(key);
+            if (!item) return null;
             // check row text value for match
             if (item.textValue) {
                 let substring = item.textValue.slice(0, search.length);
                 if (this.collator.compare(substring, search) === 0) {
-                    if (this.isRow(item) && this.focusMode === 'cell') return (0, $kbsd1$getFirstItem)((0, $kbsd1$getChildNodes)(item, this.collection)).key;
+                    var _getFirstItem;
+                    var _getFirstItem_key;
+                    if (this.isRow(item) && this.focusMode === 'cell') return (_getFirstItem_key = (_getFirstItem = (0, $kbsd1$getFirstItem)((0, $kbsd1$getChildNodes)(item, this.collection))) === null || _getFirstItem === void 0 ? void 0 : _getFirstItem.key) !== null && _getFirstItem_key !== void 0 ? _getFirstItem_key : null;
                     return item.key;
                 }
             }
@@ -217,6 +277,7 @@ class $d1c300d9c497e402$export$de9feff04fda126e {
         this.disabledBehavior = options.disabledBehavior || 'all';
         this.direction = options.direction;
         this.collator = options.collator;
+        if (!options.layout && !options.ref) throw new Error('Either a layout or a ref must be specified.');
         this.layoutDelegate = options.layoutDelegate || (options.layout ? new $d1c300d9c497e402$var$DeprecatedLayoutDelegate(options.layout) : new (0, $kbsd1$DOMLayoutDelegate)(options.ref));
         this.focusMode = options.focusMode || 'row';
     }

package/dist/GridKeyboardDelegate.module.js

@@ -28,149 +28,202 @@ class $d1c300d9c497e402$export$de9feff04fda126e {
         let key = fromKey != null ? this.collection.getKeyBefore(fromKey) : this.collection.getLastKey();
         while(key != null){
             let item = this.collection.getItem(key);
+            if (!item) return null;
             if (!this.isDisabled(item) && (!pred || pred(item))) return key;
             key = this.collection.getKeyBefore(key);
         }
+        return null;
     }
     findNextKey(fromKey, pred) {
         let key = fromKey != null ? this.collection.getKeyAfter(fromKey) : this.collection.getFirstKey();
         while(key != null){
             let item = this.collection.getItem(key);
+            if (!item) return null;
             if (!this.isDisabled(item) && (!pred || pred(item))) return key;
             key = this.collection.getKeyAfter(key);
+            if (key == null) return null;
         }
+        return null;
     }
-    getKeyBelow(key) {
+    getKeyBelow(fromKey) {
+        let key = fromKey;
         let startItem = this.collection.getItem(key);
-        if (!startItem) return;
+        if (!startItem) return null;
+        var _startItem_parentKey;
         // If focus was on a cell, start searching from the parent row
-        if (this.isCell(startItem)) key = startItem.parentKey;
+        if (this.isCell(startItem)) key = (_startItem_parentKey = startItem.parentKey) !== null && _startItem_parentKey !== void 0 ? _startItem_parentKey : null;
+        if (key == null) return null;
         // Find the next item
         key = this.findNextKey(key, (item)=>item.type === 'item');
         if (key != null) {
             // If focus was on a cell, focus the cell with the same index in the next row.
             if (this.isCell(startItem)) {
+                var _getNthItem;
                 let item = this.collection.getItem(key);
-                return (0, $kbsd1$getNthItem)((0, $kbsd1$getChildNodes)(item, this.collection), startItem.index).key;
+                if (!item) return null;
+                var _startItem_index, _getNthItem_key;
+                return (_getNthItem_key = (_getNthItem = (0, $kbsd1$getNthItem)((0, $kbsd1$getChildNodes)(item, this.collection), (_startItem_index = startItem.index) !== null && _startItem_index !== void 0 ? _startItem_index : 0)) === null || _getNthItem === void 0 ? void 0 : _getNthItem.key) !== null && _getNthItem_key !== void 0 ? _getNthItem_key : null;
             }
             // Otherwise, focus the next row
             if (this.focusMode === 'row') return key;
         }
+        return null;
     }
-    getKeyAbove(key) {
+    getKeyAbove(fromKey) {
+        let key = fromKey;
         let startItem = this.collection.getItem(key);
-        if (!startItem) return;
+        if (!startItem) return null;
+        var _startItem_parentKey;
         // If focus is on a cell, start searching from the parent row
-        if (this.isCell(startItem)) key = startItem.parentKey;
+        if (this.isCell(startItem)) key = (_startItem_parentKey = startItem.parentKey) !== null && _startItem_parentKey !== void 0 ? _startItem_parentKey : null;
+        if (key == null) return null;
         // Find the previous item
         key = this.findPreviousKey(key, (item)=>item.type === 'item');
         if (key != null) {
             // If focus was on a cell, focus the cell with the same index in the previous row.
             if (this.isCell(startItem)) {
+                var _getNthItem;
                 let item = this.collection.getItem(key);
-                return (0, $kbsd1$getNthItem)((0, $kbsd1$getChildNodes)(item, this.collection), startItem.index).key;
+                if (!item) return null;
+                var _startItem_index;
+                return ((_getNthItem = (0, $kbsd1$getNthItem)((0, $kbsd1$getChildNodes)(item, this.collection), (_startItem_index = startItem.index) !== null && _startItem_index !== void 0 ? _startItem_index : 0)) === null || _getNthItem === void 0 ? void 0 : _getNthItem.key) || null;
             }
             // Otherwise, focus the previous row
             if (this.focusMode === 'row') return key;
         }
+        return null;
     }
     getKeyRightOf(key) {
         let item = this.collection.getItem(key);
-        if (!item) return;
+        if (!item) return null;
         // If focus is on a row, focus the first child cell.
         if (this.isRow(item)) {
+            var _getLastItem, _getFirstItem;
             let children = (0, $kbsd1$getChildNodes)(item, this.collection);
-            return this.direction === 'rtl' ? (0, $kbsd1$getLastItem)(children).key : (0, $kbsd1$getFirstItem)(children).key;
+            var _ref;
+            return (_ref = this.direction === 'rtl' ? (_getLastItem = (0, $kbsd1$getLastItem)(children)) === null || _getLastItem === void 0 ? void 0 : _getLastItem.key : (_getFirstItem = (0, $kbsd1$getFirstItem)(children)) === null || _getFirstItem === void 0 ? void 0 : _getFirstItem.key) !== null && _ref !== void 0 ? _ref : null;
         }
         // If focus is on a cell, focus the next cell if any,
         // otherwise focus the parent row.
-        if (this.isCell(item)) {
+        if (this.isCell(item) && item.parentKey != null) {
             let parent = this.collection.getItem(item.parentKey);
+            if (!parent) return null;
             let children = (0, $kbsd1$getChildNodes)(parent, this.collection);
-            let next = this.direction === 'rtl' ? (0, $kbsd1$getNthItem)(children, item.index - 1) : (0, $kbsd1$getNthItem)(children, item.index + 1);
-            if (next) return next.key;
+            var _ref1;
+            let next = (_ref1 = this.direction === 'rtl' ? (0, $kbsd1$getNthItem)(children, item.index - 1) : (0, $kbsd1$getNthItem)(children, item.index + 1)) !== null && _ref1 !== void 0 ? _ref1 : null;
+            var _next_key;
+            if (next) return (_next_key = next.key) !== null && _next_key !== void 0 ? _next_key : null;
+            var _item_parentKey;
             // focus row only if focusMode is set to row
-            if (this.focusMode === 'row') return item.parentKey;
-            return this.direction === 'rtl' ? this.getFirstKey(key) : this.getLastKey(key);
+            if (this.focusMode === 'row') return (_item_parentKey = item.parentKey) !== null && _item_parentKey !== void 0 ? _item_parentKey : null;
+            var _ref2;
+            return (_ref2 = this.direction === 'rtl' ? this.getFirstKey(key) : this.getLastKey(key)) !== null && _ref2 !== void 0 ? _ref2 : null;
         }
+        return null;
     }
     getKeyLeftOf(key) {
         let item = this.collection.getItem(key);
-        if (!item) return;
+        if (!item) return null;
         // If focus is on a row, focus the last child cell.
         if (this.isRow(item)) {
+            var _getFirstItem, _getLastItem;
             let children = (0, $kbsd1$getChildNodes)(item, this.collection);
-            return this.direction === 'rtl' ? (0, $kbsd1$getFirstItem)(children).key : (0, $kbsd1$getLastItem)(children).key;
+            var _ref;
+            return (_ref = this.direction === 'rtl' ? (_getFirstItem = (0, $kbsd1$getFirstItem)(children)) === null || _getFirstItem === void 0 ? void 0 : _getFirstItem.key : (_getLastItem = (0, $kbsd1$getLastItem)(children)) === null || _getLastItem === void 0 ? void 0 : _getLastItem.key) !== null && _ref !== void 0 ? _ref : null;
         }
         // If focus is on a cell, focus the previous cell if any,
         // otherwise focus the parent row.
-        if (this.isCell(item)) {
+        if (this.isCell(item) && item.parentKey != null) {
             let parent = this.collection.getItem(item.parentKey);
+            if (!parent) return null;
             let children = (0, $kbsd1$getChildNodes)(parent, this.collection);
-            let prev = this.direction === 'rtl' ? (0, $kbsd1$getNthItem)(children, item.index + 1) : (0, $kbsd1$getNthItem)(children, item.index - 1);
-            if (prev) return prev.key;
+            var _ref1;
+            let prev = (_ref1 = this.direction === 'rtl' ? (0, $kbsd1$getNthItem)(children, item.index + 1) : (0, $kbsd1$getNthItem)(children, item.index - 1)) !== null && _ref1 !== void 0 ? _ref1 : null;
+            var _prev_key;
+            if (prev) return (_prev_key = prev.key) !== null && _prev_key !== void 0 ? _prev_key : null;
+            var _item_parentKey;
             // focus row only if focusMode is set to row
-            if (this.focusMode === 'row') return item.parentKey;
-            return this.direction === 'rtl' ? this.getLastKey(key) : this.getFirstKey(key);
+            if (this.focusMode === 'row') return (_item_parentKey = item.parentKey) !== null && _item_parentKey !== void 0 ? _item_parentKey : null;
+            var _ref2;
+            return (_ref2 = this.direction === 'rtl' ? this.getLastKey(key) : this.getFirstKey(key)) !== null && _ref2 !== void 0 ? _ref2 : null;
         }
+        return null;
     }
-    getFirstKey(key, global) {
+    getFirstKey(fromKey, global) {
+        let key = fromKey !== null && fromKey !== void 0 ? fromKey : null;
         let item;
         if (key != null) {
             item = this.collection.getItem(key);
-            if (!item) return;
+            if (!item) return null;
             // If global flag is not set, and a cell is currently focused,
             // move focus to the first cell in the parent row.
-            if (this.isCell(item) && !global) {
+            if (this.isCell(item) && !global && item.parentKey != null) {
+                var _getFirstItem;
                 let parent = this.collection.getItem(item.parentKey);
-                return (0, $kbsd1$getFirstItem)((0, $kbsd1$getChildNodes)(parent, this.collection)).key;
+                if (!parent) return null;
+                var _getFirstItem_key;
+                return (_getFirstItem_key = (_getFirstItem = (0, $kbsd1$getFirstItem)((0, $kbsd1$getChildNodes)(parent, this.collection))) === null || _getFirstItem === void 0 ? void 0 : _getFirstItem.key) !== null && _getFirstItem_key !== void 0 ? _getFirstItem_key : null;
             }
         }
         // Find the first row
-        key = this.findNextKey(null, (item)=>item.type === 'item');
+        key = this.findNextKey(undefined, (item)=>item.type === 'item');
         // If global flag is set (or if focus mode is cell), focus the first cell in the first row.
-        if (key != null && item && this.isCell(item) && global || this.focusMode === 'cell') {
+        if (key != null && (item && this.isCell(item) && global || this.focusMode === 'cell')) {
+            var _getFirstItem1;
             let item = this.collection.getItem(key);
-            key = (0, $kbsd1$getFirstItem)((0, $kbsd1$getChildNodes)(item, this.collection)).key;
+            if (!item) return null;
+            var _getFirstItem_key1;
+            key = (_getFirstItem_key1 = (_getFirstItem1 = (0, $kbsd1$getFirstItem)((0, $kbsd1$getChildNodes)(item, this.collection))) === null || _getFirstItem1 === void 0 ? void 0 : _getFirstItem1.key) !== null && _getFirstItem_key1 !== void 0 ? _getFirstItem_key1 : null;
         }
         // Otherwise, focus the row itself.
         return key;
     }
-    getLastKey(key, global) {
+    getLastKey(fromKey, global) {
+        let key = fromKey !== null && fromKey !== void 0 ? fromKey : null;
         let item;
         if (key != null) {
             item = this.collection.getItem(key);
-            if (!item) return;
+            if (!item) return null;
             // If global flag is not set, and a cell is currently focused,
             // move focus to the last cell in the parent row.
-            if (this.isCell(item) && !global) {
+            if (this.isCell(item) && !global && item.parentKey != null) {
+                var _getLastItem;
                 let parent = this.collection.getItem(item.parentKey);
+                if (!parent) return null;
                 let children = (0, $kbsd1$getChildNodes)(parent, this.collection);
-                return (0, $kbsd1$getLastItem)(children).key;
+                var _getLastItem_key;
+                return (_getLastItem_key = (_getLastItem = (0, $kbsd1$getLastItem)(children)) === null || _getLastItem === void 0 ? void 0 : _getLastItem.key) !== null && _getLastItem_key !== void 0 ? _getLastItem_key : null;
             }
         }
         // Find the last row
-        key = this.findPreviousKey(null, (item)=>item.type === 'item');
+        key = this.findPreviousKey(undefined, (item)=>item.type === 'item');
         // If global flag is set (or if focus mode is cell), focus the last cell in the last row.
-        if (key != null && item && this.isCell(item) && global || this.focusMode === 'cell') {
+        if (key != null && (item && this.isCell(item) && global || this.focusMode === 'cell')) {
+            var _getLastItem1;
             let item = this.collection.getItem(key);
+            if (!item) return null;
             let children = (0, $kbsd1$getChildNodes)(item, this.collection);
-            key = (0, $kbsd1$getLastItem)(children).key;
+            var _getLastItem_key1;
+            key = (_getLastItem_key1 = (_getLastItem1 = (0, $kbsd1$getLastItem)(children)) === null || _getLastItem1 === void 0 ? void 0 : _getLastItem1.key) !== null && _getLastItem_key1 !== void 0 ? _getLastItem_key1 : null;
         }
         // Otherwise, focus the row itself.
         return key;
     }
-    getKeyPageAbove(key) {
+    getKeyPageAbove(fromKey) {
+        let key = fromKey;
         let itemRect = this.layoutDelegate.getItemRect(key);
         if (!itemRect) return null;
         let pageY = Math.max(0, itemRect.y + itemRect.height - this.layoutDelegate.getVisibleRect().height);
-        while(itemRect && itemRect.y > pageY){
-            key = this.getKeyAbove(key);
+        while(itemRect && itemRect.y > pageY && key != null){
+            var _this_getKeyAbove;
+            key = (_this_getKeyAbove = this.getKeyAbove(key)) !== null && _this_getKeyAbove !== void 0 ? _this_getKeyAbove : null;
+            if (key == null) break;
             itemRect = this.layoutDelegate.getItemRect(key);
         }
         return key;
     }
-    getKeyPageBelow(key) {
+    getKeyPageBelow(fromKey) {
+        let key = fromKey;
         let itemRect = this.layoutDelegate.getItemRect(key);
         if (!itemRect) return null;
         let pageHeight = this.layoutDelegate.getVisibleRect().height;
@@ -185,20 +238,27 @@ class $d1c300d9c497e402$export$de9feff04fda126e {
         return key;
     }
     getKeyForSearch(search, fromKey) {
+        let key = fromKey !== null && fromKey !== void 0 ? fromKey : null;
         if (!this.collator) return null;
         let collection = this.collection;
-        let key = fromKey !== null && fromKey !== void 0 ? fromKey : this.getFirstKey();
+        key = fromKey !== null && fromKey !== void 0 ? fromKey : this.getFirstKey();
+        if (key == null) return null;
         // If the starting key is a cell, search from its parent row.
         let startItem = collection.getItem(key);
-        if (startItem.type === 'cell') key = startItem.parentKey;
+        if (!startItem) return null;
+        var _startItem_parentKey;
+        if (startItem.type === 'cell') key = (_startItem_parentKey = startItem.parentKey) !== null && _startItem_parentKey !== void 0 ? _startItem_parentKey : null;
         let hasWrapped = false;
         while(key != null){
             let item = collection.getItem(key);
+            if (!item) return null;
             // check row text value for match
             if (item.textValue) {
                 let substring = item.textValue.slice(0, search.length);
                 if (this.collator.compare(substring, search) === 0) {
-                    if (this.isRow(item) && this.focusMode === 'cell') return (0, $kbsd1$getFirstItem)((0, $kbsd1$getChildNodes)(item, this.collection)).key;
+                    var _getFirstItem;
+                    var _getFirstItem_key;
+                    if (this.isRow(item) && this.focusMode === 'cell') return (_getFirstItem_key = (_getFirstItem = (0, $kbsd1$getFirstItem)((0, $kbsd1$getChildNodes)(item, this.collection))) === null || _getFirstItem === void 0 ? void 0 : _getFirstItem.key) !== null && _getFirstItem_key !== void 0 ? _getFirstItem_key : null;
                     return item.key;
                 }
             }
@@ -217,6 +277,7 @@ class $d1c300d9c497e402$export$de9feff04fda126e {
         this.disabledBehavior = options.disabledBehavior || 'all';
         this.direction = options.direction;
         this.collator = options.collator;
+        if (!options.layout && !options.ref) throw new Error('Either a layout or a ref must be specified.');
         this.layoutDelegate = options.layoutDelegate || (options.layout ? new $d1c300d9c497e402$var$DeprecatedLayoutDelegate(options.layout) : new (0, $kbsd1$DOMLayoutDelegate)(options.ref));
         this.focusMode = options.focusMode || 'row';
     }