@itwin/core-react 4.0.0-dev.12 → 4.0.0-dev.14

package/lib/esm/core-react/utils/hooks/useEffectSkipFirst.d.ts

@@ -1,9 +1,9 @@
-/** @packageDocumentation
- * @module Utilities
- */
-/**
- * Custom hook which works like useEffect hook, but does not invoke callback when effect is triggered for the first time.
- * @public
- */
-export declare function useEffectSkipFirst(callback: () => (void | (() => void | undefined)) | void, deps?: any[]): void;
+/** @packageDocumentation
+ * @module Utilities
+ */
+/**
+ * Custom hook which works like useEffect hook, but does not invoke callback when effect is triggered for the first time.
+ * @public
+ */
+export declare function useEffectSkipFirst(callback: () => (void | (() => void | undefined)) | void, deps?: any[]): void;
 //# sourceMappingURL=useEffectSkipFirst.d.ts.map

package/lib/esm/core-react/utils/hooks/useEffectSkipFirst.js

@@ -1,23 +1,23 @@
-/*---------------------------------------------------------------------------------------------
-* Copyright (c) Bentley Systems, Incorporated. All rights reserved.
-* See LICENSE.md in the project root for license terms and full copyright notice.
-*--------------------------------------------------------------------------------------------*/
-/** @packageDocumentation
- * @module Utilities
- */
-import { useEffect, useRef } from "react";
-/**
- * Custom hook which works like useEffect hook, but does not invoke callback when effect is triggered for the first time.
- * @public
- */
-export function useEffectSkipFirst(callback, deps) {
-    const skipFirst = useRef(true);
-    useEffect(() => {
-        if (skipFirst.current) {
-            skipFirst.current = false;
-            return;
-        }
-        return callback();
-    }, deps); // eslint-disable-line react-hooks/exhaustive-deps
-}
+/*---------------------------------------------------------------------------------------------
+* Copyright (c) Bentley Systems, Incorporated. All rights reserved.
+* See LICENSE.md in the project root for license terms and full copyright notice.
+*--------------------------------------------------------------------------------------------*/
+/** @packageDocumentation
+ * @module Utilities
+ */
+import { useEffect, useRef } from "react";
+/**
+ * Custom hook which works like useEffect hook, but does not invoke callback when effect is triggered for the first time.
+ * @public
+ */
+export function useEffectSkipFirst(callback, deps) {
+    const skipFirst = useRef(true);
+    useEffect(() => {
+        if (skipFirst.current) {
+            skipFirst.current = false;
+            return;
+        }
+        return callback();
+    }, deps); // eslint-disable-line react-hooks/exhaustive-deps
+}
 //# sourceMappingURL=useEffectSkipFirst.js.map

package/lib/esm/core-react/utils/hooks/useEventListener.d.ts

@@ -1,12 +1,12 @@
-/**
- * Hook that adds and removes Event listeners.
- * @example
- *  useEventListener(
- *     'pointerup',
- *     handlePointerUp,
- *     containerRef.current?.ownerDocument,
- *  );
- * @internal
- */
-export declare function useEventListener(eventName: string, handler: (event: Event) => void, element: HTMLElement | Document | undefined): void;
+/**
+ * Hook that adds and removes Event listeners.
+ * @example
+ *  useEventListener(
+ *     'pointerup',
+ *     handlePointerUp,
+ *     containerRef.current?.ownerDocument,
+ *  );
+ * @internal
+ */
+export declare function useEventListener(eventName: string, handler: (event: Event) => void, element: HTMLElement | Document | undefined): void;
 //# sourceMappingURL=useEventListener.d.ts.map

package/lib/esm/core-react/utils/hooks/useEventListener.js

