@boomerang-io/carbon-addons-boomerang-react 4.6.10-beta.0 → 4.6.10-beta.1

package/README.md

@@ -1,162 +1,162 @@
-# Carbon Addons Boomerang React [![Netlify Status](https://api.netlify.com/api/v1/badges/ebf40744-c9a5-4c91-a43d-e885b7e2da88/deploy-status)](https://app.netlify.com/sites/carbon-addons-boomerang-react/deploys)
-
-[Carbon](https://www.carbondesignsystem.com/) addon components for Boomerang written in React. View the [Storybook](https://carbon-addons-boomerang-react.netlify.app/).
-
-## Installing
-
-Install the the addons package, carbon and all of the required peer-dependencies.
-
-Run the following command using [pnpm](https://pnpm.io). Other package managers like `npm` and `yarn` work as well.
-
-```bash
-pnpm install @carbon/react @boomerang-io/carbon-addons-boomerang-react axios@0.27.2 formik react-router-dom@5 yup
-```
-
-Upgrading from a previous version? View our [migration guide](/docs/v4-migration.md).
-
-## Styles
-
-You need to use Sass, as we are built on top of Carbon and import the entry style sheet for the components. We recommend using `sass` or `sass-embedded` to compile styles. Configure as required for the bundler you are using. Tools like Vite and Create React App work without additional configuration needed.
-
-```scss
-// app.scss
-@use "@carbon/react";
-@use "@boomerang-io/carbon-addons-boomerang-react/scss/global";
-```
-
-Import this file in the JavaScript code to ensure that it is included in your bundle.
-
-## Carbon themes
-
-We recommend using Carbon theme functionality and the associated CSS custom properties in your styles to easily use Carbon theme tokens. See the following example for guidance on a couple common use cases.
-
-### Default theme
-
-```scss
-// styles.scss
-@use "@carbon/react";
-@use '@carbon/themes';
-@use "@boomerang-io/carbon-addons-boomerang-react/scss/global";
-
-// Include theme tokens
-:root {
-  @include themes.theme();
-}
-```
-
-### Gray 10 theme
-
-This is how we import things in our applications. We use a number of Carbon v10 tokens so we use the compatibility g10 theme from Carbon to support both new and old values. We also use Akamai as the host for our fonts instead of self-hosting via the `$use-akamai-cdn: true` argument to the `@carbon/react` import. View the Carbon docs to see all the arguments you can pass to customize how you use Carbon
-
-```scss
-@use "@carbon/react" with (
-  $use-akamai-cdn: true
-);
-@use "@carbon/themes";
-@use "@carbon/react/scss/compat/themes" as compat;
-@use "@boomerang-io/carbon-addons-boomerang-react/scss/global";
-
-:root {
-  @include themes.theme(compat.$g10);
-}
-```
-
-> Note: The library does not currently support changing the default class prefix from `cds`.
-
-## Boomerang theme
-
-Do you want to continue using the Boomerang theme? Follow the steps below.
-
-## Step 1 - Import styles
-
-Import the individual Carbon packages and addons styles as follows:
-
-```scss
-// app.scss
-@use "sass:map";
-
-// Carbon base styles and utilities
-@use '@carbon/react/scss/config' with ($use-akamai-cdn: true);
-@use '@carbon/react/scss/reset';
-@use '@carbon/react/scss/motion';
-@use '@carbon/react/scss/type';
-
-// Themes
-@use "@boomerang-io/carbon-addons-boomerang-react/scss/global/themes/boomerang";
-@use '@carbon/react/scss/compat/themes' as compat;
-@use '@carbon/react/scss/compat/theme' with (
-  $theme: map.merge(compat.$white, boomerang.$theme)
-);
-
-// More base styles, components, and component tokens
-@use '@carbon/react/scss/fonts';
-@use '@carbon/react/scss/grid';
-@use '@carbon/react/scss/layer';
-@use '@carbon/react/scss/zone';
-@use '@carbon/react/scss/components/button/tokens' as button;
-@use '@carbon/react/scss/components/notification/tokens' as notification;
-@use '@carbon/react/scss/components/tag/tokens' as tag;
-@use '@carbon/react/scss/components';
-
-// Addons library with boomerang enabled
-@use '@boomerang-io/carbon-addons-boomerang-react/scss/global' with ($use-theme-boomerang: true);
-
-// Finally include the theme to include all of the css custom properties
-[data-carbon-theme="boomerang"] {
-  @include theme.add-component-tokens(map.merge(button.$button-tokens, boomerang.$v11-button-tokens));
-  @include theme.add-component-tokens(notification.$notification-tokens);
-  @include theme.add-component-tokens(tag.$tag-tokens);
-  @include theme.theme();
-}
-```
-
-## Step 2 - Set HTML property
-
-You need to set the `data-carbon-theme="boomerang"` attribute value in your app, at the highest level in the document tree as possible.
-
-```html
-<html lang="en" data-carbon-theme="boomerang">
-  ...
-</html>
-```
-
-## Use
-
-After you have the styles configured, you can then import components as you'd expect.
-
-```js
-import { UIShell } from "@boomerang-io/carbon-addons-boomerang-react";
-```
-
-> Note: In v3 of the component library we have removed the re-exporting of all of the Carbon components.
-
-### Integrating with UIShell Notifications
-
-We use [react-toastify](https://github.com/fkhadra/react-toastify) to create notifications for UIShell events. If you are using the UIShell and want to also use react-toastify in your app for own notifications, you need to configure your `ToastContainer` component to support [multiple containers](https://fkhadra.github.io/react-toastify/multi-containers/#multi-containers-support) via the `enableMultiContainer` prop. It is _NOT_ required to include a `containerId` on your container or with notifications that you create. Without multi-container support enabled, you will see two notifications created for UIShell events.
-
-## 🛟 Version 2 LTS
-
-Because of the potential time and difficulty involved in a migration to Carbon v11, we will maintain a maintenance v2 of the component library that is compatible with Carbon v10 for a period of time. It will recieve critical functionality and security updates. The code is found on the [v2 branch](https://github.com/boomerang-io/carbon-addons-boomerang-react/tree/v2) and is published under the `2.x.x` semantic version and `classic` tag.
-
-Please view the support table below.
-
-## Support Schedule
-
-| Release | Status          | End-of-life |
-| ------- | --------------- | ----------- |
-| v1      | **End-of-Life** | 2022-03-18  |
-| v2      | **Maintenance** | 2023-04-30  |
-| v3      | **End-of-Life** | 2023-01-16  |
-| v4      | **Current**     | TBD         |
-
-## 📚 Docs
-
-You can find more information about how to use each component by checking out our [Storybook](https://carbon-addons-boomerang-react.netlify.app/).
-
-## 🤲 Contributing
-
-Please check out our [Contribution Guidelines](./.github/CONTRIBUTING.md) for more info on how you can help out!
-
-## 🚀 Release History
-
-View [all releases](https://github.com/boomerang-io/carbon-addons-boomerang-react/releases)
+# Carbon Addons Boomerang React [![Netlify Status](https://api.netlify.com/api/v1/badges/ebf40744-c9a5-4c91-a43d-e885b7e2da88/deploy-status)](https://app.netlify.com/sites/carbon-addons-boomerang-react/deploys)
+
+[Carbon](https://www.carbondesignsystem.com/) addon components for Boomerang written in React. View the [Storybook](https://carbon-addons-boomerang-react.netlify.app/).
+
+## Installing
+
+Install the the addons package, carbon and all of the required peer-dependencies.
+
+Run the following command using [pnpm](https://pnpm.io). Other package managers like `npm` and `yarn` work as well.
+
+```bash
+pnpm install @carbon/react @boomerang-io/carbon-addons-boomerang-react axios@0.27.2 formik react-router-dom@5 yup
+```
+
+Upgrading from a previous version? View our [migration guide](/docs/v4-migration.md).
+
+## Styles
+
+You need to use Sass, as we are built on top of Carbon and import the entry style sheet for the components. We recommend using `sass` or `sass-embedded` to compile styles. Configure as required for the bundler you are using. Tools like Vite and Create React App work without additional configuration needed.
+
+```scss
+// app.scss
+@use "@carbon/react";
+@use "@boomerang-io/carbon-addons-boomerang-react/scss/global";
+```
+
+Import this file in the JavaScript code to ensure that it is included in your bundle.
+
+## Carbon themes
+
+We recommend using Carbon theme functionality and the associated CSS custom properties in your styles to easily use Carbon theme tokens. See the following example for guidance on a couple common use cases.
+
+### Default theme
+
+```scss
+// styles.scss
+@use "@carbon/react";
+@use '@carbon/themes';
+@use "@boomerang-io/carbon-addons-boomerang-react/scss/global";
+
+// Include theme tokens
+:root {
+  @include themes.theme();
+}
+```
+
+### Gray 10 theme
+
+This is how we import things in our applications. We use a number of Carbon v10 tokens so we use the compatibility g10 theme from Carbon to support both new and old values. We also use Akamai as the host for our fonts instead of self-hosting via the `$use-akamai-cdn: true` argument to the `@carbon/react` import. View the Carbon docs to see all the arguments you can pass to customize how you use Carbon
+
+```scss
+@use "@carbon/react" with (
+  $use-akamai-cdn: true
+);
+@use "@carbon/themes";
+@use "@carbon/react/scss/compat/themes" as compat;
+@use "@boomerang-io/carbon-addons-boomerang-react/scss/global";
+
+:root {
+  @include themes.theme(compat.$g10);
+}
+```
+
+> Note: The library does not currently support changing the default class prefix from `cds`.
+
+## Boomerang theme
+
+Do you want to continue using the Boomerang theme? Follow the steps below.
+
+## Step 1 - Import styles
+
+Import the individual Carbon packages and addons styles as follows:
+
+```scss
+// app.scss
+@use "sass:map";
+
+// Carbon base styles and utilities
+@use '@carbon/react/scss/config' with ($use-akamai-cdn: true);
+@use '@carbon/react/scss/reset';
+@use '@carbon/react/scss/motion';
+@use '@carbon/react/scss/type';
+
+// Themes
+@use "@boomerang-io/carbon-addons-boomerang-react/scss/global/themes/boomerang";
+@use '@carbon/react/scss/compat/themes' as compat;
+@use '@carbon/react/scss/compat/theme' with (
+  $theme: map.merge(compat.$white, boomerang.$theme)
+);
+
+// More base styles, components, and component tokens
+@use '@carbon/react/scss/fonts';
+@use '@carbon/react/scss/grid';
+@use '@carbon/react/scss/layer';
+@use '@carbon/react/scss/zone';
+@use '@carbon/react/scss/components/button/tokens' as button;
+@use '@carbon/react/scss/components/notification/tokens' as notification;
+@use '@carbon/react/scss/components/tag/tokens' as tag;
+@use '@carbon/react/scss/components';
+
+// Addons library with boomerang enabled
+@use '@boomerang-io/carbon-addons-boomerang-react/scss/global' with ($use-theme-boomerang: true);
+
+// Finally include the theme to include all of the css custom properties
+[data-carbon-theme="boomerang"] {
+  @include theme.add-component-tokens(map.merge(button.$button-tokens, boomerang.$v11-button-tokens));
+  @include theme.add-component-tokens(notification.$notification-tokens);
+  @include theme.add-component-tokens(tag.$tag-tokens);
+  @include theme.theme();
+}
+```
+
+## Step 2 - Set HTML property
+
+You need to set the `data-carbon-theme="boomerang"` attribute value in your app, at the highest level in the document tree as possible.
+
+```html
+<html lang="en" data-carbon-theme="boomerang">
+  ...
+</html>
+```
+
+## Use
+
+After you have the styles configured, you can then import components as you'd expect.
+
+```js
+import { UIShell } from "@boomerang-io/carbon-addons-boomerang-react";
+```
+
+> Note: In v3 of the component library we have removed the re-exporting of all of the Carbon components.
+
+### Integrating with UIShell Notifications
+
+We use [react-toastify](https://github.com/fkhadra/react-toastify) to create notifications for UIShell events. If you are using the UIShell and want to also use react-toastify in your app for own notifications, you need to configure your `ToastContainer` component to support [multiple containers](https://fkhadra.github.io/react-toastify/multi-containers/#multi-containers-support) via the `enableMultiContainer` prop. It is _NOT_ required to include a `containerId` on your container or with notifications that you create. Without multi-container support enabled, you will see two notifications created for UIShell events.
+
+## 🛟 Version 2 LTS
+
+Because of the potential time and difficulty involved in a migration to Carbon v11, we will maintain a maintenance v2 of the component library that is compatible with Carbon v10 for a period of time. It will recieve critical functionality and security updates. The code is found on the [v2 branch](https://github.com/boomerang-io/carbon-addons-boomerang-react/tree/v2) and is published under the `2.x.x` semantic version and `classic` tag.
+
+Please view the support table below.
+
+## Support Schedule
+
+| Release | Status          | End-of-life |
+| ------- | --------------- | ----------- |
+| v1      | **End-of-Life** | 2022-03-18  |
+| v2      | **Maintenance** | 2023-04-30  |
+| v3      | **End-of-Life** | 2023-01-16  |
+| v4      | **Current**     | TBD         |
+
+## 📚 Docs
+
+You can find more information about how to use each component by checking out our [Storybook](https://carbon-addons-boomerang-react.netlify.app/).
+
+## 🤲 Contributing
+
+Please check out our [Contribution Guidelines](./.github/CONTRIBUTING.md) for more info on how you can help out!
+
+## 🚀 Release History
+
+View [all releases](https://github.com/boomerang-io/carbon-addons-boomerang-react/releases)

package/dist/cjs/_virtual/_commonjsHelpers.js

@@ -0,0 +1,5 @@
+'use strict';
+
+var commonjsGlobal = typeof globalThis !== 'undefined' ? globalThis : typeof window !== 'undefined' ? window : typeof global !== 'undefined' ? global : typeof self !== 'undefined' ? self : {};
+
+exports.commonjsGlobal = commonjsGlobal;

package/dist/cjs/_virtual/_nodeUtil.js

@@ -0,0 +1,9 @@
+'use strict';
+
+exports.exports = {};
+var _nodeUtil = {
+  get exports(){ return exports.exports; },
+  set exports(v){ exports.exports = v; },
+};
+
+exports.__module = _nodeUtil;

package/dist/cjs/_virtual/isBuffer.js

@@ -0,0 +1,9 @@
+'use strict';
+
+exports.exports = {};
+var isBuffer = {
+  get exports(){ return exports.exports; },
+  set exports(v){ exports.exports = v; },
+};
+
+exports.__module = isBuffer;

package/dist/cjs/node_modules/.pnpm/lodash@4.17.21/node_modules/lodash/_DataView.js

@@ -0,0 +1,16 @@
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+var _getNative = require('./_getNative.js');
+var _root = require('./_root.js');
+
+var getNative = _getNative.default,
+    root = _root.default;
+
+/* Built-in method references that are verified to be native. */
+var DataView = getNative(root, 'DataView');
+
+var _DataView = DataView;
+
+exports.default = _DataView;

package/dist/cjs/node_modules/.pnpm/lodash@4.17.21/node_modules/lodash/_Hash.js

@@ -0,0 +1,44 @@
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+var _hashClear = require('./_hashClear.js');
+var _hashDelete = require('./_hashDelete.js');
+var _hashGet = require('./_hashGet.js');
+var _hashHas = require('./_hashHas.js');
+var _hashSet = require('./_hashSet.js');
+
+var hashClear = _hashClear.default,
+    hashDelete = _hashDelete.default,
+    hashGet = _hashGet.default,
+    hashHas = _hashHas.default,
+    hashSet = _hashSet.default;
+
+/**
+ * Creates a hash object.
+ *
+ * @private
+ * @constructor
+ * @param {Array} [entries] The key-value pairs to cache.
+ */
+function Hash(entries) {
+  var index = -1,
+      length = entries == null ? 0 : entries.length;
+
+  this.clear();
+  while (++index < length) {
+    var entry = entries[index];
+    this.set(entry[0], entry[1]);
+  }
+}
+
+// Add methods to `Hash`.
+Hash.prototype.clear = hashClear;
+Hash.prototype['delete'] = hashDelete;
+Hash.prototype.get = hashGet;
+Hash.prototype.has = hashHas;
+Hash.prototype.set = hashSet;
+
+var _Hash = Hash;
+
+exports.default = _Hash;

package/dist/cjs/node_modules/.pnpm/lodash@4.17.21/node_modules/lodash/_ListCache.js

@@ -0,0 +1,44 @@
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+var _listCacheClear = require('./_listCacheClear.js');
+var _listCacheDelete = require('./_listCacheDelete.js');
+var _listCacheGet = require('./_listCacheGet.js');
+var _listCacheHas = require('./_listCacheHas.js');
+var _listCacheSet = require('./_listCacheSet.js');
+
+var listCacheClear = _listCacheClear.default,
+    listCacheDelete = _listCacheDelete.default,
+    listCacheGet = _listCacheGet.default,
+    listCacheHas = _listCacheHas.default,
+    listCacheSet = _listCacheSet.default;
+
+/**
+ * Creates an list cache object.
+ *
+ * @private
+ * @constructor
+ * @param {Array} [entries] The key-value pairs to cache.
+ */
+function ListCache(entries) {
+  var index = -1,
+      length = entries == null ? 0 : entries.length;
+
+  this.clear();
+  while (++index < length) {
+    var entry = entries[index];
+    this.set(entry[0], entry[1]);
+  }
+}
+
+// Add methods to `ListCache`.
+ListCache.prototype.clear = listCacheClear;
+ListCache.prototype['delete'] = listCacheDelete;
+ListCache.prototype.get = listCacheGet;
+ListCache.prototype.has = listCacheHas;
+ListCache.prototype.set = listCacheSet;
+
+var _ListCache = ListCache;
+
+exports.default = _ListCache;

package/dist/cjs/node_modules/.pnpm/lodash@4.17.21/node_modules/lodash/_Map.js

@@ -0,0 +1,16 @@
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+var _getNative = require('./_getNative.js');
+var _root = require('./_root.js');
+
+var getNative = _getNative.default,
+    root = _root.default;
+
+/* Built-in method references that are verified to be native. */
+var Map = getNative(root, 'Map');
+
+var _Map = Map;
+
+exports.default = _Map;

package/dist/cjs/node_modules/.pnpm/lodash@4.17.21/node_modules/lodash/_MapCache.js

@@ -0,0 +1,44 @@
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+var _mapCacheClear = require('./_mapCacheClear.js');
+var _mapCacheDelete = require('./_mapCacheDelete.js');
+var _mapCacheGet = require('./_mapCacheGet.js');
+var _mapCacheHas = require('./_mapCacheHas.js');
+var _mapCacheSet = require('./_mapCacheSet.js');
+
+var mapCacheClear = _mapCacheClear.default,
+    mapCacheDelete = _mapCacheDelete.default,
+    mapCacheGet = _mapCacheGet.default,
+    mapCacheHas = _mapCacheHas.default,
+    mapCacheSet = _mapCacheSet.default;
+
+/**
+ * Creates a map cache object to store key-value pairs.
+ *
+ * @private
+ * @constructor
+ * @param {Array} [entries] The key-value pairs to cache.
+ */
+function MapCache(entries) {
+  var index = -1,
+      length = entries == null ? 0 : entries.length;
+
+  this.clear();
+  while (++index < length) {
+    var entry = entries[index];
+    this.set(entry[0], entry[1]);
+  }
+}
+
+// Add methods to `MapCache`.
+MapCache.prototype.clear = mapCacheClear;
+MapCache.prototype['delete'] = mapCacheDelete;
+MapCache.prototype.get = mapCacheGet;
+MapCache.prototype.has = mapCacheHas;
+MapCache.prototype.set = mapCacheSet;
+
+var _MapCache = MapCache;
+
+exports.default = _MapCache;

package/dist/cjs/node_modules/.pnpm/lodash@4.17.21/node_modules/lodash/_Promise.js

@@ -0,0 +1,16 @@
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+var _getNative = require('./_getNative.js');
+var _root = require('./_root.js');
+
+var getNative = _getNative.default,
+    root = _root.default;
+
+/* Built-in method references that are verified to be native. */
+var Promise$1 = getNative(root, 'Promise');
+
+var _Promise = Promise$1;
+
+exports.default = _Promise;

package/dist/cjs/node_modules/.pnpm/lodash@4.17.21/node_modules/lodash/_Set.js

@@ -0,0 +1,16 @@
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+var _getNative = require('./_getNative.js');
+var _root = require('./_root.js');
+
+var getNative = _getNative.default,
+    root = _root.default;
+
+/* Built-in method references that are verified to be native. */
+var Set = getNative(root, 'Set');
+
+var _Set = Set;
+
+exports.default = _Set;

package/dist/cjs/node_modules/.pnpm/lodash@4.17.21/node_modules/lodash/_SetCache.js

@@ -0,0 +1,37 @@
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+var _MapCache = require('./_MapCache.js');
+var _setCacheAdd = require('./_setCacheAdd.js');
+var _setCacheHas = require('./_setCacheHas.js');
+
+var MapCache = _MapCache.default,
+    setCacheAdd = _setCacheAdd.default,
+    setCacheHas = _setCacheHas.default;
+
+/**
+ *
+ * Creates an array cache object to store unique values.
+ *
+ * @private
+ * @constructor
+ * @param {Array} [values] The values to cache.
+ */
+function SetCache(values) {
+  var index = -1,
+      length = values == null ? 0 : values.length;
+
+  this.__data__ = new MapCache;
+  while (++index < length) {
+    this.add(values[index]);
+  }
+}
+
+// Add methods to `SetCache`.
+SetCache.prototype.add = SetCache.prototype.push = setCacheAdd;
+SetCache.prototype.has = setCacheHas;
+
+var _SetCache = SetCache;
+
+exports.default = _SetCache;

package/dist/cjs/node_modules/.pnpm/lodash@4.17.21/node_modules/lodash/_Stack.js

@@ -0,0 +1,40 @@
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+var _ListCache = require('./_ListCache.js');
+var _stackClear = require('./_stackClear.js');
+var _stackDelete = require('./_stackDelete.js');
+var _stackGet = require('./_stackGet.js');
+var _stackHas = require('./_stackHas.js');
+var _stackSet = require('./_stackSet.js');
+
+var ListCache = _ListCache.default,
+    stackClear = _stackClear.default,
+    stackDelete = _stackDelete.default,
+    stackGet = _stackGet.default,
+    stackHas = _stackHas.default,
+    stackSet = _stackSet.default;
+
+/**
+ * Creates a stack cache object to store key-value pairs.
+ *
+ * @private
+ * @constructor
+ * @param {Array} [entries] The key-value pairs to cache.
+ */
+function Stack(entries) {
+  var data = this.__data__ = new ListCache(entries);
+  this.size = data.size;
+}
+
+// Add methods to `Stack`.
+Stack.prototype.clear = stackClear;
+Stack.prototype['delete'] = stackDelete;
+Stack.prototype.get = stackGet;
+Stack.prototype.has = stackHas;
+Stack.prototype.set = stackSet;
+
+var _Stack = Stack;
+
+exports.default = _Stack;

package/dist/cjs/node_modules/.pnpm/lodash@4.17.21/node_modules/lodash/_Symbol.js

@@ -0,0 +1,14 @@
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+var _root = require('./_root.js');
+
+var root = _root.default;
+
+/** Built-in value references. */
+var Symbol = root.Symbol;
+
+var _Symbol = Symbol;
+
+exports.default = _Symbol;

package/dist/cjs/node_modules/.pnpm/lodash@4.17.21/node_modules/lodash/_Uint8Array.js

@@ -0,0 +1,14 @@
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+var _root = require('./_root.js');
+
+var root = _root.default;
+
+/** Built-in value references. */
+var Uint8Array = root.Uint8Array;
+
+var _Uint8Array = Uint8Array;
+
+exports.default = _Uint8Array;