@carbon/ibm-products 2.80.0 → 2.81.0-rc.0

package/lib/components/PageHeader/next/_story-assets/pageActionButtonItems.d.ts

@@ -1,15 +0,0 @@
-/**
- * Copyright IBM Corp. 2025, 2025
- *
- * 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 React from 'react';
-export declare const pageActionButtonItems: {
-    id: string;
-    onClick: () => void;
-    body: React.JSX.Element;
-    menuItem: {
-        label: string;
-    };
-}[];

package/lib/components/PageHeader/next/context.d.ts

@@ -1,29 +0,0 @@
-/**
- * Copyright IBM Corp. 2025, 2025
- *
- * 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 { RefObject } from 'react';
-/**
- * -------------
- * Context setup
- * -------------
- */
-export type PageHeaderRefs = {
-    contentRef?: RefObject<HTMLDivElement | null>;
-    titleRef?: RefObject<HTMLHeadingElement | null>;
-    contentActions?: RefObject<HTMLDivElement | null>;
-};
-type PageHeaderContextType = {
-    refs?: PageHeaderRefs;
-    setRefs: React.Dispatch<React.SetStateAction<PageHeaderRefs>>;
-    pageActionsInstance?: React.ReactNode;
-    setPageActionsInstance: React.Dispatch<React.SetStateAction<React.ReactNode>>;
-    fullyCollapsed?: boolean;
-    titleClipped?: boolean;
-    contentActionsClipped?: boolean;
-};
-export declare const PageHeaderContext: import("react").Context<PageHeaderContextType | undefined>;
-export declare function usePageHeader(): PageHeaderContextType;
-export {};

package/lib/components/PageHeader/next/context.js

@@ -1,36 +0,0 @@
-/**
- * Copyright IBM Corp. 2020, 2025
- *
- * 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';
-
-var React = require('react');
-
-/**
- * -------------
- * Context setup
- * -------------
- */
-
-const PageHeaderContext = /*#__PURE__*/React.createContext({
-  fullyCollapsed: false,
-  setRefs: () => {},
-  refs: {},
-  titleClipped: false,
-  contentActionsClipped: false,
-  pageActionsInstance: null,
-  setPageActionsInstance: () => {}
-});
-function usePageHeader() {
-  const context = React.useContext(PageHeaderContext);
-  if (!context) {
-    throw new Error('Page header context was not provided or hook was used outside of the Page header component.');
-  }
-  return context;
-}
-
-exports.PageHeaderContext = PageHeaderContext;
-exports.usePageHeader = usePageHeader;

package/lib/components/PageHeader/next/index.d.ts

@@ -1,8 +0,0 @@
-/**
- * Copyright IBM Corp. 2025, 2025
- *
- * This source code is licensed under the Apache-2.0 license found in the
- * LICENSE file in the root directory of this source tree.
- */
-export { PageHeader, PageHeaderBreadcrumbBar, PageHeaderContent, PageHeaderContentPageActions, PageHeaderContentText, PageHeaderTabBar, PageHeaderHeroImage, PageHeaderScrollButton, PageHeaderTitleBreadcrumb, PageHeaderBreadcrumbOverflow, PageHeaderTagOverflow, Root, BreadcrumbBar, Content, ContentPageActions, ContentText, TabBar, HeroImage, ScrollButton, TitleBreadcrumb, BreadcrumbOverflow, TagOverflow, } from './PageHeader';
-export type { PageHeaderProps, PageHeaderBreadcrumbBarProps, PageHeaderContentProps, PageHeaderContentPageActionsProps, PageHeaderContentTextProps, PageHeaderTabBarProps, PageHeaderHeroImageProps, PageHeaderScrollButtonProps, PageHeaderTagOverflowProps, } from './PageHeader';

package/lib/components/PageHeader/next/index.js