@@ -1,40 +1,40 @@
-/*---------------------------------------------------------------------------------------------
-* Copyright (c) Bentley Systems, Incorporated. All rights reserved.
-* See LICENSE.md in the project root for license terms and full copyright notice.
-*--------------------------------------------------------------------------------------------*/
-import * as React from "react";
-/**
- * Hook that adds and removes Event listeners.
- * @example
- *  useEventListener(
- *     'pointerup',
- *     handlePointerUp,
- *     containerRef.current?.ownerDocument,
- *  );
- * @internal
- */
-export function useEventListener(eventName, handler, element) {
-    // Based on published hook https://usehooks.com/useEventListener/.
-    const savedHandler = React.useRef();
-    // Update reference if handler changes. This allows our effect below to
-    // always use latest handler without us needing to pass it in effect deps array
-    // and potentially cause effect to re-run every render.
-    React.useEffect(() => {
-        savedHandler.current = handler;
-    }, [handler]);
-    React.useEffect(() => {
-        if (!element) {
-            return;
-        }
-        const eventListener = (event) => {
-            // istanbul ignore else
-            if (savedHandler.current)
-                savedHandler.current(event);
-        };
-        element.addEventListener(eventName, eventListener);
-        return () => {
-            element.removeEventListener(eventName, eventListener);
-        };
-    }, [eventName, element]);
-}
+/*---------------------------------------------------------------------------------------------
+* Copyright (c) Bentley Systems, Incorporated. All rights reserved.
+* See LICENSE.md in the project root for license terms and full copyright notice.
+*--------------------------------------------------------------------------------------------*/
+import * as React from "react";
+/**
+ * Hook that adds and removes Event listeners.
+ * @example
+ *  useEventListener(
+ *     'pointerup',
+ *     handlePointerUp,
+ *     containerRef.current?.ownerDocument,
+ *  );
+ * @internal
+ */
+export function useEventListener(eventName, handler, element) {
+    // Based on published hook https://usehooks.com/useEventListener/.
+    const savedHandler = React.useRef();
+    // Update reference if handler changes. This allows our effect below to
+    // always use latest handler without us needing to pass it in effect deps array
+    // and potentially cause effect to re-run every render.
+    React.useEffect(() => {
+        savedHandler.current = handler;
+    }, [handler]);
+    React.useEffect(() => {
+        if (!element) {
+            return;
+        }
+        const eventListener = (event) => {
+            // istanbul ignore else
+            if (savedHandler.current)
+                savedHandler.current(event);
+        };
+        element.addEventListener(eventName, eventListener);
+        return () => {
+            element.removeEventListener(eventName, eventListener);
+        };
+    }, [eventName, element]);
+}
 //# sourceMappingURL=useEventListener.js.map

package/lib/esm/core-react/utils/hooks/useInterval.d.ts

@@ -1,6 +1,6 @@
-/** Hook that create an interval and clears it when unloaded
- * Reference: https://github.com/gaearon/overreacted.io/blob/master/src/pages/making-setinterval-declarative-with-react-hooks/index.md
- * @beta
- */
-export declare function useInterval(callback: (...args: any[]) => void, delay: number | undefined): void;
+/** Hook that create an interval and clears it when unloaded
+ * Reference: https://github.com/gaearon/overreacted.io/blob/master/src/pages/making-setinterval-declarative-with-react-hooks/index.md
+ * @beta
+ */
+export declare function useInterval(callback: (...args: any[]) => void, delay: number | undefined): void;
 //# sourceMappingURL=useInterval.d.ts.map

package/lib/esm/core-react/utils/hooks/useInterval.js

