@carbon/ibm-products 2.41.1-canary.5 → 2.41.1-canary.9

package/lib/components/FeatureFlags/index.js

@@ -0,0 +1,162 @@
+/**
+ * Copyright IBM Corp. 2020, 2024
+ *
+ * This source code is licensed under the Apache-2.0 license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+var _rollupPluginBabelHelpers = require('../../_virtual/_rollupPluginBabelHelpers.js');
+var React = require('react');
+var index = require('../../node_modules/prop-types/index.js');
+var FeatureFlags$1 = require('@carbon/feature-flags');
+
+function _interopDefaultLegacy (e) { return e && typeof e === 'object' && 'default' in e ? e : { 'default': e }; }
+
+var React__default = /*#__PURE__*/_interopDefaultLegacy(React);
+
+/**
+ * Our FeatureFlagContext is used alongside the FeatureFlags component to enable
+ * or disable feature flags in a given React tree
+ */
+var FeatureFlagContext = /*#__PURE__*/React.createContext(FeatureFlags$1.FeatureFlags);
+
+/**
+ * Supports an object of feature flag values with the `flags` prop, merging them
+ * along with the current `FeatureFlagContext` to provide consumers to check if
+ * a feature flag is enabled or disabled in a given React tree
+ */
+function FeatureFlags(_ref) {
+  var children = _ref.children,
+    _ref$flags = _ref.flags,
+    flags = _ref$flags === void 0 ? {} : _ref$flags;
+  var parentScope = React.useContext(FeatureFlagContext);
+  var _useState = React.useState(parentScope),
+    _useState2 = _rollupPluginBabelHelpers.slicedToArray(_useState, 2),
+    prevParentScope = _useState2[0],
+    setPrevParentScope = _useState2[1];
+  var _useState3 = React.useState(function () {
+      var scope = FeatureFlags$1.createScope(flags);
+      scope.mergeWithScope(parentScope);
+      return scope;
+    }),
+    _useState4 = _rollupPluginBabelHelpers.slicedToArray(_useState3, 2),
+    scope = _useState4[0],
+    updateScope = _useState4[1];
+  if (parentScope !== prevParentScope) {
+    var _scope = FeatureFlags$1.createScope(flags);
+    _scope.mergeWithScope(parentScope);
+    updateScope(_scope);
+    setPrevParentScope(parentScope);
+  }
+
+  // We use a custom hook to detect if any of the keys or their values change
+  // for flags that are passed in. If they have changed, then we re-create the
+  // FeatureFlagScope using the new flags
+  useChangedValue(flags, isEqual, function (changedFlags) {
+    var scope = FeatureFlags$1.createScope(changedFlags);
+    scope.mergeWithScope(parentScope);
+    updateScope(scope);
+  });
+  return /*#__PURE__*/React__default["default"].createElement(FeatureFlagContext.Provider, {
+    value: scope
+  }, children);
+}
+FeatureFlags.propTypes = {
+  children: index["default"].node,
+  /**
+   * Provide the feature flags to enabled or disabled in the current React tree
+   */
+  flags: index["default"].objectOf(index["default"].bool)
+};
+
+/**
+ * This hook will store previous versions of the given `value` and compare the
+ * current value to the previous one using the `compare` function. If the
+ * compare function returns true, then the given `callback` is invoked in an
+ * effect.
+ *
+ * @param {any} value
+ * @param {Function} compare
+ * @param {Function} callback
+ */
+function useChangedValue(value, compare, callback) {
+  var initialRender = React.useRef(false);
+  var savedCallback = React.useRef(callback);
+  var _useState5 = React.useState(value),
+    _useState6 = _rollupPluginBabelHelpers.slicedToArray(_useState5, 2),
+    prevValue = _useState6[0],
+    setPrevValue = _useState6[1];
+  if (!compare(prevValue, value)) {
+    setPrevValue(value);
+  }
+  React.useEffect(function () {
+    savedCallback.current = callback;
+  });
+  React.useEffect(function () {
+    // We only want the callback triggered after the first render
+    if (initialRender.current) {
+      savedCallback.current(prevValue);
+    }
+  }, [prevValue]);
+  React.useEffect(function () {
+    initialRender.current = true;
+  }, []);
+}
+
+/**
+ * Access whether a given flag is enabled or disabled in a given
+ * FeatureFlagContext
+ *
+ * @returns {boolean}
+ */
+function useFeatureFlag(flag) {
+  var scope = React.useContext(FeatureFlagContext);
+  // console.log(scope);
+  return scope.enabled(flag);
+}
+
+/**
+ * Access all feature flag information for the given FeatureFlagContext
+ *
+ * @returns {FeatureFlagScope}
+ */
+function useFeatureFlags() {
+  return React.useContext(FeatureFlagContext);
+}
+
+/**
+ * Compare two objects and determine if they are equal. This is a shallow
+ * comparison since the objects we are comparing are objects with boolean flags
+ * from the flags prop in the `FeatureFlags` component
+ *
+ * @param {object} a
+ * @param {object} b
+ * @returns {boolean}
+ */
+function isEqual(a, b) {
+  if (a === b) {
+    return true;
+  }
+  for (var _i = 0, _Object$keys = Object.keys(a); _i < _Object$keys.length; _i++) {
+    var key = _Object$keys[_i];
+    if (a[key] !== b[key]) {
+      return false;
+    }
+  }
+  for (var _i2 = 0, _Object$keys2 = Object.keys(b); _i2 < _Object$keys2.length; _i2++) {
+    var _key = _Object$keys2[_i2];
+    if (b[_key] !== a[_key]) {
+      return false;
+    }
+  }
+  return true;
+}
+
+exports.FeatureFlagContext = FeatureFlagContext;
+exports.FeatureFlags = FeatureFlags;
+exports.useFeatureFlag = useFeatureFlag;
+exports.useFeatureFlags = useFeatureFlags;