@@ -1,35 +0,0 @@
-/**
- * Copyright IBM Corp. 2020, 2025
- *
- * 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';
-
-var PageHeader = require('./PageHeader.js');
-
-
-
-exports.BreadcrumbBar = PageHeader.BreadcrumbBar;
-exports.BreadcrumbOverflow = PageHeader.BreadcrumbOverflow;
-exports.Content = PageHeader.Content;
-exports.ContentPageActions = PageHeader.ContentPageActions;
-exports.ContentText = PageHeader.ContentText;
-exports.HeroImage = PageHeader.HeroImage;
-exports.PageHeader = PageHeader.PageHeader;
-exports.PageHeaderBreadcrumbBar = PageHeader.PageHeaderBreadcrumbBar;
-exports.PageHeaderBreadcrumbOverflow = PageHeader.PageHeaderBreadcrumbOverflow;
-exports.PageHeaderContent = PageHeader.PageHeaderContent;
-exports.PageHeaderContentPageActions = PageHeader.PageHeaderContentPageActions;
-exports.PageHeaderContentText = PageHeader.PageHeaderContentText;
-exports.PageHeaderHeroImage = PageHeader.PageHeaderHeroImage;
-exports.PageHeaderScrollButton = PageHeader.PageHeaderScrollButton;
-exports.PageHeaderTabBar = PageHeader.PageHeaderTabBar;
-exports.PageHeaderTagOverflow = PageHeader.PageHeaderTagOverflow;
-exports.PageHeaderTitleBreadcrumb = PageHeader.PageHeaderTitleBreadcrumb;
-exports.Root = PageHeader.Root;
-exports.ScrollButton = PageHeader.ScrollButton;
-exports.TabBar = PageHeader.TabBar;
-exports.TagOverflow = PageHeader.TagOverflow;
-exports.TitleBreadcrumb = PageHeader.TitleBreadcrumb;

package/lib/components/PageHeader/next/overflowHandler.d.ts

@@ -1,100 +0,0 @@
-/**
- * Copyright IBM Corp. 2025
- *
- * This source code is licensed under the Apache-2.0 license found in the
- * LICENSE file in the root directory of this source tree.
- */
-/**
- * This file has test coverage in @carbon/utilities. This is a copy of the utility
- * that adds margin calculations to an element's size. This should ideally be
- * merged back into the utility.
- */
-/**
- * Calculates the size (width or height) of a given HTML element.
- *
- * This function performs an expensive calculation by temporarily changing the
- * display style of the element if it is not currently visible. It then uses
- * `getBoundingClientRect` to retrieve the size of the element.
- *
- * @param el - The HTML element whose size is to be calculated.
- * @param dimension - The dimension to measure ('width' or 'height').
- * @returns The size of the element in pixels. Returns 0 if the element is not provided.
- */
-export declare function getSize(el: HTMLElement, dimension: 'width' | 'height'): number;
-/**
- * Options for updating the overflow handler.
- * Determines which items should be visible and which should be hidden
- * based on the container size, item sizes, and other constraints.
- */
-export interface UpdateOverflowHandlerOptions {
-    /** The container element that holds the items. */
-    container: HTMLElement;
-    /** An array of item elements to be managed for overflow. */
-    items: HTMLElement[];
-    /** An element that represents the offset, which can be shown or hidden based on overflow. Identified by `data-offset` attribute. */
-    offset: HTMLElement;
-    /** An array of sizes corresponding to each item in the `items` array. */
-    sizes: number[];
-    /** An array of sizes corresponding to each item in the fixed items array. */
-    fixedSizes: number[];
-    /** The size of the offset element. */
-    offsetSize: number;
-    /** The maximum number of items that can be visible at once. If undefined, all items can be visible. */
-    maxVisibleItems?: number;
-    /** The dimension to consider for overflow, either 'width' or 'height'. */
-    dimension: 'width' | 'height';
-    /** A callback function that is called when the visible or hidden items change. */
-    onChange: (visibleItems: HTMLElement[], hiddenItems: HTMLElement[]) => void;
-    /** An array of previously hidden items to compare against the new hidden items. */
-    previousHiddenItems?: HTMLElement[];
-}
-/**
- * Updates the overflow handler by determining which items should be visible and which should be hidden.
- *
- * @param options - Configuration options for updating the overflow handler.
- * @param options.container - Container for overflowing
- * @param options.items - Child elements within container
- * @param options.offset - Children with data-offset attribute
- * @param options.sizes - Sizes of child elements
- * @param options.fixedSizes - Fixed sizes of child elements with data-fixed attribute
- * @param options.offsetSize - Total offset size
- * @param options.maxVisibleItems - Max visible items
- * @param options.dimension - width | height used to measure overflow
- * @param options.onChange - onChange callback
- * @param options.previousHiddenItems - Array of previously hidden items
- * @returns An array of hidden items after the update.
- */
-export declare function updateOverflowHandler({ container, items, offset, sizes, fixedSizes, offsetSize, maxVisibleItems, dimension, onChange, previousHiddenItems, }: UpdateOverflowHandlerOptions): HTMLElement[];
-/**
- * Options for initializing an overflow handler.
- */
-export interface OverflowHandlerOptions {
-    /**
-     * The container element that holds the items. along with offset item
-     */
-    container: HTMLElement;
-    /**
-     * Maximum number of visible items. If provided, only this number of items will be shown.
-     */
-    maxVisibleItems?: number;
-    /**
-     * Callback function invoked when the visible and hidden items change.
-     * @param visibleItems - The array of items that are currently visible.
-     * @param hiddenItems - The array of items that are currently hidden.
-     */
-    onChange: (visibleItems: HTMLElement[], hiddenItems: HTMLElement[]) => void;
-    /**
-     * The dimension to consider for overflow calculations. Defaults to 'width'.
-     */
-    dimension?: 'width' | 'height';
-}
-/**
- * Represents an instance of an overflow handler.
- */
-export interface OverflowHandler {
-    /**
-     * Disconnects the overflow handler, cleaning up any event listeners or resources.
-     */
-    disconnect: () => void;
-}
-export declare function createOverflowHandler({ container, maxVisibleItems, onChange, dimension, }: OverflowHandlerOptions): OverflowHandler;