@@ -1,33 +1,33 @@
-/*---------------------------------------------------------------------------------------------
-* Copyright (c) Bentley Systems, Incorporated. All rights reserved.
-* See LICENSE.md in the project root for license terms and full copyright notice.
-*--------------------------------------------------------------------------------------------*/
-/** @packageDocumentation
- * @module Utilities
- */
-import * as React from "react";
-/** Hook that create an interval and clears it when unloaded
- * Reference: https://github.com/gaearon/overreacted.io/blob/master/src/pages/making-setinterval-declarative-with-react-hooks/index.md
- * @beta
- */
-export function useInterval(callback, delay) {
-    const savedCallback = React.useRef(callback);
-    // Remember the latest function.
-    React.useEffect(() => {
-        savedCallback.current = callback;
-    }, [callback]);
-    // Set up the interval.
-    React.useEffect(() => {
-        function tick() {
-            savedCallback.current();
-        }
-        if (delay !== undefined) {
-            const id = setInterval(tick, delay);
-            return (() => { clearInterval(id); });
-        }
-        else {
-            return undefined;
-        }
-    }, [delay]);
-}
+/*---------------------------------------------------------------------------------------------
+* Copyright (c) Bentley Systems, Incorporated. All rights reserved.
+* See LICENSE.md in the project root for license terms and full copyright notice.
+*--------------------------------------------------------------------------------------------*/
+/** @packageDocumentation
+ * @module Utilities
+ */
+import * as React from "react";
+/** Hook that create an interval and clears it when unloaded
+ * Reference: https://github.com/gaearon/overreacted.io/blob/master/src/pages/making-setinterval-declarative-with-react-hooks/index.md
+ * @beta
+ */
+export function useInterval(callback, delay) {
+    const savedCallback = React.useRef(callback);
+    // Remember the latest function.
+    React.useEffect(() => {
+        savedCallback.current = callback;
+    }, [callback]);
+    // Set up the interval.
+    React.useEffect(() => {
+        function tick() {
+            savedCallback.current();
+        }
+        if (delay !== undefined) {
+            const id = setInterval(tick, delay);
+            return (() => { clearInterval(id); });
+        }
+        else {
+            return undefined;
+        }
+    }, [delay]);
+}
 //# sourceMappingURL=useInterval.js.map

package/lib/esm/core-react/utils/hooks/useLifecycleLogging.d.ts

@@ -1,6 +1,6 @@
-/**
- * Logs to console information about component lifecycle: mounting, re-rendering and unmounting.
- * @internal
- */
-export declare function useLifecycleLogging(name: string, props: Record<string, any>, context?: Record<string, any>): void;
+/**
+ * Logs to console information about component lifecycle: mounting, re-rendering and unmounting.
+ * @internal
+ */
+export declare function useLifecycleLogging(name: string, props: Record<string, any>, context?: Record<string, any>): void;
 //# sourceMappingURL=useLifecycleLogging.d.ts.map

package/lib/esm/core-react/utils/hooks/useLifecycleLogging.js

