@itwin/itwinui-react 3.0.0-dev.1 → 3.0.0-dev.11

package/esm/core/Modal/Modal.js

@@ -3,9 +3,7 @@
  * See LICENSE.md in the project root for license terms and full copyright notice.
  *--------------------------------------------------------------------------------------------*/
 import * as React from 'react';
-import ReactDOM from 'react-dom';
-import { getContainer, getDocument } from '../utils/index.js';
-import { Dialog } from '../Dialog/index.js';
+import { Dialog } from '../Dialog/Dialog.js';
 /**
  * Modal component which can wrap any content.
  * @example
@@ -28,16 +26,38 @@ import { Dialog } from '../Dialog/index.js';
  * </Modal>
  */
 export const Modal = React.forwardRef((props, forwardedRef) => {
-    const { isOpen = false, isDismissible = true, closeOnEsc = true, closeOnExternalClick = true, onClose, title, children, modalRootId = 'iui-react-portal-container', ownerDocument = getDocument(), ...rest } = props;
-    const [container, setContainer] = React.useState();
-    React.useEffect(() => {
-        setContainer(getContainer(modalRootId, ownerDocument));
-        return () => setContainer(undefined);
-    }, [ownerDocument, modalRootId]);
-    return !!container ? (ReactDOM.createPortal(React.createElement(Dialog, { isOpen: isOpen, closeOnEsc: closeOnEsc, closeOnExternalClick: closeOnExternalClick, isDismissible: isDismissible, onClose: onClose, preventDocumentScroll: true, trapFocus: true, setFocus: true, ref: forwardedRef },
-        React.createElement(Dialog.Backdrop, null),
-        React.createElement(Dialog.Main, { "aria-modal": true, ...rest },
-            React.createElement(Dialog.TitleBar, { titleText: title }),
-            children)), container)) : (React.createElement(React.Fragment, null));
+  const {
+    isOpen = false,
+    isDismissible = true,
+    closeOnEsc = true,
+    closeOnExternalClick = true,
+    onClose,
+    title,
+    children,
+    portal = true,
+    ...rest
+  } = props;
+  return React.createElement(
+    Dialog,
+    {
+      isOpen: isOpen,
+      closeOnEsc: closeOnEsc,
+      closeOnExternalClick: closeOnExternalClick,
+      isDismissible: isDismissible,
+      onClose: onClose,
+      preventDocumentScroll: true,
+      trapFocus: true,
+      setFocus: true,
+      ref: forwardedRef,
+      portal: portal,
+    },
+    React.createElement(Dialog.Backdrop, null),
+    React.createElement(
+      Dialog.Main,
+      { 'aria-modal': true, ...rest },
+      React.createElement(Dialog.TitleBar, { titleText: title }),
+      children,
+    ),
+  );
 });
 export default Modal;

package/esm/core/NonIdealState/ErrorPage.d.ts

@@ -1,9 +1,9 @@
 import * as React from 'react';
-import type { CommonProps } from '../utils/index.js';
+import type { PolymorphicForwardRefComponent } from '../utils/index.js';
 /** @deprecated Use `NonIdealState` instead. */
-export declare type ErrorPageType = '300' | '301' | '302' | '303' | '304' | '305' | '307' | '308' | '401' | '403' | '404' | '408' | '500' | '502' | '503' | '504' | 'generic';
+export type ErrorPageType = '300' | '301' | '302' | '303' | '304' | '305' | '307' | '308' | '401' | '403' | '404' | '408' | '500' | '502' | '503' | '504' | 'generic';
 /** @deprecated Use `NonIdealState` instead. */