package/lib/components/PageHeader/next/overflowHandler.js

@@ -1,174 +0,0 @@
-/**
- * Copyright IBM Corp. 2020, 2025
- *
- * 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';
-
-/**
- * This file has test coverage in @carbon/utilities. This is a copy of the utility
- * that adds margin calculations to an element's size. This should ideally be
- * merged back into the utility.
- */
-
-/* istanbul ignore file */
-
-/**
- * Calculates the size (width or height) of a given HTML element.
- *
- * This function performs an expensive calculation by temporarily changing the
- * display style of the element if it is not currently visible. It then uses
- * `getBoundingClientRect` to retrieve the size of the element.
- *
- * @param el - The HTML element whose size is to be calculated.
- * @param dimension - The dimension to measure ('width' or 'height').
- * @returns The size of the element in pixels. Returns 0 if the element is not provided.
- */
-function getSize(el, dimension) {
-  if (!el) {
-    return 0;
-  }
-  const originalDisplay = el.style.display;
-  if (!el.offsetParent && getComputedStyle(el).display === 'none') {
-    el.style.display = 'inline-block';
-  }
-  let size = el.getBoundingClientRect()[dimension];
-  el.style.display = originalDisplay;
-  const computedStyles = getComputedStyle(el);
-  size = dimension === 'width' ? size + parseInt(computedStyles.marginLeft) + parseInt(computedStyles.marginRight) : size + parseInt(computedStyles.marginTop) + parseInt(computedStyles.marginBottom);
-  return size;
-}
-
-/**
- * Options for updating the overflow handler.
- * Determines which items should be visible and which should be hidden
- * based on the container size, item sizes, and other constraints.
- */
-
-/**
- * Updates the overflow handler by determining which items should be visible and which should be hidden.
- *
- * @param options - Configuration options for updating the overflow handler.
- * @param options.container - Container for overflowing
- * @param options.items - Child elements within container
- * @param options.offset - Children with data-offset attribute
- * @param options.sizes - Sizes of child elements
- * @param options.fixedSizes - Fixed sizes of child elements with data-fixed attribute
- * @param options.offsetSize - Total offset size
- * @param options.maxVisibleItems - Max visible items
- * @param options.dimension - width | height used to measure overflow
- * @param options.onChange - onChange callback
- * @param options.previousHiddenItems - Array of previously hidden items
- * @returns An array of hidden items after the update.
- */
-function updateOverflowHandler(_ref) {
-  let {
-    container,
-    items,
-    offset,
-    sizes,
-    fixedSizes,
-    offsetSize,
-    maxVisibleItems,
-    dimension,
-    onChange,
-    previousHiddenItems = []
-  } = _ref;
-  const containerSize = dimension === 'width' ? container.clientWidth : container.clientHeight;
-  let visibleItems = [];
-  let hiddenItems = [];
-  const totalSize = sizes.reduce((sum, size) => sum + size, 0);
-  const totalFixedSize = fixedSizes.reduce((sum, size) => sum + size, 0);
-  if (totalSize + totalFixedSize <= containerSize) {
-    visibleItems = maxVisibleItems ? items.slice(0, maxVisibleItems) : [...items];
-    hiddenItems = maxVisibleItems ? items.slice(maxVisibleItems) : [];
-  } else {
-    const available = containerSize - offsetSize;
-    let accumulated = 0;
-    for (let i = 0; i < items.length; i++) {
-      const size = sizes[i];
-      if (accumulated + size + totalFixedSize <= available && (!maxVisibleItems || visibleItems.length < maxVisibleItems)) {
-        visibleItems.push(items[i]);
-        accumulated += size;
-      } else {
-        hiddenItems.push(items[i]);
-      }
-    }
-  }
-  if (previousHiddenItems.length === hiddenItems.length && previousHiddenItems.every((item, index) => item === hiddenItems[index])) {
-    return previousHiddenItems;
-  }
-  visibleItems.forEach(item => item.removeAttribute('data-hidden'));
-  hiddenItems.forEach(item => item.setAttribute('data-hidden', ''));
-  if (offset) {
-    offset.toggleAttribute('data-hidden', hiddenItems.length === 0);
-  }
-  onChange(visibleItems, hiddenItems);
-  return hiddenItems;
-}
-
-/**
- * Options for initializing an overflow handler.
- */
-
-/**
- * Represents an instance of an overflow handler.
- */
-
-function createOverflowHandler(_ref2) {
-  let {
-    container,
-    maxVisibleItems,
-    onChange,
-    dimension = 'width'
-  } = _ref2;
-  // Error handling
-  if (!(container instanceof HTMLElement)) {
-    throw new Error('container must be an HTMLElement');
-  }
-  if (typeof onChange !== 'function') {
-    throw new Error('onChange must be a function');
-  }
-  if (maxVisibleItems !== undefined && (!Number.isInteger(maxVisibleItems) || maxVisibleItems <= 0)) {
-    throw new Error('maxVisibleItems must be a positive integer');
-  }
-  const children = Array.from(container.children);
-  const offset = children.find(item => item.hasAttribute('data-offset'));
-  const fixedItems = children.filter(item => item.hasAttribute('data-fixed'));
-  const items = children.filter(item => item !== offset && !fixedItems.includes(item));
-  const fixedSizes = fixedItems.map(item => getSize(item, dimension));
-  const sizes = items.map(item => getSize(item, dimension));
-  const offsetSize = getSize(offset, dimension);
-  let previousHiddenItems = [];
-  function update() {
-    previousHiddenItems = updateOverflowHandler({
-      container,
-      items,
-      offset,
-      sizes,
-      fixedSizes,
-      offsetSize,
-      maxVisibleItems,
-      dimension,
-      onChange,
-      previousHiddenItems
-    });
-  }
-  const resizeObserver = new ResizeObserver(() => {
-    requestAnimationFrame(update);
-  });
-  resizeObserver.observe(container);
-  requestAnimationFrame(update); // Initial update
-
-  return {
-    disconnect() {
-      resizeObserver.disconnect();
-    }
-  };
-}
-
-exports.createOverflowHandler = createOverflowHandler;
-exports.getSize = getSize;
-exports.updateOverflowHandler = updateOverflowHandler;