package/lib/components/ProductiveCard/ProductiveCard.d.ts

@@ -1,2 +1,115 @@
-export let ProductiveCard: React.ForwardRefExoticComponent<React.RefAttributes<any>>;
-import React from 'react';
+import React, { PropsWithChildren, ReactNode } from 'react';
+import { CarbonIconType } from '@carbon/icons-react/lib/CarbonIcon';
+type ActionIcon = {
+    id?: string;
+    icon?: CarbonIconType;
+    onKeyDown?(): void;
+    onClick?(): void;
+    iconDescription?: string;
+    href?: string;
+};
+type overflowAction = {
+    id?: string;
+    itemText?: string;
+    onClick?: () => void;
+    onKeydown?: () => void;
+};
+type PlacementType = 'top' | 'bottom';
+type ClickZoneType = 'one' | 'two' | 'three';
+interface ProductiveCardProps extends PropsWithChildren {
+    /**
+     * Icons that are displayed on card. Refer to design documentation for implementation guidelines. Note- href will supersede onClick
+     */
+    actionIcons?: ActionIcon[];
+    /**
+     * Determines if the action icons are on the top or bottom of the card
+     */
+    actionsPlacement?: PlacementType;
+    /**
+     * Content that shows in the body of the card
+     */
+    /**
+     * Optional user provided class
+     */
+    className?: string;
+    children: ReactNode;
+    /**
+     * Designates which zones of the card are clickable. Refer to design documentation for implementation guidelines
+     */
+    clickZone?: ClickZoneType;
+    /**
+     * Optional header description
+     */
+    description?: string | object | ReactNode;
+    /**
+     * Optional label for the top of the card
+     */
+    label?: string | object | ReactNode;
+    /**
+     * Provides the callback for a clickable card
+     */
+    onClick?: () => void;
+    /**
+     * Function that's called from the primary button or action icon
+     */
+    onPrimaryButtonClick?: () => void;
+    /**
+     * Function that's called from the secondary button
+     */
+    onSecondaryButtonClick?: () => void;
+    /**
+     * Use an overflow menu instead of action icons. Refer to design documentation for implementation guidelines
+     */
+    overflowActions?: overflowAction[];
+    /**
+     * Aria label prop required for OverflowMenu
+     */
+    overflowAriaLabel?: string;
+    /**
+     * Optionally specify an href for your Button to become an <a> element
+     */
+    primaryButtonHref?: string;
+    /**
+     * Optional prop to allow overriding the icon rendering. Can be a React component class
+     */
+    primaryButtonIcon?: CarbonIconType;
+    /**
+     * Determines if the primary button is on the top or bottom of the card
+     */
+    primaryButtonPlacement?: PlacementType;
+    /**
+     * The text that's displayed in the primary button
+     */
+    primaryButtonText?: string;
+    /**
+     * Optionally specify an href for your Button to become an <a> element
+     */
+    secondaryButtonHref?: string;
+    /**
+     * Optional prop to allow overriding the icon rendering. Can be a React component class
+     */
+    secondaryButtonIcon?: CarbonIconType;
+    /**
+     * Determines if the secondary button is on the top or bottom of the card
+     */
+    secondaryButtonPlacement?: PlacementType;
+    /**
+     * The text that's displayed in the secondary button
+     */
+    secondaryButtonText?: string;
+    /**
+     * **Experimental:** For all cases a `Slug` component can be provided.
+     * Clickable tiles only accept a boolean value of true and display a hollow slug.
+     */
+    slug?: ReactNode | boolean;
+    /**
+     * Title that's displayed at the top of the card
+     */
+    title?: string | object | ReactNode;
+    /**
+     * Determines title size
+     */
+    titleSize?: 'default' | 'large';
+}
+export declare let ProductiveCard: React.ForwardRefExoticComponent<ProductiveCardProps & React.RefAttributes<HTMLDivElement>>;
+export {};

