@databiosphere/findable-ui 0.0.0

package/lib/hooks/useFileManifest/useFileManifestDownload.js

@@ -0,0 +1,92 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useFileManifestDownload = void 0;
+const react_1 = require("react");
+const entities_1 = require("../../apis/azul/common/entities");
+const entities_2 = require("../../components/Export/common/entities");
+const useCatalog_1 = require("../useCatalog");
+const buildFileManifestRequestURL_1 = require("./common/buildFileManifestRequestURL");
+const useFileManifest_1 = require("./useFileManifest");
+const useFileManifestURL_1 = require("./useFileManifestURL");
+/**
+ * Returns file manifest download url and file name.
+ * @param filters - Filters.
+ * @param disabled - Disabled.
+ * @returns file manifest download url and file name.
+ */
+const useFileManifestDownload = (filters, disabled) => {
+    // Determine file manifest request data URL.
+    const URL = (0, useFileManifestURL_1.useFileManifestURL)();
+    // Determine catalog.
+    const catalog = (0, useCatalog_1.useCatalog)(); // catalog should be defined.
+    // Build request URL.
+    const { requestURL } = (0, buildFileManifestRequestURL_1.buildFileManifestRequestURL)(URL, filters, catalog, entities_1.MANIFEST_DOWNLOAD_FORMAT.COMPACT) || {};
+    const { data, isIdle, isLoading, run } = (0, useFileManifest_1.useFileManifest)(requestURL);
+    const manifestURL = getManifestDownloadURL(data);
+    const fileName = getManifestDownloadFileName(data);
+    // Requests file manifest.
+    (0, react_1.useEffect)(() => {
+        if (disabled)
+            return;
+        run();
+    }, [disabled, requestURL, run]);
+    return {
+        fileName,
+        isIdle,
+        isLoading,
+        manifestURL,
+    };
+};
+exports.useFileManifestDownload = useFileManifestDownload;
+/**
+ * Returns the manifest download URL for the generated manifest.
+ * @param fileLocation - Request file location.
+ * @returns manifest download URL.
+ */
+function getManifestDownloadURL(fileLocation) {
+    const { location } = fileLocation || {};
+    return location;
+}
+/**
+ * Returns the manifest download file name for the generated manifest.
+ * @param fileLocation - File location.
+ * @returns manifest download file name.
+ */
+function getManifestDownloadFileName(fileLocation) {
+    if (!fileLocation) {
+        return;
+    }
+    const fileName = getFileNameFromLocation(fileLocation.location);
+    if (fileName) {
+        return fileName;
+    }
+    return getFileNameFromBash(fileLocation.commandLine);
+}
+/**
+ * Returns the file name from the specified bash command line, if it exists.
+ * @param commandLine - Command line.
+ * @returns file name.
+ */
+function getFileNameFromBash(commandLine) {
+    if (!commandLine) {
+        return;
+    }
+    return commandLine[entities_2.BULK_DOWNLOAD_EXECUTION_ENVIRONMENT.BASH]
+        .split("'")
+        .filter((b) => b.includes("tsv"))
+        .shift();
+}
+/**
+ * Returns the file name from the specified file location, if it exists.
+ * @param location - File location.
+ * @returns file name.
+ */
+function getFileNameFromLocation(location) {
+    const searchParams = new URL(location).searchParams;
+    const paramValue = searchParams.get("response-content-disposition");
+    if (!paramValue) {
+        return;
+    }
+    const match = paramValue.match(/filename=([^&;]*)/);
+    return match === null || match === void 0 ? void 0 : match[1].replace(/"/g, "");
+}

package/lib/hooks/useFileManifest/useFileManifestSpreadsheet.d.ts

@@ -0,0 +1,14 @@
+import { Filters } from "../../common/entities";
+export interface ManifestSpreadsheet {
+    exists?: boolean;
+    fileFormat?: string;
+    fileName?: string;
+    fileUrl?: string;
+}
+/**
+ * Returns file manifest spreadsheet.
+ * @param filters - Filters.
+ * @param disabled - Disabled.
+ * @returns file manifest spreadsheet.
+ */
+export declare const useFileManifestSpreadsheet: (filters: Filters, disabled: boolean) => ManifestSpreadsheet | undefined;

package/lib/hooks/useFileManifest/useFileManifestSpreadsheet.js

@@ -0,0 +1,77 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useFileManifestSpreadsheet = void 0;
+const react_1 = require("react");
+const entities_1 = require("../../apis/azul/common/entities");
+const service_1 = require("../../entity/common/service");
+const fetchQueryParams_1 = require("../../utils/fetchQueryParams");
+const useAsync_1 = require("../useAsync");
+const useCatalog_1 = require("../useCatalog");
+const useFetchRequestURL_1 = require("../useFetchRequestURL");
+/**
+ * Returns file manifest spreadsheet.
+ * @param filters - Filters.
+ * @param disabled - Disabled.
+ * @returns file manifest spreadsheet.
+ */
+const useFileManifestSpreadsheet = (filters, disabled) => {
+    // Determine catalog.
+    const catalog = (0, useCatalog_1.useCatalog)(); // catalog should be defined.
+    // Build request params.
+    const requestParams = (0, fetchQueryParams_1.fetchQueryParams)(filters, catalog, { size: "25" });
+    // Build request URL.
+    const requestURL = (0, useFetchRequestURL_1.useFetchRequestURL)(entities_1.APIEndpoints.FILES, requestParams);
+    // Fetch files to determine if file exists.
+    const { data, run } = (0, useAsync_1.useAsync)();
+    // Grab manifest spreadsheet.
+    const manifestSpreadsheet = (0, react_1.useMemo)(() => getManifestSpreadsheet(data === null || data === void 0 ? void 0 : data.hits), [data]);
+    // Fetch response from files endpoint.
+    (0, react_1.useEffect)(() => {
+        if (disabled)
+            return;
+        run((0, service_1.fetchEntitiesFromURL)(requestURL, undefined));
+    }, [disabled, requestURL, run]);
+    return manifestSpreadsheet;
+};
+exports.useFileManifestSpreadsheet = useFileManifestSpreadsheet;
+/**
+ * Prepend "/fetch" to the path of the specified file URL, if not already included.
+ * @param fileUrl - File URL.
+ * @returns File URL with "/fetch" prepended to the path.
+ */
+function buildFetchFileUrl(fileUrl) {
+    if (!fileUrl) {
+        return;
+    }
+    const url = new URL(fileUrl);
+    const path = url.pathname;
+    if (path.indexOf(entities_1.APIEndpoints.FETCH) !== 0) {
+        url.pathname = `${entities_1.APIEndpoints.FETCH}${path}`;
+    }
+    return url.toString();
+}
+/**
+ * Returns manifest spreadsheet.
+ * @param files - Files.
+ * @returns manifest spreadsheet.
+ */
+function getManifestSpreadsheet(files) {
+    var _a, _b, _c;
+    if (!files) {
+        return;
+    }
+    // Handle case where file does not exist.
+    if (files.length === 0) {
+        return {
+            exists: false,
+        };
+    }
+    // Project manifest spreadsheet exists.
+    const file = files[0];
+    return {
+        exists: true,
+        fileFormat: (_a = file.files[0]) === null || _a === void 0 ? void 0 : _a.format,
+        fileName: (_b = file.files[0]) === null || _b === void 0 ? void 0 : _b.name,
+        fileUrl: buildFetchFileUrl((_c = file.files[0]) === null || _c === void 0 ? void 0 : _c.url),
+    };
+}

package/lib/hooks/useFileManifest/useFileManifestURL.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Returns data URL for the integrations end point.
+ * @returns data URL for the integrations end point.
+ */
+export declare const useFileManifestURL: () => string;

package/lib/hooks/useFileManifest/useFileManifestURL.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useFileManifestURL = void 0;
+const useConfig_1 = require("../useConfig");
+/**
+ * Returns data URL for the integrations end point.
+ * @returns data URL for the integrations end point.
+ */
+const useFileManifestURL = () => {
+    const { config } = (0, useConfig_1.useConfig)();
+    const { dataSource } = config;
+    const { url } = dataSource;
+    return url;
+};
+exports.useFileManifestURL = useFileManifestURL;

package/lib/hooks/useFileManifest/useRequestFileManifest.d.ts

@@ -0,0 +1,9 @@
+import { ManifestDownloadFormat } from "../../apis/azul/common/entities";
+import { Filters } from "../../common/entities";
+/**
+ * Initializes and fetches file manifest comprising file facets and summary for the given file manifest format.
+ * @param fileManifestFormat - File manifest format.
+ * @param initialFilters - Filters to initialize file manifest request.
+ * @param fileSummaryFacetName - File summary facet name.
+ */
+export declare const useRequestFileManifest: (fileManifestFormat: ManifestDownloadFormat | undefined, initialFilters?: Filters | undefined, fileSummaryFacetName?: string | undefined) => void;

package/lib/hooks/useFileManifest/useRequestFileManifest.js

@@ -0,0 +1,41 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useRequestFileManifest = void 0;
+const react_1 = require("react");
+const fileManifestState_1 = require("../../providers/fileManifestState");
+const useFileManifestState_1 = require("../useFileManifestState");
+/**
+ * Initializes and fetches file manifest comprising file facets and summary for the given file manifest format.
+ * @param fileManifestFormat - File manifest format.
+ * @param initialFilters - Filters to initialize file manifest request.
+ * @param fileSummaryFacetName - File summary facet name.
+ */
+const useRequestFileManifest = (fileManifestFormat, initialFilters = [], fileSummaryFacetName) => {
+    // Initial file manifest filter.
+    const [initFilters] = (0, react_1.useState)(() => initialFilters);
+    // File manifest state.
+    const { fileManifestDispatch } = (0, useFileManifestState_1.useFileManifestState)();
+    // Fetches file manifest with the given file manifest filters, format.
+    (0, react_1.useEffect)(() => {
+        fileManifestDispatch({
+            payload: {
+                fileManifestFormat,
+                fileSummaryFacetName,
+                filters: initFilters,
+            },
+            type: fileManifestState_1.FileManifestActionKind.FetchFileManifest,
+        });
+        return () => {
+            fileManifestDispatch({
+                payload: undefined,
+                type: fileManifestState_1.FileManifestActionKind.ClearFileManifest,
+            });
+        };
+    }, [
+        fileManifestDispatch,
+        fileManifestFormat,
+        fileSummaryFacetName,
+        initFilters,
+    ]);
+};
+exports.useRequestFileManifest = useRequestFileManifest;

package/lib/hooks/useFileManifestState.d.ts

@@ -0,0 +1,6 @@
+import { FileManifestStateContextProps } from "../providers/fileManifestState";
+/**
+ * Returns file manifest state context.
+ * @returns file manifest  state context.
+ */
+export declare const useFileManifestState: () => FileManifestStateContextProps;

package/lib/hooks/useFileManifestState.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useFileManifestState = void 0;
+const react_1 = require("react");
+const fileManifestState_1 = require("../providers/fileManifestState");
+/**
+ * Returns file manifest state context.
+ * @returns file manifest  state context.
+ */
+const useFileManifestState = () => {
+    return (0, react_1.useContext)(fileManifestState_1.FileManifestStateContext);
+};
+exports.useFileManifestState = useFileManifestState;

package/lib/hooks/useLayoutState.d.ts

@@ -0,0 +1,6 @@
+import { LayoutStateContextProps } from "../providers/layoutState";
+/**
+ * Returns layout state context.
+ * @returns layout state context.
+ */
+export declare const useLayoutState: () => LayoutStateContextProps;

package/lib/hooks/useLayoutState.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useLayoutState = void 0;
+const react_1 = require("react");
+const layoutState_1 = require("../providers/layoutState");
+/**
+ * Returns layout state context.
+ * @returns layout state context.
+ */
+const useLayoutState = () => {
+    return (0, react_1.useContext)(layoutState_1.LayoutStateContext);
+};
+exports.useLayoutState = useLayoutState;

package/lib/hooks/useLocalStorage/common/utils.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Return the value for the specified key.
+ * @param key - Key.
+ * @returns value.
+ */
+export declare function getLocalStorage(key: string): string | null;
+/**
+ * Set the value for the specified key.
+ * @param key - Key.
+ * @param value - Value.
+ */
+export declare function setLocalStorage(key: string, value: string): void;

package/lib/hooks/useLocalStorage/common/utils.js

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.setLocalStorage = exports.getLocalStorage = void 0;
+/**
+ * Return the value for the specified key.
+ * @param key - Key.
+ * @returns value.
+ */
+function getLocalStorage(key) {
+    var _a, _b;
+    if (typeof window === "undefined")
+        return null;
+    return (_b = (_a = window === null || window === void 0 ? void 0 : window.localStorage) === null || _a === void 0 ? void 0 : _a.getItem(key)) !== null && _b !== void 0 ? _b : null;
+}
+exports.getLocalStorage = getLocalStorage;
+/**
+ * Set the value for the specified key.
+ * @param key - Key.
+ * @param value - Value.
+ */
+function setLocalStorage(key, value) {
+    var _a;
+    if (typeof window === "undefined")
+        return;
+    (_a = window === null || window === void 0 ? void 0 : window.localStorage) === null || _a === void 0 ? void 0 : _a.setItem(key, value);
+}
+exports.setLocalStorage = setLocalStorage;

package/lib/hooks/useLocalStorage/useLocalStorage.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Determine local storage value.
+ * @param key - Local storage key.
+ * @returns local storage value.
+ */
+export declare function useLocalStorage(key: string): string | null;

package/lib/hooks/useLocalStorage/useLocalStorage.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useLocalStorage = void 0;
+const react_1 = require("react");
+const utils_1 = require("./common/utils");
+/**
+ * Determine local storage value.
+ * @param key - Local storage key.
+ * @returns local storage value.
+ */
+function useLocalStorage(key) {
+    const [value, setValue] = (0, react_1.useState)(null);
+    (0, react_1.useEffect)(() => {
+        setValue((0, utils_1.getLocalStorage)(key));
+    }, [key]);
+    return value;
+}
+exports.useLocalStorage = useLocalStorage;

package/lib/hooks/useLocation.d.ts

@@ -0,0 +1,13 @@
+interface Result {
+    href: string;
+    pathname: string;
+    search: URLSearchParams;
+}
+/**
+ * Hook used to get the url properties from the location object
+ * Most of the time you can get the same result with useRouter(). This hook has a single use case:
+ *  - When you need to get the url properties ready on the first render, before ReactDOM.hydrate
+ * @returns an object containing url's pathname and search params
+ */
+export declare const useLocation: () => Result | null;
+export {};

package/lib/hooks/useLocation.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useLocation = void 0;
+const ssr_1 = require("../utils/ssr");
+/**
+ * Hook used to get the url properties from the location object
+ * Most of the time you can get the same result with useRouter(). This hook has a single use case:
+ *  - When you need to get the url properties ready on the first render, before ReactDOM.hydrate
+ * @returns an object containing url's pathname and search params
+ */
+const useLocation = () => {
+    if ((0, ssr_1.isSSR)()) {
+        return null;
+    }
+    const { href, pathname, search } = window.location;
+    return {
+        href,
+        pathname,
+        search: new URLSearchParams(search),
+    };
+};
+exports.useLocation = useLocation;

package/lib/hooks/useRequestFileLocation.d.ts

@@ -0,0 +1,35 @@
+export interface FileLocation {
+    commandLine?: {
+        [key: string]: string;
+    };
+    location: string;
+    retryAfter?: number;
+    status: number;
+}
+export interface UseRequestFileLocationResult {
+    data: FileLocation | undefined;
+    isIdle: boolean;
+    isLoading: boolean;
+    isSuccess: boolean;
+    run: () => void;
+}
+export declare type Method = METHOD;
+export declare enum METHOD {
+    GET = "GET",
+    PUT = "PUT"
+}
+/**
+ * Function to make a get request and map the result to camelCase
+ * @param url - url for the get request
+ * @param accessToken - Access token.
+ * @param method - Method to be used by the request
+ * @returns @see FileLocation
+ */
+export declare const getFileLocation: (url: string, accessToken: string | undefined, method: Method) => Promise<FileLocation>;
+/**
+ * Hook to get a file location using a retry-after approach
+ * @param url - to be used on the get request
+ * @param method - Method to be used by the request
+ * @returns data object with the file location
+ */
+export declare const useRequestFileLocation: (url?: string | undefined, method?: METHOD | undefined) => UseRequestFileLocationResult;

package/lib/hooks/useRequestFileLocation.js

@@ -0,0 +1,111 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useRequestFileLocation = exports.getFileLocation = exports.METHOD = void 0;
+const react_1 = require("react");
+const constants_1 = require("../apis/azul/common/constants");
+const useAsync_1 = require("./useAsync");
+const useAuthentication_1 = require("./useAuthentication/useAuthentication");
+var METHOD;
+(function (METHOD) {
+    METHOD["GET"] = "GET";
+    METHOD["PUT"] = "PUT";
+})(METHOD = exports.METHOD || (exports.METHOD = {}));
+/**
+ * Returns fetch request options.
+ * @param accessToken - Access token.
+ * @param method - Method to be used by the request
+ * @returns fetch request options.
+ */
+function createFetchOptions(accessToken, method) {
+    return {
+        headers: accessToken ? { Authorization: "Bearer " + accessToken } : {},
+        method,
+    };
+}
+/**
+ * Function to make a get request and map the result to camelCase
+ * @param url - url for the get request
+ * @param accessToken - Access token.
+ * @param method - Method to be used by the request
+ * @returns @see FileLocation
+ */
+const getFileLocation = (url, accessToken, method) => __awaiter(void 0, void 0, void 0, function* () {
+    const options = createFetchOptions(accessToken, method);
+    const res = yield fetch(url, options);
+    const jsonRes = yield res.json();
+    return {
+        commandLine: jsonRes.CommandLine,
+        location: jsonRes.Location,
+        retryAfter: jsonRes["Retry-After"],
+        status: jsonRes.Status,
+    };
+});
+exports.getFileLocation = getFileLocation;
+/**
+ * Function that will recursively keep making requests to get the file location until gets a 302 or an error.
+ * @param url - url for the get request
+ * @param accessToken - Access token.
+ * @param resolve - function to resolve the running promise
+ * @param reject - function to reject the running promise
+ * @param active - Mutable object used to check if the page is still mounted and the requests should keep executing
+ * @param retryAfter - timeout value
+ * @param method - Method to be used by the request
+ */
+const scheduleFileLocation = (url, accessToken, resolve, reject, active, retryAfter = 0, method = METHOD.GET) => {
+    setTimeout(() => {
+        (0, exports.getFileLocation)(url, accessToken, method).then((result) => {
+            if (result.status === constants_1.FILE_LOCATION_PENDING) {
+                if (!active.current) {
+                    reject({
+                        location: "",
+                        status: 499, //Client Closed Request
+                    });
+                    return;
+                }
+                scheduleFileLocation(result.location, accessToken, resolve, reject, active, result.retryAfter);
+            }
+            else if (result.status === constants_1.FILE_LOCATION_SUCCESSFULLY) {
+                resolve(result);
+            }
+            else {
+                reject(result);
+            }
+        });
+    }, retryAfter * 1000);
+};
+/**
+ * Hook to get a file location using a retry-after approach
+ * @param url - to be used on the get request
+ * @param method - Method to be used by the request
+ * @returns data object with the file location
+ */
+const useRequestFileLocation = (url, method) => {
+    // Grab token from authentication.
+    const { token } = (0, useAuthentication_1.useAuthentication)();
+    const { data, isIdle, isLoading, isSuccess, run: runAsync, } = (0, useAsync_1.useAsync)();
+    const active = (0, react_1.useRef)(true);
+    (0, react_1.useEffect)(() => {
+        active.current = true;
+        return () => {
+            active.current = false;
+        };
+    }, []);
+    const run = (0, react_1.useCallback)(() => {
+        if (url) {
+            runAsync(new Promise((resolve, reject) => {
+                scheduleFileLocation(url, token, resolve, reject, active, 0, method);
+            }));
+        }
+    }, [runAsync, token, url, method]);
+    return { data, isIdle, isLoading, isSuccess, run };
+};
+exports.useRequestFileLocation = useRequestFileLocation;

package/lib/hooks/useResetableState.d.ts

@@ -0,0 +1,7 @@
+import { Dispatch, SetStateAction } from "react";
+/**
+ * useState hook wrapper that will keep the state updated if the defaultValue changes
+ * @param defaultState - param that determine the default and current state
+ * @returns current state the setter function
+ */
+export declare const useResetableState: <T>(defaultState: T) => [T, Dispatch<SetStateAction<T>>];

package/lib/hooks/useResetableState.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useResetableState = void 0;
+const react_1 = require("react");
+/**
+ * useState hook wrapper that will keep the state updated if the defaultValue changes
+ * @param defaultState - param that determine the default and current state
+ * @returns current state the setter function
+ */
+const useResetableState = (defaultState) => {
+    const [state, setState] = (0, react_1.useState)(defaultState);
+    (0, react_1.useEffect)(() => {
+        setState(defaultState);
+    }, [defaultState]);
+    return [state, setState];
+};
+exports.useResetableState = useResetableState;

package/lib/hooks/useResizeObserver.d.ts

@@ -0,0 +1,43 @@
+import { RefObject } from "react";
+export declare type ElementRect = {
+    bottom: number;
+    height: number;
+    left: number;
+    right: number;
+    top: number;
+    width: number;
+    x: number;
+    y: number;
+};
+/**
+ * Element resizing and repositioning observer.
+ * @param ref - element to be observed for changes to its size or position.
+ * @param onResizeFn - action to be performed when the observed element is resized or repositioned.
+ * @returns Element size and position properties for the given element.
+ */
+export declare function useResizeObserver(ref: RefObject<HTMLElement>, onResizeFn: (entries: ResizeObserverEntry[]) => Partial<ElementRect>): Partial<ElementRect> | undefined;
+/**
+ * Return's the observed element's border box size.
+ * @param entries - Resize observer entries.
+ * @returns observed element's border box size.
+ */
+export declare function getBorderBoxSize(entries: ResizeObserverEntry[]): Partial<ElementRect>;
+/**
+ * Return's the observed element's border box height.
+ * @param entries - Resize observer entries.
+ * @returns observed element's border box height.
+ */
+export declare function getBorderBoxSizeHeight(entries: ResizeObserverEntry[]): Partial<ElementRect>;
+/**
+ * Return's the observed element's size and position properties.
+ * @param entries - Resize observer entries.
+ * @returns the observed element's size and position properties.
+ */
+export declare function getContentRect(entries: ResizeObserverEntry[]): ElementRect;
+/**
+ * Return's the next observed element's size and position properties.
+ * @param elementRect - Current observed element's rect properties.
+ * @param nextElementRect - Next observed element's rect properties.
+ * @returns the next observed element's size and position properties.
+ */
+export declare function getNextElementRect(elementRect: Partial<ElementRect> | undefined, nextElementRect: Partial<ElementRect> | undefined): Partial<ElementRect> | undefined;