package/lib/components/PageHeader/next/utils.d.ts

@@ -1,19 +0,0 @@
-/**
- * Copyright IBM Corp. 2025
- *
- * This source code is licensed under the Apache-2.0 license found in the
- * LICENSE file in the root directory of this source tree.
- */
-/**
- * ----------
- * Utilities
- * ----------
- */
-export declare const getHeaderOffset: (el: HTMLElement) => number;
-/**
- * Walks up the parent nodes to identify the first scrollable ancestor
- *
- * @param {HTMLElement} target
- * @returns {HTMLElement}
- */
-export declare const scrollableAncestor: (target: HTMLElement) => ParentNode | null;

package/lib/components/PageHeader/next/utils.js

@@ -1,71 +0,0 @@
-/**
- * Copyright IBM Corp. 2020, 2025
- *
- * 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';
-
-/**
- * ----------
- * Utilities
- * ----------
- */
-
-const getHeaderOffset = el => {
-  const scrollableContainer = scrollableAncestor(el);
-  const scrollableContainerTop = scrollableContainer ? scrollableContainer.getBoundingClientRect().top : 0;
-  const offsetMeasuringTop = el ? el.getBoundingClientRect().top : 0;
-  const totalHeaderOffset = offsetMeasuringTop !== 0 ? offsetMeasuringTop - scrollableContainerTop : 0;
-  return totalHeaderOffset;
-};
-const windowExists = typeof window !== `undefined`;
-
-/**
- * Determines if the given target is scrollable
- *
- * @param {HTMLElement} target
- * @returns {boolean}
- */
-const scrollable = target => {
-  const style = window.getComputedStyle(target);
-  return /(auto|scroll|hidden)/.test(style.overflow);
-};
-
-/**
- * Recursively looks for the scrollable ancestor
- */
-const scrollableAncestorInner = target => {
-  if (target.parentNode && target.parentNode !== document) {
-    if (scrollable(target.parentNode)) {
-      return target.parentNode;
-    } else {
-      return scrollableAncestorInner(target.parentNode);
-    }
-  } else {
-    return document.scrollingElement;
-  }
-};
-
-/**
- * Walks up the parent nodes to identify the first scrollable ancestor
- *
- * @param {HTMLElement} target
- * @returns {HTMLElement}
- */
-const scrollableAncestor = target => {
-  if (!windowExists || !target) {
-    return null;
-  }
-
-  // based on https://stackoverflow.com/questions/35939886/find-first-scrollable-parent
-  const style = window.getComputedStyle(target);
-  if (!target || !style || style.position === 'fixed') {
-    return document.scrollingElement;
-  }
-  return scrollableAncestorInner(target);
-};
-
-exports.getHeaderOffset = getHeaderOffset;
-exports.scrollableAncestor = scrollableAncestor;

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

