@nanoporetech-digital/components 3.5.1 → 3.6.0

package/dist/types/components.d.ts

@@ -1099,7 +1099,7 @@ export namespace Components {
          */
         "icon"?: any;
         /**
-          * If enabled, nano-icon will be loaded lazily when it's visible in the viewport. Default, `false`.
+          * If enabled, nano-icon will be loaded lazily when it's visible in the viewport. Default, `true`.
          */
         "lazy": boolean;
         /**
@@ -1583,6 +1583,10 @@ export namespace Components {
         "value": number;
     }
     interface NanoResizeObserve {
+        /**
+          * Fire `nanoResizeContentFitChange` events notifying whether content currently fits or does not on the x, y or both axis'. Also makes the `content-fit-...` slots available
+         */
+        "notifyContentFit": 'x' | 'y' | 'xy';
         /**
           * string list of sizes and optional class-names. Adds class-names and fires nanoResizeStateChange events. Upon hitting breakpoints. Format: `states="800w, 300h class1 class2"`
          */
@@ -2019,20 +2023,22 @@ export namespace Components {
          */
         "caption": string;
         /**
-          * The column config used to generate present the rows of data
+          * The column config used to present the rows of data
          */
         "columns": TableTypes.NanoTable['columns'];
         /**
-          * A custom filtering function. Should return a promise. On successful completion the column UI will be updated. A good use-case would be performing the filter on a server / via fetch. Then on success, updating the table's data via the `rows` property
+          * A custom filtering function. Should return a promise. If the promise resolves as `true` the column UI will be updated. If the promise resolves as falsey, the sort will be performed by the component. A good use-case would be performing the filter on a server / via fetch. Then on success, updating the table's data via the `rows` property
          */
-        "customFilterFn"?: (filters: TableTypes.Filter[]) => Promise<void>;
+        "customFilterFn"?: (
+    filters: TableTypes.Filter[]
+  ) => Promise<true | TableTypes.Falsy>;
         /**
-          * A custom sorting function. Should return a promise. On successful completion the column UI will be updated. A good use-case would be performing the sort on a server / via fetch. Then on success, updating the table's data via the `rows` property
+          * A custom sorting function. Should return a promise. If the promise resolves as `true` the column UI will be updated. If the promise resolves as falsey, the sort will be performed by the component. A good use-case would be performing the sort on a server / via fetch. Then on success, updating the table's data via the `rows` property
          */
         "customSortFn"?: (
     property: TableTypes.Prop,
     order: TableTypes.Order
-  ) => Promise<void>;
+  ) => Promise<true | TableTypes.Falsy>;
         /**
           * The default draggable option for all columns. `true` will enable column drag-to-reorder unless you set `draggable: false` on a column `false` will disable column drag-to-reorder unless you set `draggable: true` on a column
          */
@@ -2050,7 +2056,7 @@ export namespace Components {
          */
         "headRender": TableTypes.HeadFootRenderer;
         /**
-          * Will show a loading state when true. Will be shown automatically if `rows` is a promise waiting to resolve or when performing custom filtering or sorting
+          * Will show a loading state when set to true. By default, will be shown automatically if `rows` is a promise waiting to resolve or when performing custom filtering or sorting. *Note* when set manually, will overwrite any internal loading state. Set to 'undefined' to revert to default behaviour.
          */
         "loading": boolean;
         /**
@@ -2102,6 +2108,16 @@ export namespace Components {
           * The type of table. Grid type will make cells navigable by keyboard
          */
         "type": 'grid' | 'table';
+        /**
+          * Updates a row model at a given index
+          * @param row - the row to update. *Note* - this should come from the `col.cellTemplate` or `row.rowRender.template`  `rowModel` property - rows are augmented with certain properties to aid with efficient rendering
+          * @param rowIndex - the row index to insert this row
+         */
+        "updateRow": (row: TableTypes.RowData, rowIndex: number) => Promise<void>;
+        /**
+          * Use this to render the table with roughly the correct dimensions. a use-case might be; fetch a small initial dataset to minimise load-time, render the table with the correct dimensions, the table becomes interactive, load the rest of the data
+         */
+        "virtualTotalItems": number;
     }
     interface NanoTooltip {
         /**
@@ -2120,6 +2136,10 @@ export namespace Components {
           * Hides the tooltip.
          */
         "hide": () => Promise<void>;
+        /**
+          * Enable this option to prevent the panel from being clipped when the component is placed inside a container with `overflow: auto|scroll`.
+         */
+        "hoist": boolean;
         /**
           * Indicates whether or not the tooltip is open. You can use this in lieu of the show/hide methods.
          */
@@ -3808,7 +3828,7 @@ declare namespace LocalJSX {
          */
         "icon"?: any;
         /**
-          * If enabled, nano-icon will be loaded lazily when it's visible in the viewport. Default, `false`.
+          * If enabled, nano-icon will be loaded lazily when it's visible in the viewport. Default, `true`.
          */
         "lazy"?: boolean;
         /**
@@ -4335,6 +4355,17 @@ declare namespace LocalJSX {
         "value"?: number;
     }
     interface NanoResizeObserve {
+        /**
+          * Fire `nanoResizeContentFitChange` events notifying whether content currently fits or does not on the x, y or both axis'. Also makes the `content-fit-...` slots available
+         */
+        "notifyContentFit"?: 'x' | 'y' | 'xy';
+        /**
+          * Fires when the content either begins or stops to fit. Will only work when `notifyContentFit` is set.
+         */
+        "onNanoResizeContentFitChange"?: (event: NanoResizeObserveCustomEvent<{
+    x: boolean;
+    y: boolean;
+  }>) => void;
         /**
           * Fires after the initial loading and assessment
          */
@@ -4763,20 +4794,22 @@ declare namespace LocalJSX {
          */
         "caption"?: string;
         /**
-          * The column config used to generate present the rows of data
+          * The column config used to present the rows of data
          */
         "columns"?: TableTypes.NanoTable['columns'];
         /**
-          * A custom filtering function. Should return a promise. On successful completion the column UI will be updated. A good use-case would be performing the filter on a server / via fetch. Then on success, updating the table's data via the `rows` property
+          * A custom filtering function. Should return a promise. If the promise resolves as `true` the column UI will be updated. If the promise resolves as falsey, the sort will be performed by the component. A good use-case would be performing the filter on a server / via fetch. Then on success, updating the table's data via the `rows` property
          */
-        "customFilterFn"?: (filters: TableTypes.Filter[]) => Promise<void>;
+        "customFilterFn"?: (
+    filters: TableTypes.Filter[]
+  ) => Promise<true | TableTypes.Falsy>;
         /**
-          * A custom sorting function. Should return a promise. On successful completion the column UI will be updated. A good use-case would be performing the sort on a server / via fetch. Then on success, updating the table's data via the `rows` property
+          * A custom sorting function. Should return a promise. If the promise resolves as `true` the column UI will be updated. If the promise resolves as falsey, the sort will be performed by the component. A good use-case would be performing the sort on a server / via fetch. Then on success, updating the table's data via the `rows` property
          */
         "customSortFn"?: (
     property: TableTypes.Prop,
     order: TableTypes.Order
-  ) => Promise<void>;
+  ) => Promise<true | TableTypes.Falsy>;
         /**
           * The default draggable option for all columns. `true` will enable column drag-to-reorder unless you set `draggable: false` on a column `false` will disable column drag-to-reorder unless you set `draggable: true` on a column
          */
@@ -4794,7 +4827,7 @@ declare namespace LocalJSX {
          */
         "headRender"?: TableTypes.HeadFootRenderer;
         /**
-          * Will show a loading state when true. Will be shown automatically if `rows` is a promise waiting to resolve or when performing custom filtering or sorting
+          * Will show a loading state when set to true. By default, will be shown automatically if `rows` is a promise waiting to resolve or when performing custom filtering or sorting. *Note* when set manually, will overwrite any internal loading state. Set to 'undefined' to revert to default behaviour.
          */
         "loading"?: boolean;
         /**
@@ -4812,6 +4845,10 @@ declare namespace LocalJSX {
     column: TableTypes.Prop;
     order: TableTypes.Order;
   }>) => void;
+        /**
+          * Fired before a general search. `event.preventDefault()` to stop searching.
+         */
+        "onNanoTblBeforeEdit"?: (event: NanoTableCustomEvent<{ term: string }>) => void;
         /**
           * Fired before a column is filtered. `event.preventDefault()` to stop filtering.
          */
@@ -4886,6 +4923,10 @@ declare namespace LocalJSX {
           * The type of table. Grid type will make cells navigable by keyboard
          */
         "type"?: 'grid' | 'table';
+        /**
+          * Use this to render the table with roughly the correct dimensions. a use-case might be; fetch a small initial dataset to minimise load-time, render the table with the correct dimensions, the table becomes interactive, load the rest of the data
+         */
+        "virtualTotalItems"?: number;
     }
     interface NanoTooltip {
         /**
@@ -4900,6 +4941,10 @@ declare namespace LocalJSX {
           * The distance in pixels from which to offset the tooltip away from its target.
          */
         "distance"?: number;
+        /**
+          * Enable this option to prevent the panel from being clipped when the component is placed inside a container with `overflow: auto|scroll`.
+         */
+        "hoist"?: boolean;
         /**
           * Emitted after the tooltip has hidden and all transitions are complete.
          */

package/dist/types/utils/date-utils.d.ts

@@ -11,7 +11,7 @@ export declare enum DaysOfWeek {
  * @param year
  * @param month
  * @param day
- * @returns a new Date objecy
+ * @returns a new Date object
  */
 export declare function createDate(year: string, month: string, day: string): Date;
 /**

package/docs-json.json

@@ -1,5 +1,5 @@
 {
-  "timestamp": "2022-12-14T12:36:55",
+  "timestamp": "2022-12-23T16:36:52",
   "compiler": {
     "name": "@stencil/core",
     "version": "2.19.4",
@@ -3941,7 +3941,8 @@
           "nano-progress-bar",
           "nano-skeleton",
           "nano-spinner",
-          "nano-icon"
+          "nano-icon",
+          "nano-tooltip"
         ]
       }
     },
@@ -7839,7 +7840,7 @@
           "mutable": false,
           "attr": "lazy",
           "reflectToAttr": false,
-          "docs": "If enabled, nano-icon will be loaded lazily when it's visible in the viewport.\nDefault, `false`.",
+          "docs": "If enabled, nano-icon will be loaded lazily when it's visible in the viewport.\nDefault, `true`.",
           "docsTags": [],
           "default": "true",
           "values": [
@@ -11542,18 +11543,61 @@
     },
     {
       "filePath": "./src/components/resize-observe/resize-observe.tsx",
-      "encapsulation": "none",
+      "encapsulation": "shadow",
       "tag": "nano-resize-observe",
       "readme": "# nano-resize-observe\n\n\n",
-      "docs": "A Resize-Observer utility component.\nTakes a string list of sizes and optional class-names. Adds class-names and fires `nanoResizeStateChange` events when the component reaches those sizes.",
+      "docs": "A Resize-Observer utility component.\nTakes a string list of sizes and optional class-names.\nAdds class-names and fires `nanoResizeStateChange` events when the component reaches those sizes.\nAdditionally, can fire events when content no-longer fits within the element.",
       "docsTags": [
         {
           "name": "slot",
           "text": "- Main slot for any content."
+        },
+        {
+          "name": "slot",
+          "text": "content-fit-x - optional slot (when `notifyContentFit` is set). Shows when content fits / doesn't get cut off"
+        },
+        {
+          "name": "slot",
+          "text": "content-nofit-x - optional slot (when `notifyContentFit` is set). Shows when content doesn't get cut off"
+        },
+        {
+          "name": "slot",
+          "text": "content-fit-y - optional slot (when `notifyContentFit` is set). Shows when content fits / doesn't get cut off"
+        },
+        {
+          "name": "slot",
+          "text": "content-nofit-y - optional slot (when `notifyContentFit` is set). Shows when content doesn't get cut off"
         }
       ],
       "usage": {},
       "props": [
+        {
+          "name": "notifyContentFit",
+          "type": "\"x\" | \"xy\" | \"y\"",
+          "mutable": false,
+          "attr": "notify-content-fit",
+          "reflectToAttr": false,
+          "docs": "Fire `nanoResizeContentFitChange` events notifying\nwhether content currently fits or does not on the x, y or both axis'.\nAlso makes the `content-fit-...` slots available",
+          "docsTags": [],
+          "values": [
+            {
+              "value": "x",
+              "type": "string"
+            },
+            {
+              "value": "xy",
+              "type": "string"
+            },
+            {
+              "value": "y",
+              "type": "string"
+            }
+          ],
+          "optional": false,
+          "required": false,
+          "getter": false,
+          "setter": false
+        },
         {
           "name": "states",
           "type": "string",
@@ -11575,6 +11619,15 @@
       ],
       "methods": [],
       "events": [
+        {
+          "event": "nanoResizeContentFitChange",
+          "detail": "{ x: boolean; y: boolean; }",
+          "bubbles": true,
+          "cancelable": true,
+          "composed": true,
+          "docs": "Fires when the content either begins or stops to fit. Will only work when `notifyContentFit` is set.",
+          "docsTags": []
+        },
         {
           "event": "nanoResizeObserverReady",
           "detail": "void",
@@ -11600,6 +11653,22 @@
         {
           "name": "",
           "docs": "Main slot for any content."
+        },
+        {
+          "name": "content-fit-x",
+          "docs": "optional slot (when `notifyContentFit` is set). Shows when content fits / doesn't get cut off"
+        },
+        {
+          "name": "content-fit-y",
+          "docs": "optional slot (when `notifyContentFit` is set). Shows when content fits / doesn't get cut off"
+        },
+        {
+          "name": "content-nofit-x",
+          "docs": "optional slot (when `notifyContentFit` is set). Shows when content doesn't get cut off"
+        },
+        {
+          "name": "content-nofit-y",
+          "docs": "optional slot (when `notifyContentFit` is set). Shows when content doesn't get cut off"
         }
       ],
       "parts": [],
@@ -14734,15 +14803,15 @@
         },
         {
           "name": "columns",
-          "type": "ColumnConfig<RowData>[]",
+          "type": "ColumnConfig<RowGeneric>[]",
           "mutable": true,
           "reflectToAttr": false,
-          "docs": "The column config used to generate present the rows of data",
+          "docs": "The column config used to present the rows of data",
           "docsTags": [],
           "default": "[]",
           "values": [
             {
-              "type": "ColumnConfig<RowData>[]"
+              "type": "ColumnConfig<RowGeneric>[]"
             }
           ],
           "optional": false,
@@ -14752,14 +14821,17 @@
         },
         {
           "name": "customFilterFn",
-          "type": "(filters: Filter[]) => Promise<void>",
+          "type": "(filters: Filter[]) => Promise<true | Falsy>",
           "mutable": false,
           "reflectToAttr": false,
-          "docs": "A custom filtering function. Should return a promise.\nOn successful completion the column UI will be updated.\nA good use-case would be performing the filter on a server / via fetch.\nThen on success, updating the table's data via the `rows` property",
+          "docs": "A custom filtering function. Should return a promise.\nIf the promise resolves as `true` the column UI will be updated.\nIf the promise resolves as falsey, the sort will be performed by the component.\nA good use-case would be performing the filter on a server / via fetch.\nThen on success, updating the table's data via the `rows` property",
           "docsTags": [],
           "values": [
             {
-              "type": "(filters: Filter[]) => Promise<void>"
+              "type": "(filters: Filter[]) => Promise<true"
+            },
+            {
+              "type": "Falsy>"
             }
           ],
           "optional": true,
@@ -14769,14 +14841,17 @@
         },
         {
           "name": "customSortFn",
-          "type": "(property: keyof RowData, order: Order) => Promise<void>",
+          "type": "(property: keyof RowGeneric, order: Order) => Promise<true | Falsy>",
           "mutable": false,
           "reflectToAttr": false,
-          "docs": "A custom sorting function. Should return a promise.\nOn successful completion the column UI will be updated.\nA good use-case would be performing the sort on a server / via fetch.\nThen on success, updating the table's data via the `rows` property",
+          "docs": "A custom sorting function. Should return a promise.\nIf the promise resolves as `true` the column UI will be updated.\nIf the promise resolves as falsey, the sort will be performed by the component.\nA good use-case would be performing the sort on a server / via fetch.\nThen on success, updating the table's data via the `rows` property",
           "docsTags": [],
           "values": [
             {
-              "type": "(property: keyof RowData, order: Order) => Promise<void>"
+              "type": "(property: keyof RowGeneric, order: Order) => Promise<true"
+            },
+            {
+              "type": "Falsy>"
             }
           ],
           "optional": true,
@@ -14864,9 +14939,9 @@
           "mutable": false,
           "attr": "loading",
           "reflectToAttr": false,
-          "docs": "Will show a loading state when true.\nWill be shown automatically if `rows` is a promise waiting to resolve\nor when performing custom filtering or sorting",
+          "docs": "Will show a loading state when set to true.\nBy default, will be shown automatically if `rows` is a promise waiting to resolve\nor when performing custom filtering or sorting.\n*Note* when set manually, will overwrite any internal loading state.\nSet to 'undefined' to revert to default behaviour.",
           "docsTags": [],
-          "default": "false",
+          "default": "undefined",
           "values": [
             {
               "type": "boolean"
@@ -14874,8 +14949,8 @@
           ],
           "optional": false,
           "required": false,
-          "getter": true,
-          "setter": true
+          "getter": false,
+          "setter": false
         },
         {
           "name": "perBlock",
@@ -14917,14 +14992,14 @@
         },
         {
           "name": "rowRender",
-          "type": "RowRenderer",
+          "type": "RowRenderer<RowData<RowGeneric>>",
           "mutable": false,
           "reflectToAttr": false,
           "docs": "Used for custom row rendering",
           "docsTags": [],
           "values": [
             {
-              "type": "RowRenderer"
+              "type": "RowRenderer<RowData<RowGeneric>>"
             }
           ],
           "optional": false,
@@ -14934,17 +15009,17 @@
         },
         {
           "name": "rows",
-          "type": "Promise<RowData[]> | RowData[]",
-          "mutable": false,
+          "type": "Promise<RowGeneric[]> | RowGeneric[]",
+          "mutable": true,
           "reflectToAttr": false,
           "docs": "The data to place in the table",
           "docsTags": [],
           "values": [
             {
-              "type": "Promise<RowData[]>"
+              "type": "Promise<RowGeneric[]>"
             },
             {
-              "type": "RowData[]"
+              "type": "RowGeneric[]"
             }
           ],
           "optional": false,
@@ -15031,6 +15106,25 @@
           "required": false,
           "getter": false,
           "setter": false
+        },
+        {
+          "name": "virtualTotalItems",
+          "type": "number",
+          "mutable": false,
+          "attr": "virtual-total-items",
+          "reflectToAttr": false,
+          "docs": "Use this to render the table with roughly the correct dimensions.\na use-case might be; fetch a small initial dataset to minimise load-time,\nrender the table with the correct dimensions, the table becomes interactive,\nload the rest of the data",
+          "docsTags": [],
+          "default": "0",
+          "values": [
+            {
+              "type": "number"
+            }
+          ],
+          "optional": false,
+          "required": false,
+          "getter": false,
+          "setter": false
         }
       ],
       "methods": [
@@ -15125,6 +15219,26 @@
               "text": "a promise which resolves when complete"
             }
           ]
+        },
+        {
+          "name": "updateRow",
+          "returns": {
+            "type": "Promise<void>",
+            "docs": ""
+          },
+          "signature": "updateRow(row: TableTypes.RowData, rowIndex: number) => Promise<void>",
+          "parameters": [],
+          "docs": "Updates a row model at a given index",
+          "docsTags": [
+            {
+              "name": "param",
+              "text": "row - the row to update.\n*Note* - this should come from the `col.cellTemplate` or `row.rowRender.template`  `rowModel` property\n- rows are augmented with certain properties to aid with efficient rendering"
+            },
+            {
+              "name": "param",
+              "text": "rowIndex - the row index to insert this row"
+            }
+          ]
         }
       ],
       "events": [
@@ -15148,13 +15262,22 @@
         },
         {
           "event": "nanoTblAfterSort",
-          "detail": "{ column: keyof RowData; order: Order; }",
+          "detail": "{ column: keyof RowGeneric; order: Order; }",
           "bubbles": true,
           "cancelable": true,
           "composed": true,
           "docs": "Fired after a column is sorted",
           "docsTags": []
         },
+        {
+          "event": "nanoTblBeforeEdit",
+          "detail": "{ term: string; }",
+          "bubbles": true,
+          "cancelable": true,
+          "composed": true,
+          "docs": "Fired before a general search.\n`event.preventDefault()` to stop searching.",
+          "docsTags": []
+        },
         {
           "event": "nanoTblBeforeFilter",
           "detail": "{ filters: Filter[]; }",
@@ -15175,7 +15298,7 @@
         },
         {
           "event": "nanoTblBeforeSort",
-          "detail": "{ column: keyof RowData; order: Order; }",
+          "detail": "{ column: keyof RowGeneric; order: Order; }",
           "bubbles": true,
           "cancelable": true,
           "composed": true,
@@ -15193,7 +15316,7 @@
         },
         {
           "event": "nanoTblColDrag",
-          "detail": "{ column: keyof RowData; }",
+          "detail": "{ column: keyof RowGeneric; }",
           "bubbles": true,
           "cancelable": true,
           "composed": true,
@@ -15202,7 +15325,7 @@
         },
         {
           "event": "nanoTblColDrop",
-          "detail": "{ fromCol: keyof RowData; toCol: keyof RowData; fromIndex: number; toIndex: number; }",
+          "detail": "{ fromCol: keyof RowGeneric; toCol: keyof RowGeneric; fromIndex: number; toIndex: number; }",
           "bubbles": true,
           "cancelable": true,
           "composed": true,
@@ -15398,7 +15521,8 @@
         "nano-progress-bar",
         "nano-skeleton",
         "nano-spinner",
-        "nano-icon"
+        "nano-icon",
+        "nano-tooltip"
       ],
       "dependencyGraph": {
         "nano-table": [
@@ -15406,7 +15530,8 @@
           "nano-progress-bar",
           "nano-skeleton",
           "nano-spinner",
-          "nano-icon"
+          "nano-icon",
+          "nano-tooltip"
         ],
         "nano-demo": [
           "nano-table"
@@ -15488,6 +15613,25 @@
           "getter": false,
           "setter": false
         },
+        {
+          "name": "hoist",
+          "type": "boolean",
+          "mutable": false,
+          "attr": "hoist",
+          "reflectToAttr": false,
+          "docs": "Enable this option to prevent the panel from being clipped when the component is placed inside a container with\n`overflow: auto|scroll`.",
+          "docsTags": [],
+          "default": "false",
+          "values": [
+            {
+              "type": "boolean"
+            }
+          ],
+          "optional": false,
+          "required": false,
+          "getter": false,
+          "setter": false
+        },
         {
           "name": "open",
           "type": "boolean",
@@ -15727,12 +15871,16 @@
         }
       ],
       "dependents": [
-        "nano-file-upload"
+        "nano-file-upload",
+        "nano-table"
       ],
       "dependencies": [],
       "dependencyGraph": {
         "nano-file-upload": [
           "nano-tooltip"
+        ],
+        "nano-table": [
+          "nano-tooltip"
         ]
       }
     }

package/docs-vscode.json

@@ -1484,7 +1484,7 @@
         },
         {
           "name": "lazy",
-          "description": "If enabled, nano-icon will be loaded lazily when it's visible in the viewport.\nDefault, `false`."
+          "description": "If enabled, nano-icon will be loaded lazily when it's visible in the viewport.\nDefault, `true`."
         },
         {
           "name": "name",
@@ -2187,9 +2187,24 @@
       "name": "nano-resize-observe",
       "description": {
         "kind": "markdown",
-        "value": "A Resize-Observer utility component.\nTakes a string list of sizes and optional class-names. Adds class-names and fires `nanoResizeStateChange` events when the component reaches those sizes."
+        "value": "A Resize-Observer utility component.\nTakes a string list of sizes and optional class-names.\nAdds class-names and fires `nanoResizeStateChange` events when the component reaches those sizes.\nAdditionally, can fire events when content no-longer fits within the element."
       },
       "attributes": [
+        {
+          "name": "notify-content-fit",
+          "description": "Fire `nanoResizeContentFitChange` events notifying\nwhether content currently fits or does not on the x, y or both axis'.\nAlso makes the `content-fit-...` slots available",
+          "values": [
+            {
+              "name": "x"
+            },
+            {
+              "name": "xy"
+            },
+            {
+              "name": "y"
+            }
+          ]
+        },
         {
           "name": "states",
           "description": "string list of sizes and optional class-names. Adds class-names and fires nanoResizeStateChange events. Upon hitting breakpoints.\nFormat: `states=\"800w, 300h class1 class2\"`"
@@ -2707,7 +2722,7 @@
         },
         {
           "name": "loading",
-          "description": "Will show a loading state when true.\nWill be shown automatically if `rows` is a promise waiting to resolve\nor when performing custom filtering or sorting"
+          "description": "Will show a loading state when set to true.\nBy default, will be shown automatically if `rows` is a promise waiting to resolve\nor when performing custom filtering or sorting.\n*Note* when set manually, will overwrite any internal loading state.\nSet to 'undefined' to revert to default behaviour."
         },
         {
           "name": "per-block",
@@ -2740,6 +2755,10 @@
               "name": "table"
             }
           ]
+        },
+        {
+          "name": "virtual-total-items",
+          "description": "Use this to render the table with roughly the correct dimensions.\na use-case might be; fetch a small initial dataset to minimise load-time,\nrender the table with the correct dimensions, the table becomes interactive,\nload the rest of the data"
         }
       ]
     },
@@ -2762,6 +2781,10 @@
           "name": "distance",
           "description": "The distance in pixels from which to offset the tooltip away from its target."
         },
+        {
+          "name": "hoist",
+          "description": "Enable this option to prevent the panel from being clipped when the component is placed inside a container with\n`overflow: auto|scroll`."
+        },
         {
           "name": "open",
           "description": "Indicates whether or not the tooltip is open. You can use this in lieu of the show/hide methods."