[terra-application] Add subpath exports (#384)

packages/terra-application-docs/CHANGELOG.md

@@ -4,6 +4,7 @@
 
 * Changed
   * Set minimum Node version to 14.
+  * Updated docs to utilize the new terra-application imports.
 
 ## 3.1.0 - (June 22, 2022)
 

packages/terra-application-docs/src/dev-site-extended-test/component/ThemedComponent.jsx

@@ -1,7 +1,9 @@
+/* eslint-disable import/no-unresolved */
+
 import React from 'react';
 import classNames from 'classnames/bind';
-import { ApplicationIntlContext } from 'terra-application/lib/application-intl';
-import { ThemeContext } from 'terra-application/lib/theme';
+import { ApplicationIntlContext } from 'terra-application/application-intl';
+import { ThemeContext } from 'terra-application/theme';
 
 import styles from './ThemedComponent.module.scss';
 

packages/terra-application-docs/src/terra-dev-site/test/terra-dev-site/navigationPrompt.test.jsx

@@ -1,5 +1,5 @@
 import React, { useState } from 'react';
-import NavigationPrompt from 'terra-application/lib/navigation-prompt';
+import NavigationPrompt from 'terra-application/navigation-prompt';
 
 const ExampleComponent = () => {
   const [hasPendingState, setHasPendingState] = useState(false);

packages/terra-application/CHANGELOG.md

@@ -2,6 +2,10 @@
 
 ## Unreleased
 
+* Breaking Changes:
+  * Added subpath exports for terra-application submodules. This replaces the old exports that utilize the exact path.
+  * Removed default `ApplicationBase` import. `ApplicationBase` will now need to be imported from `terra-application/application-base`.
+
 * Changed
   * Dropped support for Node 8, 10 & 12. Node 14 is now the minimum required version.
   * Locked `intl-locales-supported` to `1.8.11`.

packages/terra-application/package.json

@@ -22,7 +22,39 @@
   "engines": {
     "node": "14"
   },
-  "main": "lib/application-base/ApplicationBase.js",
+  "exports": {
+    "./action-menu": "./lib/action-menu/index.js",
+    "./application-base": "./lib/application-base/index.js",
+    "./application-container": "./lib/application-container/index.js",
+    "./application-error-boundary": "./lib/application-error-boundary/index.js",
+    "./application-intl": "./lib/application-intl/index.js",
+    "./application-loading-overlay": "./lib/application-loading-overlay/index.js",
+    "./application-navigation": "./lib/application-navigation/index.js",
+    "./application-status-overlay": "./lib/application-status-overlay/index.js",
+    "./breakpoints": "./lib/breakpoints/index.js",
+    "./disclosure-manager": "./lib/disclosure-manager/index.js",
+    "./modal-manager": "./lib/modal-manager/index.js",
+    "./navigation-prompt": "./lib/navigation-prompt/index.js",
+    "./notification-banner": "./lib/notification-banner/index.js",
+    "./slide-panel-manager": "./lib/slide-panel-manager/index.js",
+    "./terra-dev-site": "./lib/terra-dev-site/index.js",
+    "./theme": "./lib/theme/index.js",
+    "./utils": "./lib/utils/index.js",
+    "./workspace": "./lib/workspace/index.js",
+    "./utils/event-emitter": "./lib/utils/event-emitter/index.js",
+    "./utils/logger": "./lib/utils/logger/index.js",
+    "./package.json": "./package.json",
+    "./*": "./*",
+    "./application-base/*": "./lib/application-base/*",
+    "./application-error-boundary/*": "./lib/application-error-boundary/*",
+    "./application-loading-overlay/*": "./lib/application-loading-overlay/*",
+    "./application-navigation/*": "./lib/application-navigation/*",
+    "./application-status-overlay/*": "./lib/application-status-overlay/*",
+    "./breakpoints/*": "./lib/breakpoints/*",
+    "./modal-manager/*": "./lib/modal-manager/*",
+    "./slide-panel-manager/*": "./lib/slide-panel-manager/*",
+    "./workspace/*": "./lib/workspace/*"
+  },
   "files": [
     "lib",
     "src",

packages/terra-application/src/application-base/ApplicationBase.jsx

@@ -18,7 +18,7 @@ import { ApplicationStatusOverlayProvider } from '../application-status-overlay'
 import { NavigationPromptCheckpoint } from '../navigation-prompt';
 import getBrowserLocale from './private/getBrowserLocale';
 import useTestOverrides from './private/useTestOverrides';
-import Logger from '../utils/logger';
+import { Logger } from '../utils';
 
 import './private/initializeInert';
 import './baseStyles';

packages/terra-application/src/application-base/baseStyles.js

@@ -1,5 +1,5 @@
 import './Base.scss';
-import Logger from '../utils/logger';
+import { Logger } from '../utils';
 
 // Checks to run when not in production
 if (process.env.NODE_ENV !== 'production') {

packages/terra-application/src/application-base/private/intlLoaders.js

@@ -1,6 +1,6 @@
 import hasIntlData from 'intl-locales-supported';
 import loadLocaleData from './loadLocaleData';
-import logger from '../../utils/logger';
+import { Logger } from '../../utils';
 
 const supportedIntlConstructors = (polyfill) => {
   /**
@@ -52,7 +52,7 @@ const loadIntl = (locale, polyfill) => {
   if (!hasIntlData([locale], supportedIntlConstructors(polyfill))) {
     return loadLocaleData(locale, polyfill).catch((error) => {
       if (fallbackLocale) {
-        logger.warn(`${error.message} Using ${fallbackLocale} data as the fallback locale data.`);
+        Logger.warn(`${error.message} Using ${fallbackLocale} data as the fallback locale data.`);
         if (!hasIntlData([fallbackLocale], supportedIntlConstructors(polyfill))) {
           return loadLocaleData(fallbackLocale, polyfill);
         }
@@ -62,7 +62,7 @@ const loadIntl = (locale, polyfill) => {
 
       return Promise.resolve();
     }).catch((error) => {
-      logger.warn(`${error.message} Using en data as the fallback locale data.`);
+      Logger.warn(`${error.message} Using en data as the fallback locale data.`);
 
       if (!hasIntlData(['en'], supportedIntlConstructors(polyfill))) {
         return loadLocaleData('en', polyfill);

packages/terra-application/src/application-base/private/translationsLoaders.js

@@ -1,5 +1,5 @@
 /* eslint-disable import/no-unresolved */
-import logger from '../../utils/logger';
+import { Logger } from '../../utils';
 
 const loadTranslationsFile = (locale) => {
   switch (locale) {
@@ -44,15 +44,15 @@ const loadTranslations = (locale) => {
   const fallbackLocale = locale.split('-').length > 1 ? locale.split('-')[0] : false;
 
   return loadTranslationsFile(locale).catch((error) => {
-    logger.warn(`${error.message} Using ${fallbackLocale} data as the fallback locale.`);
+    Logger.warn(`${error.message} Using ${fallbackLocale} data as the fallback locale.`);
 
     if (fallbackLocale) {
       return loadTranslationsFile(fallbackLocale);
     }
 
     return Promise.reject(error);
   }).catch((error) => {
-    logger.warn(`${error.message} Using en as the fallback locale.`);
+    Logger.warn(`${error.message} Using en as the fallback locale.`);
 
     return loadTranslationsFile('en');
   });

packages/terra-application/src/application-error-boundary/ApplicationErrorBoundary.jsx

@@ -2,7 +2,7 @@ import React from 'react';
 import PropTypes from 'prop-types';
 import StatusView from 'terra-status-view';
 import { injectIntl } from 'react-intl';
-import logger from '../utils/logger';
+import { Logger } from '../utils';
 
 const propTypes = {
   /**
@@ -79,7 +79,7 @@ class ApplicationErrorBoundary extends React.Component {
      * the ApplicationErrorBoundary to update again to ensure that the StatusView remains presented until the
      * next update occurs.
      */
-    logger.error(error);
+    Logger.error(error);
     this.errorRef.current = error;
     this.setState({ error: undefined });
   }

packages/terra-application/src/terra-dev-site/app/components.2/ApplicationBase.app.mdx

@@ -1,4 +1,4 @@
-import PropsTable from 'terra-application/lib/application-base/ApplicationBase?dev-site-props-table';
+import PropsTable from 'terra-application/application-base/ApplicationBase?dev-site-props-table';
 
 # ApplicationBase
 
@@ -9,7 +9,7 @@ The ApplicationBase component is the entrypoint into the Terra application frame
 ## Usage
 
 ```jsx
-import ApplicationBase from 'terra-application/lib/application-base';
+import ApplicationBase from 'terra-application/application-base';
 ```
 
 ## Props

packages/terra-application/src/terra-dev-site/app/components.2/ApplicationErrorBoundary.app.mdx

@@ -1,4 +1,4 @@
-import PropsTable from 'terra-application/lib/application-error-boundary/ApplicationErrorBoundary?dev-site-props-table';
+import PropsTable from 'terra-application/application-error-boundary/ApplicationErrorBoundary?dev-site-props-table';
 import ApplicationErrorBoundaryExample from './example/ApplicationErrorBoundaryExample?dev-site-example';
 
 # ApplicationErrorBoundary
@@ -8,7 +8,7 @@ The ApplicationErrorBoundary catches exceptions thrown during its children's ren
 ## Usage
 
 ```jsx
-import ApplicationErrorBoundary from 'terra-application/lib/application-error-boundary';
+import ApplicationErrorBoundary from 'terra-application/application-error-boundary';
 ```
 
 ## Props

packages/terra-application/src/terra-dev-site/app/components.2/ApplicationLoadingOverlay.app.mdx

@@ -13,7 +13,7 @@ present a loading overlay.
 ## Usage
 
 ```jsx
-import ApplicationLoadingOverlay from 'terra-application/lib/application-loading-overlay';
+import ApplicationLoadingOverlay from 'terra-application/application-loading-overlay';
 ```
 
 ## Props

packages/terra-application/src/terra-dev-site/app/components.2/ApplicationLoadingOverlayProvider.app.mdx

@@ -1,4 +1,4 @@
-import ApplicationLoadingOverlayProviderProps from 'terra-application/lib/application-loading-overlay/ApplicationLoadingOverlayProvider?dev-site-props-table';
+import ApplicationLoadingOverlayProviderProps from 'terra-application/application-loading-overlay/ApplicationLoadingOverlayProvider?dev-site-props-table';
 
 # ApplicationLoadingOverlayProvider
 
@@ -18,7 +18,7 @@ with the darkest specified style being honored.
 ## Usage
 
 ```jsx
-import { ApplicationLoadingOverlayProvider } from 'terra-application/lib/application-loading-overlay';
+import { ApplicationLoadingOverlayProvider } from 'terra-application/application-loading-overlay';
 ```
 
 ## Props

packages/terra-application/src/terra-dev-site/app/components.2/ApplicationNavigation.app.mdx

@@ -1,5 +1,5 @@
-import PropsTable from 'terra-application/lib/application-navigation/ApplicationNavigation?dev-site-props-table';
-import ApplicationNavigationWorkspaceProps from 'terra-application/lib/application-navigation/private/workspace-layout/ApplicationNavigationWorkspace?dev-site-props-table';
+import PropsTable from 'terra-application/application-navigation/ApplicationNavigation?dev-site-props-table';
+import ApplicationNavigationWorkspaceProps from 'terra-application/application-navigation/private/workspace-layout/ApplicationNavigationWorkspace?dev-site-props-table';
 
 import ApplicationNavigationExample from './example/ApplicationNavigationExample?dev-site-example';
 import ApplicationNavigationWorkspaceExample from './example/ApplicationNavigationWorkspaceExample?dev-site-example';
@@ -13,7 +13,7 @@ The ApplicationNavigation component provides a styled layout and controls used f
 ## Usage
 
 ```jsx
-import ApplicationNavigation from 'terra-application/lib/application-navigation';
+import ApplicationNavigation from 'terra-application/application-navigation';
 ```
 
 ## Required Contexts

packages/terra-application/src/terra-dev-site/app/components.2/ApplicationStatusOverlay.app.mdx

@@ -13,7 +13,7 @@ present a staus view.
 ## Usage
 
 ```jsx
-import ApplicationStatusOverlay from 'terra-application/lib/application-status-overlay';
+import ApplicationStatusOverlay from 'terra-application/application-status-overlay';
 ```
 
 ## Props

packages/terra-application/src/terra-dev-site/app/components.2/ApplicationStatusOverlayProvider.app.mdx

@@ -1,4 +1,4 @@
-import ApplicationStatusOverlayProviderProps from 'terra-application/lib/application-status-overlay/ApplicationStatusOverlayProvider?dev-site-props-table';
+import ApplicationStatusOverlayProviderProps from 'terra-application/application-status-overlay/ApplicationStatusOverlayProvider?dev-site-props-table';
 
 # ApplicationStatusOverlayProvider
 
@@ -15,7 +15,7 @@ are rendered at the same time, with the last rendered ApplicationStatusOverlay g
 ## Usage
 
 ```jsx
-import { ApplicationStatusOverlayProvider } from 'terra-application/lib/application-status-overlay';
+import { ApplicationStatusOverlayProvider } from 'terra-application/application-status-overlay';
 ```
 
 ## Props

packages/terra-application/src/terra-dev-site/app/components.2/ModalManager.app.mdx

@@ -1,4 +1,4 @@
-import PropsTable from 'terra-application/lib/modal-manager/ModalManager?dev-site-props-table';
+import PropsTable from 'terra-application/modal-manager/ModalManager?dev-site-props-table';
 
 # ModalManager
 
@@ -8,7 +8,7 @@ The ModalManager exposes its children to modal presentation APIs through the
 ## Usage
 
 ```jsx
-import ModalManager from 'terra-application/lib/modal-manager';
+import ModalManager from 'terra-application/modal-manager';
 ```
 
 ## Props
@@ -145,8 +145,8 @@ For application content that needs more specific dimensional control of modal si
 ```jsx
 import React from 'react';
 import Button from 'terra-button';
-import ModalManager, { disclosureType } from 'terra-application/lib/modal-manager';
-import { withDisclosureManager, DisclosureManagerContext, DisclosureManagerHeaderAdapter } from 'terra-application/lib/disclosure-manager';
+import ModalManager, { disclosureType } from 'terra-application/modal-manager';
+import { withDisclosureManager, DisclosureManagerContext, DisclosureManagerHeaderAdapter } from 'terra-application/disclosure-manager';
 import CollapsibleMenuView from 'terra-collapsible-menu-view';
 
 const ModalComponentB = () => (

packages/terra-application/src/terra-dev-site/app/components.2/NavigationPrompt.app.mdx

@@ -9,7 +9,7 @@ of pending actions or unsaved changes to the framework.
 ## Usage
 
 ```jsx
-import NavigationPrompt from 'terra-application/lib/navigation-prompt';
+import NavigationPrompt from 'terra-application/navigation-prompt';
 ```
 
 ## Props

packages/terra-application/src/terra-dev-site/app/components.2/NavigationPromptCheckpoint.app.mdx

@@ -10,7 +10,7 @@ influence its navigational workflows as necessary.
 ## Usage
 
 ```jsx
-import { NavigationPromptCheckpoint } from 'terra-application/lib/navigation-prompt';
+import { NavigationPromptCheckpoint } from 'terra-application/navigation-prompt';
 ```
 
 ## Props
@@ -63,7 +63,7 @@ to match the prompt messaging provided by the components within `terra-applicati
 ```jsx
 import React, { useContext, useRef } from 'react';
 import { useIntl } from 'react-intl';
-import { NavigationPromptCheckpoint, getUnsavedChangesPromptOptions } from 'terra-application/lib/navigation-prompt';
+import { NavigationPromptCheckpoint, getUnsavedChangesPromptOptions } from 'terra-application/navigation-prompt';
 
 const ExampleComponent = () => {
   const checkpointRef = useRef();

packages/terra-application/src/terra-dev-site/app/components.2/SlidePanelManager.app.mdx

@@ -1,4 +1,4 @@
-import PropsTable from 'terra-application/lib/slide-panel-manager/SlidePanelManager?dev-site-props-table';
+import PropsTable from 'terra-application/slide-panel-manager/SlidePanelManager?dev-site-props-table';
 
 <Badge />
 
@@ -10,7 +10,7 @@ The SlidePanelManager exposes its children to panel presentation APIs through th
 ## Usage
 
 ```jsx
-import SlidePanelManager from 'terra-application/lib/slide-panel-manager';
+import SlidePanelManager from 'terra-application/slide-panel-manager';
 ```
 
 ## Props
@@ -89,8 +89,8 @@ and each component in the disclosure stack will be decorated with the same acces
 ```jsx
 import React from 'react';
 import Button from 'terra-button';
-import SlidePanelManager, { disclosureType } from 'terra-application/lib/slide-panel-manager';
-import { withDisclosureManager, DisclosureManagerContext, DisclosureManagerHeaderAdapter } from 'terra-application/lib/disclosure-manager';
+import SlidePanelManager, { disclosureType } from 'terra-application/slide-panel-manager';
+import { withDisclosureManager, DisclosureManagerContext, DisclosureManagerHeaderAdapter } from 'terra-application/disclosure-manager';
 import CollapsibleMenuView from 'terra-collapsible-menu-view';
 
 const PanelComponentB = () => (

packages/terra-application/src/terra-dev-site/app/components.2/WorkspaceContent.app.mdx

@@ -1,7 +1,7 @@
-import WorkspaceContentProps from 'terra-application/lib/workspace/WorkspaceContent?dev-site-props-table';
-import WorkspaceContentStatusOverlayProps from 'terra-application/lib/workspace/overlays/WorkspaceContentStatusOverlay?dev-site-props-table';
-import WorkspaceContentStatusOverlayButtonProps from 'terra-application/lib/workspace/shared/StatusLayoutButton?dev-site-props-table';
-import WorkspaceContentActivityOverlayProps from 'terra-application/lib/workspace/overlays/WorkspaceContentActivityOverlay?dev-site-props-table';
+import WorkspaceContentProps from 'terra-application/workspace/WorkspaceContent?dev-site-props-table';
+import WorkspaceContentStatusOverlayProps from 'terra-application/workspace/overlays/WorkspaceContentStatusOverlay?dev-site-props-table';
+import WorkspaceContentStatusOverlayButtonProps from 'terra-application/workspace/shared/StatusLayoutButton?dev-site-props-table';
+import WorkspaceContentActivityOverlayProps from 'terra-application/workspace/overlays/WorkspaceContentActivityOverlay?dev-site-props-table';
 
 import { Notice } from '@cerner/terra-docs';
 
@@ -12,7 +12,7 @@ The WorkspaceContent component is essential for integrating into the workspace.
 ## Usage
 
 ```jsx
-import { WorkspaceContent } from 'terra-application/lib/workspace';
+import { WorkspaceContent } from 'terra-application/workspace';
 ```
 
 Please see the [How To Create Workspace Content](/application/terra-application/how-to/create-workspace-content) guide for more usage information.

packages/terra-application/src/terra-dev-site/app/components.2/example/ApplicationBaseExample.jsx

@@ -1,10 +1,10 @@
 import React, { useState, useContext } from 'react';
 import { useIntl } from 'react-intl';
-import { ThemeContext } from 'terra-application/lib/theme';
-import { ActiveBreakpointContext } from 'terra-application/lib/breakpoints';
-import ApplicationLoadingOverlay from 'terra-application/lib/application-loading-overlay';
-import ApplicationBase from 'terra-application/lib/application-base';
-import NavigationPrompt from 'terra-application/lib/navigation-prompt';
+import { ThemeContext } from 'terra-application/theme';
+import { ActiveBreakpointContext } from 'terra-application/breakpoints';
+import ApplicationLoadingOverlay from 'terra-application/application-loading-overlay';
+import ApplicationBase from 'terra-application/application-base';
+import NavigationPrompt from 'terra-application/navigation-prompt';
 
 const ApplicationContentExample = () => {
   const [isLoading, setIsLoading] = useState(false);

packages/terra-application/src/terra-dev-site/app/components.2/example/ApplicationErrorBoundaryExample.jsx

@@ -2,7 +2,7 @@ import React, { useState } from 'react';
 import PropTypes from 'prop-types';
 import classNames from 'classnames/bind';
 
-import ApplicationErrorBoundary from 'terra-application/lib/application-error-boundary/ApplicationErrorBoundary';
+import ApplicationErrorBoundary from 'terra-application/application-error-boundary';
 import styles from './ApplicationErrorBoundaryExample.module.scss';
 
 const cx = classNames.bind(styles);

packages/terra-application/src/terra-dev-site/app/components.2/example/ApplicationLoadingOverlayExample.jsx

@@ -1,7 +1,7 @@
 import React, { useState } from 'react';
 import classNames from 'classnames/bind';
-import ApplicationLoadingOverlay from 'terra-application/lib/application-loading-overlay/ApplicationLoadingOverlay';
-import ApplicationLoadingOverlayProvider from 'terra-application/lib/application-loading-overlay/ApplicationLoadingOverlayProvider';
+import ApplicationLoadingOverlay from 'terra-application/application-loading-overlay/ApplicationLoadingOverlay';
+import ApplicationLoadingOverlayProvider from 'terra-application/application-loading-overlay/ApplicationLoadingOverlayProvider';
 
 import styles from './ApplicationErrorBoundaryExample.module.scss';