package/lib/components/ProductiveCard/ProductiveCard.js

@@ -23,22 +23,16 @@ var React__default = /*#__PURE__*/_interopDefaultLegacy(React);
 
 var _excluded = ["actionsPlacement"];
 var componentName = 'ProductiveCard';
-
-// Default values for props
-var defaults = {
-  actionsPlacement: 'top'
-};
 exports.ProductiveCard = /*#__PURE__*/React.forwardRef(function (_ref, ref) {
   var _ref$actionsPlacement = _ref.actionsPlacement,
-    actionsPlacement = _ref$actionsPlacement === void 0 ? defaults.actionsPlacement : _ref$actionsPlacement,
+    actionsPlacement = _ref$actionsPlacement === void 0 ? 'top' : _ref$actionsPlacement,
     rest = _rollupPluginBabelHelpers.objectWithoutProperties(_ref, _excluded);
   var validProps = propsHelper.prepareProps(rest, ['media', 'mediaPosition', 'pictogram', 'primaryButtonClick', 'productive', 'secondaryButtonKind']);
   return /*#__PURE__*/React__default["default"].createElement(Card.Card, _rollupPluginBabelHelpers["extends"]({}, _rollupPluginBabelHelpers.objectSpread2(_rollupPluginBabelHelpers.objectSpread2({}, validProps), {}, {
     actionsPlacement: actionsPlacement,
-    ref: ref
-  }), {
+    ref: ref,
     productive: true
-  }, devtools.getDevtoolsProps(componentName)));
+  }), devtools.getDevtoolsProps(componentName)));
 });
 
 // Return a placeholder if not released and not enabled by feature flag
