feat(project): add flat exports for namespaced components

packages/react/docs/migration/11.x-namespaced-exports.md

@@ -0,0 +1,44 @@
+# Namespaced exports
+
+<!-- START doctoc generated TOC please keep comment here to allow auto update -->
+<!-- DON'T EDIT THIS SECTION, INSTEAD RE-RUN doctoc TO UPDATE -->
+
+## Table of Contents
+
+- [Overview](#overview)
+- [Process](#process)
+- [Changes:](#changes)
+
+<!-- END doctoc generated TOC please keep comment here to allow auto update -->
+
+## Overview
+
+In v10.x there were a few exported components that were only exposed under the
+namespace of another component. These have been deprecated, and a new export has
+been made available for each so these can be imported directly. In v11.x the
+namespaced exports will be removed.
+
+## Process
+
+1. Update imports for the components listed in the table below.
+
+```diff
+- import TextInput from 'carbon-components-react';
++ import { PasswordInput } from 'carbon-components-react';
+```
+
+2. Update usages of the components listed in the table below, they no longer
+   need the namespace
+
+```diff
+- <TextInput.PasswordInput/>
++ <PasswordInput/>
+```
+
+## Changes:
+
+| v10.x                               | v11.x                     |
+| ----------------------------------- | ------------------------- |
+| `TextInput.ControlledPasswordInput` | `ControlledPasswordInput` |
+| `TextInput.PasswordInput`           | `PasswordInput`           |
+| `MultiSelect.Filterable`            | `FilterableMultiSelect`   |

packages/react/src/__tests__/index-test.js

@@ -35,6 +35,7 @@ describe('Carbon Components React', () => {
         "ComposedModal",
         "Content",
         "ContentSwitcher",
+        "ControlledPasswordInput",
         "Copy",
         "CopyButton",
         "DangerButton",
@@ -96,6 +97,7 @@ describe('Carbon Components React', () => {
         "Pagination",
         "PaginationNav",
         "PaginationSkeleton",
+        "PasswordInput",
         "PrimaryButton",
         "ProgressIndicator",
         "ProgressIndicatorSkeleton",

packages/react/src/components/FilterableMultiSelect/index.js

@@ -0,0 +1 @@
+export FilterableMultiSelect from '../MultiSelect/FilterableMultiSelect';

packages/react/src/components/PasswordInput/index.js

@@ -0,0 +1,2 @@
+export ControlledPasswordInput from '../TextInput/ControlledPasswordInput';
+export PasswordInput from '../TextInput/PasswordInput';

packages/react/src/components/TextInput/TextInput-story.js

@@ -8,7 +8,7 @@
 import React, { useState } from 'react';
 import { action } from '@storybook/addon-actions';
 import { withKnobs, boolean, select, text } from '@storybook/addon-knobs';
-import TextInput from '../TextInput';
+import { TextInput } from '../../index';
 import TextInputSkeleton from '../TextInput/TextInput.Skeleton';
 import FluidForm from '../FluidForm/FluidForm';
 import mdx from './TextInput.mdx';

packages/react/src/index.js

@@ -5,6 +5,8 @@
  * LICENSE file in the root directory of this source tree.
  */
 
+import { deprecateFieldOnObject } from './internal/deprecateFieldOnObject';
+
 export Accordion from './components/Accordion';
 export AccordionItem from './components/AccordionItem';
 export { AspectRatio } from './components/AspectRatio';
@@ -72,7 +74,15 @@ export ListItem from './components/ListItem';
 export Loading from './components/Loading';
 export Modal from './components/Modal';
 export ModalWrapper from './components/ModalWrapper';
-export MultiSelect from './components/MultiSelect';
+import MultiSelect from './components/MultiSelect';
+if (__DEV__) {
+  deprecateFieldOnObject(
+    MultiSelect,
+    'MultiSelect.Filterable',
+    MultiSelect.Filterable
+  );
+}
+export { MultiSelect };
 export {
   ToastNotification,
   InlineNotification,
@@ -86,6 +96,10 @@ export OverflowMenu from './components/OverflowMenu';
 export OverflowMenuItem from './components/OverflowMenuItem';
 export Pagination from './components/Pagination';
 export PaginationNav from './components/PaginationNav';
+export {
+  ControlledPasswordInput,
+  PasswordInput,
+} from './components/PasswordInput';
 export PrimaryButton from './components/PrimaryButton';
 export {
   ProgressIndicator,
@@ -117,7 +131,16 @@ export TabContent from './components/TabContent';
 export Tabs from './components/Tabs';
 export Tag from './components/Tag';
 export TextArea from './components/TextArea';
-export TextInput from './components/TextInput';
+import TextInput from './components/TextInput';
+if (__DEV__) {
+  deprecateFieldOnObject(
+    TextInput,
+    'ControlledPasswordInput',
+    TextInput.ControlledPasswordInput
+  );
+  deprecateFieldOnObject(TextInput, 'PasswordInput', TextInput.PasswordInput);
+}
+export { TextInput };
 export {
   Tile,
   ClickableTile,

packages/react/src/internal/deprecateFieldOnObject.js

@@ -0,0 +1,30 @@
+/**
+ * Copyright IBM Corp. 2016, 2018
+ *
+ * This source code is licensed under the Apache-2.0 license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+import { warning } from '../internal/warning';
+
+const didWarnAboutDeprecation = {};
+
+function deprecateFieldOnObject(object, field, Component, message) {
+  Object.defineProperty(object, field, {
+    enumerable: true,
+    get() {
+      if (!didWarnAboutDeprecation[field]) {
+        warning(
+          false,
+          message ||
+            `The ${field} field has been deprecated on the ${object.displayName} object. ` +
+              `Please import and use ${field} directly.`
+        );
+        didWarnAboutDeprecation[field] = true;
+      }
+
+      return Component;
+    },
+  });
+}
+
+export { deprecateFieldOnObject };