-export declare type ErrorTypeTranslations = {
+export type ErrorTypeTranslations = {
     badGateway: string;
     error: string;
     forbidden: string;
@@ -14,8 +14,7 @@ export declare type ErrorTypeTranslations = {
     timedOut?: string;
     unauthorized: string;
 };
-/** @deprecated Use `NonIdealState` instead. */
-export declare type ErrorPageProps = {
+type ErrorPageProps = {
     /**
      * Type of error controls image and default text
      */
@@ -50,7 +49,7 @@ export declare type ErrorPageProps = {
      * Used to translate default error messages, if no specific @errorName passed in
      */
     translatedErrorMessages?: ErrorTypeTranslations;
-} & Omit<CommonProps, 'title'>;
+};
 /**
  * @deprecated Use `NonIdealState` instead for a smaller client bundle.
  *
@@ -58,5 +57,5 @@ export declare type ErrorPageProps = {
  * @example
  * <ErrorPage errorType='401' />
  */
-export declare const ErrorPage: (props: ErrorPageProps) => JSX.Element;
+export declare const ErrorPage: PolymorphicForwardRefComponent<"div", ErrorPageProps>;
 export default ErrorPage;

package/esm/core/NonIdealState/ErrorPage.js

@@ -3,9 +3,37 @@
  * See LICENSE.md in the project root for license terms and full copyright notice.
  *--------------------------------------------------------------------------------------------*/
 import * as React from 'react';
-import { Button } from '../Buttons/Button/index.js';
+import { Button } from '../Buttons/Button.js';
 import { NonIdealState } from './NonIdealState.js';
-import { Svg401, Svg403, Svg404, Svg500, Svg502, Svg503, SvgError, SvgRedirect, SvgTimedOut, } from '@itwin/itwinui-illustrations-react';
+import { ProgressRadial } from '../ProgressIndicators/ProgressRadial.js';
+import { dynamicImport } from '../utils/index.js';
+const Svg401 = React.lazy(() =>
+  dynamicImport('@itwin/itwinui-illustrations-react/Svg401'),
+);
+const Svg403 = React.lazy(() =>
+  dynamicImport('@itwin/itwinui-illustrations-react/Svg403'),
+);
+const Svg404 = React.lazy(() =>
+  dynamicImport('@itwin/itwinui-illustrations-react/Svg404'),
+);
+const Svg500 = React.lazy(() =>
+  dynamicImport('@itwin/itwinui-illustrations-react/Svg500'),
+);
+const Svg502 = React.lazy(() =>
+  dynamicImport('@itwin/itwinui-illustrations-react/Svg502'),
+);
+const Svg503 = React.lazy(() =>
+  dynamicImport('@itwin/itwinui-illustrations-react/Svg503'),
+);
+const SvgError = React.lazy(() =>
+  dynamicImport('@itwin/itwinui-illustrations-react/SvgError'),
+);
+const SvgRedirect = React.lazy(() =>
+  dynamicImport('@itwin/itwinui-illustrations-react/SvgRedirect'),
+);
+const SvgTimedOut = React.lazy(() =>
+  dynamicImport('@itwin/itwinui-illustrations-react/SvgTimedOut'),
+);
 /**
  * @deprecated Use `NonIdealState` instead for a smaller client bundle.
  *
@@ -13,125 +41,157 @@ import { Svg401, Svg403, Svg404, Svg500, Svg502, Svg503, SvgError, SvgRedirect,
  * @example
  * <ErrorPage errorType='401' />
  */
-export const ErrorPage = (props) => {
-    const { errorType, errorName, errorMessage, primaryButtonHandle, primaryButtonLabel, secondaryButtonHandle, secondaryButtonLabel, translatedErrorMessages, ...rest } = props;
-    const defaultErrorMessages = {
-        badGateway: 'Bad gateway',
-        error: 'Error',
-        forbidden: 'Forbidden',
-        internalServerError: 'Internal server error',
-        redirect: 'Redirect',
-        pageNotFound: 'Page not found',
-        serviceUnavailable: 'Service unavailable',
-        timedOut: 'Timed out',
-        unauthorized: 'Unauthorized',
-        ...translatedErrorMessages,
-    };
-    function getErrorIcon() {
-        switch (errorType) {
-            case '300':
-            case '301':
-            case '302':
-            case '303':
-            case '304':
-            case '305':
-            case '307':
-            case '308': {
-                return React.createElement(SvgRedirect, null);
-            }
-            case '401': {
-                return React.createElement(Svg401, null);
-            }
-            case '403': {
-                return React.createElement(Svg403, null);
-            }
-            case '404': {
-                return React.createElement(Svg404, null);
-            }
-            case '408':
-            case '504': {
-                return React.createElement(SvgTimedOut, null);
-            }
-            case '500': {
-                return React.createElement(Svg500, null);
-            }
-            case '502': {
-                return React.createElement(Svg502, null);
-            }
-            case '503': {
-                return React.createElement(Svg503, null);
-            }
-            case 'generic':
-            default: {
-                return React.createElement(SvgError, null);
-            }
-        }
+export const ErrorPage = React.forwardRef((props, forwardedRef) => {
+  const {
+    errorType,
+    errorName,
+    errorMessage,
+    primaryButtonHandle,
+    primaryButtonLabel,
+    secondaryButtonHandle,
+    secondaryButtonLabel,
+    translatedErrorMessages,
+    ...rest
+  } = props;
+  const defaultErrorMessages = {
+    badGateway: 'Bad gateway',
+    error: 'Error',
+    forbidden: 'Forbidden',
+    internalServerError: 'Internal server error',
+    redirect: 'Redirect',
+    pageNotFound: 'Page not found',
+    serviceUnavailable: 'Service unavailable',
+    timedOut: 'Timed out',
+    unauthorized: 'Unauthorized',
+    ...translatedErrorMessages,
+  };
+  function getErrorIcon() {
+    switch (errorType) {
+      case '300':
+      case '301':
+      case '302':
+      case '303':
+      case '304':
+      case '305':
+      case '307':
+      case '308': {
+        return React.createElement(SvgRedirect, null);
+      }
+      case '401': {
+        return React.createElement(Svg401, null);
+      }
+      case '403': {
+        return React.createElement(Svg403, null);
+      }
+      case '404': {
+        return React.createElement(Svg404, null);
+      }
+      case '408':
+      case '504': {
+        return React.createElement(SvgTimedOut, null);
+      }
+      case '500': {
+        return React.createElement(Svg500, null);
+      }
+      case '502': {
+        return React.createElement(Svg502, null);
+      }
+      case '503': {
+        return React.createElement(Svg503, null);
+      }
+      case 'generic':
+      default: {
+        return React.createElement(SvgError, null);
+      }
     }
-    function getHeadingMessage() {
-        if (errorName) {
-            return errorName;
-        }
-        switch (errorType) {
-            case '300':
-            case '301':
-            case '302':
-            case '303':
-            case '304':
-            case '305':
-            case '307':
-            case '308': {
-                return defaultErrorMessages.redirect || '';
-            }
-            case '401': {
-                return defaultErrorMessages.unauthorized;
-            }
-            case '403': {
-                return defaultErrorMessages.forbidden;
-            }
-            case '404': {
-                return defaultErrorMessages.pageNotFound;
-            }
-            case '408':
-            case '504': {
-                return defaultErrorMessages.timedOut || '';
-            }
-            case '500': {
-                return defaultErrorMessages.internalServerError;
-            }
-            case '502': {
-                return defaultErrorMessages.badGateway;
-            }
-            case '503': {
-                return defaultErrorMessages.serviceUnavailable;
-            }
-            case 'generic':
-            default: {
-                return defaultErrorMessages.error;
-            }
-        }
+  }
+  function getHeadingMessage() {
+    if (errorName) {
+      return errorName;
     }
-    function getPrimaryButton() {
-        if (!primaryButtonHandle || !primaryButtonLabel) {
-            return undefined;
-        }
-        return (React.createElement(Button, { styleType: 'high-visibility', onClick: primaryButtonHandle }, primaryButtonLabel));
+    switch (errorType) {
+      case '300':
+      case '301':
+      case '302':
+      case '303':
+      case '304':
+      case '305':
+      case '307':
+      case '308': {
+        return defaultErrorMessages.redirect || '';
+      }
+      case '401': {
+        return defaultErrorMessages.unauthorized;
+      }
+      case '403': {
+        return defaultErrorMessages.forbidden;
+      }
+      case '404': {
+        return defaultErrorMessages.pageNotFound;
+      }
+      case '408':
+      case '504': {
+        return defaultErrorMessages.timedOut || '';
+      }
+      case '500': {
+        return defaultErrorMessages.internalServerError;
+      }
+      case '502': {
+        return defaultErrorMessages.badGateway;
+      }
+      case '503': {
+        return defaultErrorMessages.serviceUnavailable;
+      }
+      case 'generic':
+      default: {
+        return defaultErrorMessages.error;
+      }
     }
-    function getSecondaryButton() {
-        if (!secondaryButtonHandle || !secondaryButtonLabel) {
-            return undefined;
-        }
-        return (React.createElement(Button, { styleType: 'default', onClick: secondaryButtonHandle }, secondaryButtonLabel));
+  }
+  function getPrimaryButton() {
+    if (!primaryButtonHandle || !primaryButtonLabel) {
+      return undefined;
     }
-    function getActions() {
-        const primaryButton = getPrimaryButton();
-        const secondaryButton = getSecondaryButton();
-        if (!primaryButton && !secondaryButton) {
-            return undefined;
-        }
-        return (React.createElement(React.Fragment, null,
-            primaryButton,
-            secondaryButton));
+    return React.createElement(
+      Button,
+      { styleType: 'high-visibility', onClick: primaryButtonHandle },
+      primaryButtonLabel,
+    );
+  }
+  function getSecondaryButton() {
+    if (!secondaryButtonHandle || !secondaryButtonLabel) {
+      return undefined;
     }
-    return (React.createElement(NonIdealState, { svg: getErrorIcon(), heading: getHeadingMessage(), description: errorMessage, actions: getActions(), ...rest }));
-};
+    return React.createElement(
+      Button,
+      { styleType: 'default', onClick: secondaryButtonHandle },
+      secondaryButtonLabel,
+    );
+  }
+  function getActions() {
+    const primaryButton = getPrimaryButton();
+    const secondaryButton = getSecondaryButton();
+    if (!primaryButton && !secondaryButton) {
+      return undefined;
+    }
+    return React.createElement(
+      React.Fragment,
+      null,
+      primaryButton,
+      secondaryButton,
+    );
+  }
+  return React.createElement(NonIdealState, {
+    svg: React.createElement(
+      React.Suspense,
+      { fallback: React.createElement(ProgressRadial, null) },
+      getErrorIcon(),
+    ),
+    heading: getHeadingMessage(),
+    description: errorMessage,
+    actions: getActions(),
+    ref: forwardedRef,
+    ...rest,
+  });
+});
 export default ErrorPage;

package/esm/core/NonIdealState/NonIdealState.d.ts

@@ -1,6 +1,6 @@
 import * as React from 'react';
 import type { PolymorphicForwardRefComponent } from '../utils/index.js';
-declare type NonIdealStateProps = {
+type NonIdealStateProps = {
     /**
      * An svg component, preferably from @itwin/itwinui-illustrations-react.
      *
@@ -34,6 +34,22 @@ declare type NonIdealStateProps = {
      * />
      */
     actions?: React.ReactNode;
+    /**
+     *  Allows props to be passed for non-ideal-state-illustration
+     */
+    illustrationProps?: React.ComponentProps<'div'>;
+    /**
+     *  Allows props to be passed for non-ideal-state-title
+     */
+    titleProps?: React.ComponentProps<'div'>;
+    /**
+     *  Allows props to be passed for non-ideal-state-description
+     */
+    descriptionProps?: React.ComponentProps<'div'>;
+    /**
+     *  Allows props to be passed for non-ideal-state-action
+     */
+    actionsProps?: React.ComponentProps<'div'>;
 };
 /**
  * A stylized display to communicate common http errors and other non-ideal states.

package/esm/core/NonIdealState/NonIdealState.js

@@ -13,11 +13,70 @@ import cx from 'classnames';
  * <NonIdealState svg={<Svg404 />} heading='Not found' />
  */
 export const NonIdealState = React.forwardRef((props, forwardedRef) => {
-    const { className, svg, heading, description, actions, ...rest } = props;
-    return (React.createElement(Box, { className: cx('iui-non-ideal-state', className), ref: forwardedRef, ...rest },
-        React.createElement(Box, { className: 'iui-non-ideal-state-illustration' }, svg),
-        heading && React.createElement(Box, { className: 'iui-non-ideal-state-title' }, heading),
-        description && (React.createElement(Box, { className: 'iui-non-ideal-state-description' }, description)),
-        actions && React.createElement(Box, { className: 'iui-non-ideal-state-actions' }, actions)));
+  const {
+    className,
+    svg,
+    heading,
+    description,
+    actions,
+    illustrationProps,
+    titleProps,
+    descriptionProps,
+    actionsProps,
+    ...rest
+  } = props;
+  return React.createElement(
+    Box,
+    {
+      className: cx('iui-non-ideal-state', className),
+      ref: forwardedRef,
+      ...rest,
+    },
+    React.createElement(
+      Box,
+      {
+        as: 'div',
+        ...illustrationProps,
+        className: cx(
+          'iui-non-ideal-state-illustration',
+          illustrationProps?.className,
+        ),
+      },
+      svg,
+    ),
+    heading &&
+      React.createElement(
+        Box,
+        {
+          as: 'div',
+          ...titleProps,
+          className: cx('iui-non-ideal-state-title', titleProps?.className),
+        },
+        heading,
+      ),
+    description &&
+      React.createElement(
+        Box,
+        {
+          as: 'div',
+          ...descriptionProps,
+          className: cx(
+            'iui-non-ideal-state-description',
+            descriptionProps?.className,
+          ),
+        },
+        description,
+      ),
+    actions &&
+      React.createElement(
+        Box,
+        {
+          as: 'div',
+          ...actionsProps,
+          className: cx('iui-non-ideal-state-actions', actionsProps?.className),
+        },
+        actions,
+      ),
+  );
 });
 export default NonIdealState;

package/esm/core/NotificationMarker/NotificationMarker.d.ts

@@ -1,6 +1,6 @@
 import * as React from 'react';
 import type { PolymorphicForwardRefComponent } from '../utils/index.js';
-declare type NotificationMarkerProps = {
+type NotificationMarkerProps = {
     /**
      * Content of the NotificationMarker.
      */

package/esm/core/NotificationMarker/NotificationMarker.js

@@ -18,7 +18,25 @@ import cx from 'classnames';
  * <NotificationMarker status='positive' pulsing={true}>Live</NotificationMarker>
  */
 export const NotificationMarker = React.forwardRef((props, ref) => {
-    const { className, children, status = 'primary', pulsing = false, enabled = true, ...rest } = props;
-    return (React.createElement(Box, { as: 'span', ref: ref, className: cx({ 'iui-notification-marker': enabled }, className), "data-iui-variant": enabled ? status : null, "data-iui-urgent": enabled ? pulsing : null, ...rest }, children));
+  const {
+    className,
+    children,
+    status = 'primary',
+    pulsing = false,
+    enabled = true,
+    ...rest
+  } = props;
+  return React.createElement(
+    Box,
+    {
+      as: 'span',
+      ref: ref,
+      className: cx({ 'iui-notification-marker': enabled }, className),
+      'data-iui-variant': enabled ? status : null,
+      'data-iui-urgent': enabled ? pulsing : null,
+      ...rest,
+    },
+    children,
+  );
 });
 export default NotificationMarker;

package/esm/core/Overlay/Overlay.d.ts

@@ -0,0 +1,57 @@
+import React from 'react';
+import type { PolymorphicForwardRefComponent } from '../utils/index.js';
+type OverlayComponentProps = {
+    /**
+     * The sub-component elements of Overlay.
+     */
+    children?: React.ReactNode;
+    /**
+     * Placeholder for Progress Indicator in Overlay
+     */
+    content?: React.ReactNode;
+};
+/**
+ *
+ * This is an Overlay Component.
+ *
+ *
+ * @example
+ * <Overlay content="loading">
+ * content beneath the overlay... (text, img, etc.)
+ * </Overlay>
+ *
+ *
+ * This is an Overlay Component using subcomponents.
+ *
+ *
+ * @example
+ * <Overlay.Wrapper>
+ *  <Overlay.Overlay>
+ *    loading...
+ *  <Overlay.Overlay>
+ *  <Overlay.HiddenContent>
+ *    content beneath the overlay... (text, img, etc.)
+ *  <Overlay.HiddenContent />
+ * </Overlay.Wrapper>
+ *
+ *
+ */
+export declare const Overlay: PolymorphicForwardRefComponent<"div", OverlayComponentProps> & {
+    /**
+     *
+     * The main component is a wrapper to hold the
+     * Overlay HiddenContent and Overlay Message.
+     */
+    Wrapper: PolymorphicForwardRefComponent<NonNullable<keyof JSX.IntrinsicElements>, {}>;
+    /**
+     * HiddenContent houses page elements that are blurred by the
+     * Overlay.
+     */
+    HiddenContent: PolymorphicForwardRefComponent<"div", {}>;
+    /**
+     *  Message contains the progress indicator and loading message
+     *  for the Overlay. It sits on top of the HiddenContent.
+     */
+    Overlay: PolymorphicForwardRefComponent<NonNullable<keyof JSX.IntrinsicElements>, {}>;
+};
+export {};