@@ -1,125 +0,0 @@
-import React, { PropsWithChildren, ReactNode } from 'react';
-import { CarbonIconType } from '@carbon/icons-react/lib/CarbonIcon';
-import { ActionIcon } from '../Card/Card';
-type overflowAction = {
-    id?: string;
-    itemText?: string;
-    onClick?: (event: MouseEvent) => void;
-    onKeyDown?: (event: KeyboardEvent) => void;
-};
-type PlacementType = 'top' | 'bottom';
-type ClickZoneType = 'one' | 'two' | 'three';
-export interface ProductiveCardProps extends PropsWithChildren {
-    /**
-     * Icons that are displayed on the card. Refer to design documentation for implementation guidelines. Note: href is deprecated. Set link.href for href functionality. If you are setting link object, href is a required property. link object supports all anchor element properties. Precedence: link.href > href. If link.href or href is set => anchor element, else button.
-     */
-    actionIcons?: ActionIcon[];
-    /**
-     * Optional prop that allows you to pass any component.
-     */
-    decorator?: ReactNode | boolean;
-    /**
-     * Determines if the action icons are on the top or bottom of the card
-     */
-    actionsPlacement?: PlacementType;
-    /**
-     * Optional user provided class
-     */
-    className?: string;
-    /**
-     * 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?: (event: MouseEvent) => void;
-    /**
-     * Provides the callback for keydown events on the card
-     */
-    onKeyDown?: (event: KeyboardEvent) => 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[];
-    /**
-     * Sets the text for the OverflowMenu aria label and the OverflowMenu trigger button tooltip.
-     * Overrides `iconDescription` prop.
-     */
-    overflowAriaLabel?: string;
-    /**
-     * Determines if the primary button is enabled or not
-     */
-    primaryButtonDisabled?: boolean;
-    /**
-     * 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.
-     * @deprecated please use the `decorator` prop
-     */
-    slug?: ReactNode | boolean;
-    /**
-     * Title that's displayed at the top of the card
-     */
-    title?: string | object | ReactNode;
-    /**
-     * Determines title size
-     */
-    titleSize?: 'default' | 'large';
-    /**
-     * Sets the text for the OverflowMenu trigger button tooltip and OverflowMenu aria label,
-     * gets overridden by the `overflowAriaLabel` prop.
-     *
-     * @deprecated Please use the `overflowAriaLabel` prop instead.
-     */
-    iconDescription?: string;
-}
-export declare const ProductiveCard: React.ForwardRefExoticComponent<ProductiveCardProps & React.RefAttributes<HTMLDivElement>>;
-export {};