@@ -1,61 +1,61 @@
-/*---------------------------------------------------------------------------------------------
-* Copyright (c) Bentley Systems, Incorporated. All rights reserved.
-* See LICENSE.md in the project root for license terms and full copyright notice.
-*--------------------------------------------------------------------------------------------*/
-import { useEffect, useRef } from "react";
-/**
- * Logs to console information about component lifecycle: mounting, re-rendering and unmounting.
- * @internal
- */
-export function useLifecycleLogging(name, props, context) {
-    useEffect(() => {
-        // eslint-disable-next-line no-console
-        console.log(`[useLifecycleLogging]: '${name}' Component mounted.`);
-        return () => {
-            // eslint-disable-next-line no-console
-            console.log(`[useLifecycleLogging]: '${name}' Component unmounted.`);
-        };
-    }, []); // eslint-disable-line react-hooks/exhaustive-deps
-    const prevProps = useRef(props);
-    const prevContext = useRef(context);
-    const firstRun = useRef(true);
-    useEffect(() => {
-        if (firstRun.current) {
-            firstRun.current = false;
-            return;
-        }
-        function getDiff(prev, current) {
-            const diff = {};
-            for (const key of Object.keys(current)) {
-                if (prev[key] !== current[key]) {
-                    diff[key] = {
-                        from: prev[key],
-                        to: current[key],
-                    };
-                }
-            }
-            return diff;
-        }
-        const propsDiff = getDiff(prevProps.current, props);
-        const contextDiff = { from: context === undefined ? context : prevContext.current, to: context };
-        if (Object.keys(propsDiff).length > 0 && prevContext.current !== context) {
-            // eslint-disable-next-line no-console
-            console.log(`[useLifecycleLogging]: '${name}' Props and context changed: `, propsDiff, contextDiff);
-        }
-        else if (Object.keys(propsDiff).length > 0) {
-            // eslint-disable-next-line no-console
-            console.log(`[useLifecycleLogging]: '${name}' Props changed: `, propsDiff);
-        }
-        else if (prevContext.current !== context) {
-            // eslint-disable-next-line no-console
-            console.log(`[useLifecycleLogging]: '${name}' Context changed: `, contextDiff);
-        }
-        else {
-            // eslint-disable-next-line no-console
-            console.log(`[useLifecycleLogging]: '${name}' Component re-rendered.`);
-        }
-        prevProps.current = props;
-        prevContext.current = context;
-    });
-}
+/*---------------------------------------------------------------------------------------------
+* Copyright (c) Bentley Systems, Incorporated. All rights reserved.
+* See LICENSE.md in the project root for license terms and full copyright notice.
+*--------------------------------------------------------------------------------------------*/
+import { useEffect, useRef } from "react";
+/**
+ * Logs to console information about component lifecycle: mounting, re-rendering and unmounting.
+ * @internal
+ */
+export function useLifecycleLogging(name, props, context) {
+    useEffect(() => {
+        // eslint-disable-next-line no-console
+        console.log(`[useLifecycleLogging]: '${name}' Component mounted.`);
+        return () => {
+            // eslint-disable-next-line no-console
+            console.log(`[useLifecycleLogging]: '${name}' Component unmounted.`);
+        };
+    }, []); // eslint-disable-line react-hooks/exhaustive-deps
+    const prevProps = useRef(props);
+    const prevContext = useRef(context);
+    const firstRun = useRef(true);
+    useEffect(() => {
+        if (firstRun.current) {
+            firstRun.current = false;
+            return;
+        }
+        function getDiff(prev, current) {
+            const diff = {};
+            for (const key of Object.keys(current)) {
+                if (prev[key] !== current[key]) {
+                    diff[key] = {
+                        from: prev[key],
+                        to: current[key],
+                    };
+                }
+            }
+            return diff;
+        }
+        const propsDiff = getDiff(prevProps.current, props);
+        const contextDiff = { from: context === undefined ? context : prevContext.current, to: context };
+        if (Object.keys(propsDiff).length > 0 && prevContext.current !== context) {
+            // eslint-disable-next-line no-console
+            console.log(`[useLifecycleLogging]: '${name}' Props and context changed: `, propsDiff, contextDiff);
+        }
+        else if (Object.keys(propsDiff).length > 0) {
+            // eslint-disable-next-line no-console
+            console.log(`[useLifecycleLogging]: '${name}' Props changed: `, propsDiff);
+        }
+        else if (prevContext.current !== context) {
+            // eslint-disable-next-line no-console
+            console.log(`[useLifecycleLogging]: '${name}' Context changed: `, contextDiff);
+        }
+        else {
+            // eslint-disable-next-line no-console
+            console.log(`[useLifecycleLogging]: '${name}' Component re-rendered.`);
+        }
+        prevProps.current = props;
+        prevContext.current = context;
+    });
+}
 //# sourceMappingURL=useLifecycleLogging.js.map

package/lib/esm/core-react/utils/hooks/useOnOutsideClick.d.ts

@@ -1,13 +1,13 @@
-/** @packageDocumentation
- * @module Utilities
- */
-import * as React from "react";
-/** @public */
-export declare type OutsideClickEvent = PointerEvent | MouseEvent | TouchEvent;
-/** Invokes onOutsideClick handler when user clicks outside of referenced element.
- * @public
- */
-export declare function useOnOutsideClick<T extends Element>(onOutsideClick?: () => void, 
-/** Invoked for intermediate events. Return `false` to prevent outside click. */
-outsideEventPredicate?: (e: OutsideClickEvent) => boolean): React.RefObject<T>;
+/** @packageDocumentation
+ * @module Utilities
+ */
+import * as React from "react";
+/** @public */
+export type OutsideClickEvent = PointerEvent | MouseEvent | TouchEvent;
+/** Invokes onOutsideClick handler when user clicks outside of referenced element.
+ * @public
+ */
+export declare function useOnOutsideClick<T extends Element>(onOutsideClick?: () => void, 
+/** Invoked for intermediate events. Return `false` to prevent outside click. */
+outsideEventPredicate?: (e: OutsideClickEvent) => boolean): React.RefObject<T>;
 //# sourceMappingURL=useOnOutsideClick.d.ts.map