@@ -47,6 +41,7 @@ exports.ProductiveCard.propTypes = {
   /**
    * Icons that are displayed on card. Refer to design documentation for implementation guidelines
    */
+  /**@ts-ignore */
   actionIcons: index["default"].arrayOf(index["default"].shape({
     id: index["default"].string,
     icon: index["default"].oneOfType([index["default"].func, index["default"].object]),
@@ -94,6 +89,7 @@ exports.ProductiveCard.propTypes = {
   /**
    * Use an overflow menu instead of action icons. Refer to design documentation for implementation guidelines
    */
+  /**@ts-ignore */
   overflowActions: index["default"].arrayOf(index["default"].shape({
     id: index["default"].string,
     itemText: index["default"].string,
@@ -111,6 +107,7 @@ exports.ProductiveCard.propTypes = {
   /**
    * Optional prop to allow overriding the icon rendering. Can be a React component class
    */
+  /**@ts-ignore */
   primaryButtonIcon: index["default"].oneOfType([index["default"].func, index["default"].object]),
   /**
    * Determines if the primary button is on the top or bottom of the card
@@ -119,6 +116,7 @@ exports.ProductiveCard.propTypes = {
   /**
    * The text that's displayed in the primary button
    */
+  /**@ts-ignore */
   primaryButtonText: index["default"].node,
   /**
    * Optionally specify an href for your Button to become an <a> element
@@ -127,6 +125,7 @@ exports.ProductiveCard.propTypes = {
   /**
    * Optional prop to allow overriding the icon rendering. Can be a React component class
    */
+  /**@ts-ignore */
   secondaryButtonIcon: index["default"].oneOfType([index["default"].func, index["default"].object]),
   /**
    * Determines if the secondary button is on the top or bottom of the card
@@ -135,6 +134,7 @@ exports.ProductiveCard.propTypes = {
   /**
    * The text that's displayed in the secondary button
    */
+  /**@ts-ignore */
   secondaryButtonText: index["default"].node,
   /**
    * **Experimental:** For all cases a `Slug` component can be provided.

package/lib/components/index.d.ts

@@ -69,3 +69,4 @@ export { Guidebanner, GuidebannerElement, GuidebannerElementButton, GuidebannerE
 export { InlineTip, InlineTipButton, InlineTipLink } from "./InlineTip";
 export { DescriptionList, DescriptionListBody, DescriptionListCell, DescriptionListRow } from "./DescriptionList";
 export { FilterPanel, FilterPanelAccordion, FilterPanelAccordionItem, FilterPanelCheckbox, FilterPanelCheckboxWithOverflow, FilterPanelGroup, FilterPanelLabel, FilterPanelSearch } from "./FilterPanel";
+export { FeatureFlags as unstable_FeatureFlags, useFeatureFlag as unstable_useFeatureFlag, useFeatureFlags as unstable_useFeatureFlags } from "./FeatureFlags";

package/lib/feature-flags.d.ts

@@ -0,0 +1 @@
+export {};

package/lib/global/js/hooks/usePortalTarget.js

@@ -13,8 +13,10 @@ var _rollupPluginBabelHelpers = require('../../../_virtual/_rollupPluginBabelHel
 var React = require('react');
 var settings = require('../../../settings.js');
 var reactDom = require('react-dom');
+var index = require('../../../components/FeatureFlags/index.js');
 
 var usePortalTarget = function usePortalTarget(portalTargetIn) {
+  var enablePortalTarget = index.useFeatureFlag('default-portal-target-body');
   var _useState = React.useState(null),
     _useState2 = _rollupPluginBabelHelpers.slicedToArray(_useState, 2),
     portalTarget = _useState2[0],
@@ -23,11 +25,11 @@ var usePortalTarget = function usePortalTarget(portalTargetIn) {
     if (portalTargetIn) {
       setPortalTarget(portalTargetIn);
     } else {
-      if (settings.pkg.isFeatureEnabled('default-portal-target-body')) {
+      if (settings.pkg.isFeatureEnabled('default-portal-target-body') || enablePortalTarget) {
         setPortalTarget(document.body);
       }
     }
-  }, [portalTargetIn]);
+  }, [portalTargetIn, enablePortalTarget]);
   var renderPortalUse = React.useCallback(function (children) {
     return portalTarget ? /*#__PURE__*/reactDom.createPortal(children, portalTarget) : children;
   }, [portalTarget]);

package/lib/index.js

@@ -137,6 +137,7 @@ var FilterPanelLabel = require('./components/FilterPanel/FilterPanelLabel/Filter
 var FilterPanelSearch = require('./components/FilterPanel/FilterPanelSearch/FilterPanelSearch.js');
 var ConditionBuilder = require('./components/ConditionBuilder/ConditionBuilder.js');
 var GetStartedCard = require('./components/GetStartedCard/GetStartedCard.js');
+var index$2 = require('./components/FeatureFlags/index.js');
 
 
 
@@ -581,3 +582,6 @@ Object.defineProperty(exports, 'GetStartedCard', {
 	enumerable: true,
 	get: function () { return GetStartedCard.GetStartedCard; }
 });
+exports.unstable_FeatureFlags = index$2.FeatureFlags;
+exports.unstable_useFeatureFlag = index$2.useFeatureFlag;
+exports.unstable_useFeatureFlags = index$2.useFeatureFlags;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@carbon/ibm-products",
   "description": "Carbon for IBM Products",
-  "version": "2.41.1-canary.5+e4c6a2c8e",
+  "version": "2.41.1-canary.9+1a6cb2508",
   "license": "Apache-2.0",
   "main": "lib/index.js",
   "module": "es/index.js",
@@ -17,7 +17,10 @@
   "sideEffects": [
     "**/global/js/utils/props-helper.js",
     "**/*.css",
-    "**/*.scss"
+    "**/*.scss",
+    "es/feature-flags.js",
+    "lib/feature-flags.js",
+    "src/feature-flags.js"
   ],
   "files": [
     "css",
@@ -92,6 +95,7 @@
   },
   "dependencies": {
     "@babel/runtime": "^7.23.9",
+    "@carbon/feature-flags": "^0.20.0",
     "@carbon/ibm-products-styles": "^2.38.0",
     "@carbon/telemetry": "^0.1.0",
     "@dnd-kit/core": "^6.0.8",
@@ -116,5 +120,5 @@
     "react": "^16.8.6 || ^17.0.1 || ^18.2.0",
     "react-dom": "^16.8.6 || ^17.0.1 || ^18.2.0"
   },
-  "gitHead": "e4c6a2c8e8d42dd74abf2370331dde96c258de1c"
+  "gitHead": "1a6cb2508013be43018ba1a2a5325cf82b09e040"
 }

package/scss/components/Datagrid/styles/_useInlineEdit.scss

@@ -80,6 +80,12 @@ $row-heights: (
   align-items: center;
 }
 
+.#{variables.$block-class}__static--outer-cell {
+  display: flex;
+  height: -webkit-fill-available;
+  align-items: center;
+}
+
 .#{variables.$block-class}__inline-edit--outer-cell-button {
   width: 100%;
   height: calc(100% + 2px); // account for borders