package/lib/esm/core-react/utils/hooks/useOnOutsideClick.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useOnOutsideClick.d.ts","sourceRoot":"","sources":["../../../../../src/core-react/utils/hooks/useOnOutsideClick.tsx"],"names":[],"mappings":"AAIA;;GAEG;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAI/B,cAAc;AACd,oBAAY,iBAAiB,GAAG,YAAY,GAAG,UAAU,GAAG,UAAU,CAAC;AAEvE;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,SAAS,OAAO,EACjD,cAAc,CAAC,EAAE,MAAM,IAAI;AAC3B,gFAAgF;AAChF,qBAAqB,CAAC,EAAE,CAAC,CAAC,EAAE,iBAAiB,KAAK,OAAO,sBAoE1D"}
+{"version":3,"file":"useOnOutsideClick.d.ts","sourceRoot":"","sources":["../../../../../src/core-react/utils/hooks/useOnOutsideClick.tsx"],"names":[],"mappings":"AAIA;;GAEG;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAI/B,cAAc;AACd,MAAM,MAAM,iBAAiB,GAAG,YAAY,GAAG,UAAU,GAAG,UAAU,CAAC;AAEvE;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,SAAS,OAAO,EACjD,cAAc,CAAC,EAAE,MAAM,IAAI;AAC3B,gFAAgF;AAChF,qBAAqB,CAAC,EAAE,CAAC,CAAC,EAAE,iBAAiB,KAAK,OAAO,sBAoE1D"}

package/lib/esm/core-react/utils/hooks/useOnOutsideClick.js

@@ -1,89 +1,89 @@
-/*---------------------------------------------------------------------------------------------
-* Copyright (c) Bentley Systems, Incorporated. All rights reserved.
-* See LICENSE.md in the project root for license terms and full copyright notice.
-*--------------------------------------------------------------------------------------------*/
-/** @packageDocumentation
- * @module Utilities
- */
-import * as React from "react";
-import { hasPointerEventsSupport } from "../../base/PointerEvents";
-import { Timer } from "../Timer";
-/** Invokes onOutsideClick handler when user clicks outside of referenced element.
- * @public
- */
-export function useOnOutsideClick(onOutsideClick, 
-/** Invoked for intermediate events. Return `false` to prevent outside click. */
-outsideEventPredicate) {
-    const handleMouseEvents = React.useRef(true);
-    const handleMouseEventsTimer = React.useRef(new Timer(1000));
-    const ref = React.useRef(null);
-    const isDownOutside = React.useRef(false);
-    React.useEffect(() => {
-        const listener = (e) => {
-            if (e.type === "touchstart") {
-                // Skip mouse event handlers after touch event.
-                handleMouseEvents.current = false;
-                handleMouseEventsTimer.current.start();
-            }
-            else if (e.type === "mousedown" && !handleMouseEvents.current) {
-                return;
-            }
-            const isOutsideEvent = !outsideEventPredicate || outsideEventPredicate(e);
-            isDownOutside.current = (!!ref.current && (e.target instanceof Node) && !ref.current.contains(e.target)) && isOutsideEvent;
-        };
-        if (hasPointerEventsSupport()) {
-            document.addEventListener("pointerdown", listener);
-        }
-        else {
-            document.addEventListener("mousedown", listener);
-            document.addEventListener("touchstart", listener);
-        }
-        return () => {
-            if (hasPointerEventsSupport()) {
-                document.removeEventListener("pointerdown", listener);
-            }
-            else {
-                document.removeEventListener("mousedown", listener);
-                document.removeEventListener("touchstart", listener);
-            }
-        };
-    }, [outsideEventPredicate]);
-    React.useEffect(() => {
-        const listener = (e) => {
-            if (e.type === "mouseup" && !handleMouseEvents.current) {
-                return;
-            }
-            onOutsideClick && isDownOutside.current && (!outsideEventPredicate || outsideEventPredicate(e)) &&
-                ref.current && e.target instanceof Node && !ref.current.contains(e.target) && onOutsideClick();
-            isDownOutside.current = false;
-        };
-        if (hasPointerEventsSupport()) {
-            document.addEventListener("pointerup", listener);
-        }
-        else {
-            document.addEventListener("mouseup", listener);
-            document.addEventListener("touchend", listener);
-        }
-        return () => {
-            if (hasPointerEventsSupport()) {
-                document.removeEventListener("pointerup", listener);
-            }
-            else {
-                document.removeEventListener("mouseup", listener);
-                document.removeEventListener("touchend", listener);
-            }
-        };
-    }, [onOutsideClick, outsideEventPredicate]);
-    React.useEffect(() => {
-        const listener = () => {
-            handleMouseEvents.current = true;
-        };
-        const timer = handleMouseEventsTimer.current;
-        timer.setOnExecute(listener);
-        return () => {
-            timer.setOnExecute(undefined);
-        };
-    }, []);
-    return ref;
-}
+/*---------------------------------------------------------------------------------------------
+* Copyright (c) Bentley Systems, Incorporated. All rights reserved.
+* See LICENSE.md in the project root for license terms and full copyright notice.
+*--------------------------------------------------------------------------------------------*/
+/** @packageDocumentation
+ * @module Utilities
+ */
+import * as React from "react";
+import { hasPointerEventsSupport } from "../../base/PointerEvents";
+import { Timer } from "../Timer";
+/** Invokes onOutsideClick handler when user clicks outside of referenced element.
+ * @public
+ */
+export function useOnOutsideClick(onOutsideClick, 
+/** Invoked for intermediate events. Return `false` to prevent outside click. */
+outsideEventPredicate) {
+    const handleMouseEvents = React.useRef(true);
+    const handleMouseEventsTimer = React.useRef(new Timer(1000));
+    const ref = React.useRef(null);
+    const isDownOutside = React.useRef(false);
+    React.useEffect(() => {
+        const listener = (e) => {
+            if (e.type === "touchstart") {
+                // Skip mouse event handlers after touch event.
+                handleMouseEvents.current = false;
+                handleMouseEventsTimer.current.start();
+            }
+            else if (e.type === "mousedown" && !handleMouseEvents.current) {
+                return;
+            }
+            const isOutsideEvent = !outsideEventPredicate || outsideEventPredicate(e);
+            isDownOutside.current = (!!ref.current && (e.target instanceof Node) && !ref.current.contains(e.target)) && isOutsideEvent;
+        };
+        if (hasPointerEventsSupport()) {
+            document.addEventListener("pointerdown", listener);
+        }
+        else {
+            document.addEventListener("mousedown", listener);
+            document.addEventListener("touchstart", listener);
+        }
+        return () => {
+            if (hasPointerEventsSupport()) {
+                document.removeEventListener("pointerdown", listener);
+            }
+            else {
+                document.removeEventListener("mousedown", listener);
+                document.removeEventListener("touchstart", listener);
+            }
+        };
+    }, [outsideEventPredicate]);
+    React.useEffect(() => {
+        const listener = (e) => {
+            if (e.type === "mouseup" && !handleMouseEvents.current) {
+                return;
+            }
+            onOutsideClick && isDownOutside.current && (!outsideEventPredicate || outsideEventPredicate(e)) &&
+                ref.current && e.target instanceof Node && !ref.current.contains(e.target) && onOutsideClick();
+            isDownOutside.current = false;
+        };
+        if (hasPointerEventsSupport()) {
+            document.addEventListener("pointerup", listener);
+        }
+        else {
+            document.addEventListener("mouseup", listener);
+            document.addEventListener("touchend", listener);
+        }
+        return () => {
+            if (hasPointerEventsSupport()) {
+                document.removeEventListener("pointerup", listener);
+            }
+            else {
+                document.removeEventListener("mouseup", listener);
+                document.removeEventListener("touchend", listener);
+            }
+        };
+    }, [onOutsideClick, outsideEventPredicate]);
+    React.useEffect(() => {
+        const listener = () => {
+            handleMouseEvents.current = true;
+        };
+        const timer = handleMouseEventsTimer.current;
+        timer.setOnExecute(listener);
+        return () => {
+            timer.setOnExecute(undefined);
+        };
+    }, []);
+    return ref;
+}
 //# sourceMappingURL=useOnOutsideClick.js.map