@carbon/ibm-products 2.89.0 → 2.90.0

package/es/components/PageHeader/PageHeader.js

@@ -25,7 +25,6 @@ import PropTypes from "prop-types";
 import { Button, Column, FlexGrid, Row, Tag, Tooltip, usePrefix } from "@carbon/react";
 import { ChevronUp } from "@carbon/react/icons";
 import { baseFontSize, breakpoints, spacing } from "@carbon/layout";
-
 //#region src/components/PageHeader/PageHeader.tsx
 var import_classnames = /* @__PURE__ */ __toESM(require_classnames());
 const componentName = "PageHeader";
@@ -402,13 +401,27 @@ const tagTypes = Object.keys({
 	outline: "Outline"
 });
 const deprecatedProps = {
+	/**
+	* **Deprecated**
+	* see property `enableBreadcrumbScroll`
+	*/
 	disableBreadcrumbScroll: deprecateProp(PropTypes.bool, "Property replaced by `enableBreadcrumbScroll`"),
+	/**
+	* **Deprecated** see property `withoutBackground`
+	*/
 	hasBackgroundAlways: deprecateProp(PropTypes.bool, "Property replaced by `withoutBackground`")
 };
 /**@ts-ignore */
 PageHeader.tagTypes = tagTypes;
 PageHeader.propTypes = {
+	/**
+	* Specifies the action bar items which are the final items in the row top of the PageHeader.
+	* Each item is specified as an object with the properties of a Carbon Button in icon only form.
+	* Button kind, size, tooltipPosition, tooltipAlignment and type are ignored.
+	*/
+	/**@ts-ignore */
 	actionBarItems: PropTypes.arrayOf(PropTypes.shape({
+		/**@ts-ignore*/
 		...prepareProps(Button.propTypes, [
 			"kind",
 			"size",
@@ -416,54 +429,253 @@ PageHeader.propTypes = {
 			"tooltipAlignment"
 		]),
 		iconDescription: PropTypes.string.isRequired,
+		/**@ts-ignore*/
 		onClick: Button.propTypes.onClick,
+		/**@ts-ignore*/
 		renderIcon: Button.propTypes.renderIcon.isRequired
 	})),
+	/**
+	* class name applied to the action bar overflow options
+	*/
 	actionBarMenuOptionsClass: PropTypes.string,
+	/**
+	* When there is insufficient space for all actionBarItems to be displayed this
+	* aria label is used for the action bar overflow menu
+	*
+	* NOTE: This prop is required if actionBarItems are supplied
+	*/
+	/**@ts-ignore */
 	actionBarOverflowAriaLabel: PropTypes.string,
+	/**
+	* When tags are supplied there may not be sufficient space to display all of the tags. This results in an overflow
+	* menu being shown. If in the overflow menu there is still insufficient space this label is used in a dialog showing
+	* all tags.
+	*
+	* **Note: Required if more than 10 tags**
+	*/
 	allTagsModalSearchLabel: PropTypes.string,
+	/**
+	* When tags are supplied there may not be sufficient space to display all of the tags. This results in an overflow
+	* menu being shown. If in the overflow menu there is still insufficient space this placeholder is used in a dialog
+	* showing all tags.
+	*
+	* **Note: Required if more than 10 tags**
+	*/
 	allTagsModalSearchPlaceholderText: PropTypes.string,
+	/**
+	* When tags are supplied there may not be sufficient space to display all of the tags. This results in an overflow
+	* menu being shown. If in the overflow menu there is still insufficient space this title is used in a dialog showing
+	* all tags.
+	*
+	* **Note: Required if more than 10 tags**
+	*/
 	allTagsModalTitle: PropTypes.string,
+	/**
+	* If the user supplies breadcrumbs then this property is required.
+	* It is used in an overflow menu when there is insufficient space to display all breadcrumbs inline.
+	*/
+	/**@ts-ignore */
 	breadcrumbOverflowAriaLabel: PropTypes.string,
+	/**
+	* align breadcrumb overflow tooltip
+	*/
 	breadcrumbOverflowTooltipAlign: Tooltip.propTypes.align,
+	/**
+	* Specifies the breadcrumb components to be shown in the breadcrumb area of
+	* the page header. Each item is specified as an object with optional fields
+	* 'label' to supply the breadcrumb label, 'href' to supply the link location,
+	* and 'isCurrentPage' to specify whether this breadcrumb component represents
+	* the current page. Each item should also include a unique 'key' field to
+	* enable efficient rendering, and if the label is not a string then a 'title'
+	* field is required to provide a text alternative for display. Any other
+	* fields in the object will be passed through to the breadcrumb element as
+	* HTML attributes.
+	*/
+	/**@ts-ignore */
 	breadcrumbs: PropTypes.arrayOf(PropTypes.shape({
+		/**
+		* Optional string representing the link location for the BreadcrumbItem
+		*/
 		href: PropTypes.string,
+		/**
+		* Provide if this breadcrumb item represents the current page
+		*/
 		isCurrentPage: PropTypes.bool,
+		/**
+		* Key required to render array efficiently
+		*/
 		key: PropTypes.string.isRequired,
+		/**
+		* Pass in content that will be inside of the BreadcrumbItem
+		*/
 		label: PropTypes.node,
+		/**
+		* A text version of the `label` for display, required if `label` is not a string.
+		*/
+		/**@ts-ignore */
 		title: PropTypes.string
 	})),
+	/**
+	* A zone for placing high-level, client content above the page tabs.
+	* Accepts arbitrary renderable content as a React node. Optional.
+	*/
 	children: PropTypes.node,
+	/**
+	* Specifies class(es) to be applied to the top-level PageHeader node.
+	* Optional.
+	*/
 	className: PropTypes.string,
+	/**
+	* The header can as a whole be collapsed, expanded or somewhere in between.
+	* This setting controls the initial value, but also takes effect on change
+	*
+	* NOTE: The header is collapsed by setting the scroll position to hide part of the header.
+	* Collapsing has no effect if there is insufficient content to scroll.
+	*/
 	collapseHeader: PropTypes.bool,
+	/**
+	* If `hasCollapseHeaderToggle` is set and `withoutBackground` is unset/falsy then assistive text is
+	* required for both the expend and collapse states of the button component used.
+	*/
+	/**@ts-ignore */
 	collapseHeaderIconDescription: PropTypes.string,
+	/**
+	* The title row typically starts below the breadcrumb row. This option
+	* preCollapses it into the breadcrumb row.
+	*/
 	collapseTitle: PropTypes.bool,
+	/**
+	* Standard keeps the breadcrumb on the page. This option allows the breadcrumb
+	* to scroll off
+	*/
 	enableBreadcrumbScroll: PropTypes.bool,
+	/**
+	* If `hasCollapseHeaderToggle` is set and `withoutBackground` is unset/falsy then assistive text is
+	* required for both the expend and collapse states of the button component used.
+	*/
+	/**@ts-ignore */
 	expandHeaderIconDescription: PropTypes.string,
+	/**
+	* The PageHeader is hosted in a Carbon grid, this value is passed through to the Carbon grid fullWidth prop.
+	* 'xl' is used to override the grid width setting. Can be used with narrowGrid: true to get the largest size.
+	*/
+	/**@ts-ignore */
 	fullWidthGrid: PropTypes.oneOfType([PropTypes.bool, PropTypes.oneOf(["xl"])]),
+	/**
+	* Adds a button as the last element of the bottom row which collapses and expands the header.
+	*
+	* NOTE: The header is collapsed by setting the scroll position to hide part of the header.
+	* Collapsing has no effect if there is insufficient content to scroll.
+	*/
+	/**@ts-ignore */
 	hasCollapseHeaderToggle: PropTypes.bool,
+	/**
+	* The PageHeader is hosted in a Carbon grid, this value is passed through to the Carbon grid narrow prop
+	*/
 	narrowGrid: PropTypes.bool,
+	/**
+	* Content for the navigation area in the PageHeader. Should
+	* be a React element that is normally a Carbon Tabs component. Optional.
+	*/
 	navigation: PropTypes.element,
+	/**
+	* Specifies the primary page actions which are placed at the same level in the page as the title.
+	*
+	* Either a set of actions, each specified as an object with the properties of a Carbon Button plus:
+	*
+	* - label: node
+	*
+	* Or a single object
+	*
+	* - content: content to be rendered. NOTE: must be capable of restricting itself to the space provided. This 2.5rem height ($spacing-08)
+	* and the width not used by action bar items when scrolled into toolbar.
+	* - minWidth: smallest number of pixel width the content would like. NOTE: This is not guaranteed and may be less on small viewports.
+	* - maxWidth: maximum number of pixels the content will grow to
+	* Carbon Button API https://react.carbondesignsystem.com/?path=/docs/components-button--default#component-api
+	*/
+	/**@ts-ignore */
 	pageActions: PropTypes.oneOfType([PropTypes.arrayOf(PropTypes.shape({
+		/**@ts-ignore*/
 		...Button.propTypes,
 		key: PropTypes.string.isRequired,
+		/**@ts-ignore*/
 		kind: Button.propTypes.kind,
 		label: PropTypes.node,
 		onClick: PropTypes.func
 	})), PropTypes.shape({
+		/**
+		* minWidth should not be more than 180
+		* The content is expected to adjust itself to fit in
+		*/
 		content: PropTypes.node.isRequired,
 		minWidth: PropTypes.number.isRequired,
 		maxWidth: PropTypes.number.isRequired
 	})]),
+	/**
+	* class name applied to the page actions overflow options
+	*/
 	pageActionsMenuOptionsClass: PropTypes.string,
+	/**
+	* When there is insufficient space to display all of hte page actions inline a dropdown button menu is shown,
+	* containing the page actions. This label is used as the display content of the dropdown button menu.
+	*
+	* NOTE: This prop is required if pageActions are supplied
+	*/
+	/**@ts-ignore */
 	pageActionsOverflowLabel: PropTypes.node,
+	/**
+	* When tags are supplied there may not be sufficient space to display all of the tags. This results in an overflow
+	* menu being shown. If in the overflow menu there is still insufficient space this label is used to offer a
+	* "View all tags" option.
+	*
+	* **Note: Required if more than 10 tags**
+	*/
 	showAllTagsLabel: PropTypes.string,
+	/**
+	* Sitting just below the title is this optional subtitle that provides additional context to
+	* identify the current page.
+	*/
 	subtitle: PropTypes.node,
+	/**
+	* An array of tags to be shown as the final content in the PageHeader.
+	*
+	* Each tag is specified as an object with the following properties
+	* **label**\* (required) to supply the tag content, and properties of the the Carbon Tag component,
+	* such as **type**, **disabled**, **ref**, **className** , and any other Tag props.
+	*
+	* NOTE: **filter** is not supported. Any remaining fields in the object will be passed through to the HTML element
+	* as HTML attributes.
+	*
+	* See https://react.carbondesignsystem.com/?path=/docs/components-tag--default
+	*/
+	/**@ts-ignore */
 	tags: PropTypes.arrayOf(PropTypes.shape({
 		...prepareProps(Tag.propTypes, "filter"),
 		label: PropTypes.string.isRequired,
 		type: PropTypes.oneOf(tagTypes)
 	})),
+	/**
+	* An optional page title supplied as a string or object with the following attributes: text, icon, loading
+	*
+	* Can be supplied either as:
+	* - String
+	* - Object containing
+	*    - text: title string
+	*    - shortTitle: alternative title for exceptionally long titles
+	*    - icon: optional icon
+	*    - loading: boolean shows loading indicator if true
+	*    - onChange: function to process the live value (React change === HTML Input)
+	*    - onSave: function to process a confirmed change
+	*    - editableLabel: label for edit required if onChange supplied
+	*    - cancelDescription: label for edit cancel button
+	*    - saveDescription: label for edit save button
+	*    - tooltipAlignment: position for tooltip displayed for large titles. Default to "bottom".
+	* - Object containing user defined contents. These must fit within the area defined for the title in both main part of the header and the breadcrumb.
+	*    - content: title or name of current location shown in main part of page header
+	*    - breadcrumbContent: version of content used in the breadcrumb on scroll. If not supplied
+	*    - asText: String based representation of the title
+	*/
+	/**@ts-ignore */
 	title: PropTypes.oneOfType([
 		PropTypes.shape({
 			text: PropTypes.string.isRequired,
@@ -496,10 +708,14 @@ PageHeader.propTypes = {
 			asText: PropTypes.string.isRequired
 		})
 	]),
+	/**
+	* Specifies if the PageHeader should appear without a background color, and defaults to the preferred `false` (a background color is shown).
+	* Note that when `true` some parts of the header still gain a background if and when they stick to the top of the PageHeader on scroll.
+	*/
+	/**@ts-ignore */
 	withoutBackground: PropTypes.bool,
 	...deprecatedProps
 };
 PageHeader.displayName = componentName;
-
 //#endregion
-export { PageHeader };
+export { PageHeader };

package/es/components/PageHeader/PageHeaderTitle.js

@@ -12,7 +12,6 @@ import { useOverflowStringWidth } from "../../global/js/hooks/useOverflowString.
 import React, { useRef } from "react";
 import PropTypes from "prop-types";
 import { DefinitionTooltip, SkeletonText } from "@carbon/react";
-
 //#region src/components/PageHeader/PageHeaderTitle.jsx
 /**
 * Copyright IBM Corp. 2024, 2025
@@ -71,7 +70,30 @@ const PageHeaderTitle = ({ blockClass, hasBreadcrumbRow, title }) => {
 };
 PageHeaderTitle.propTypes = {
 	blockClass: PropTypes.string.isRequired,
+	/**
+	* controlled from within page header
+	*/
 	hasBreadcrumbRow: PropTypes.bool,
+	/**
+	* An optional page title supplied as a string or object with the following attributes: text, icon, loading
+	*
+	* Can be supplied either as:
+	* - String
+	* - Object containing
+	*    - text: title string
+	*    - icon: optional icon
+	*    - loading: boolean shows loading indicator if true
+	*    - onChange: function to process the live value (React change === HTML Input)
+	*    - onSave: function to process a confirmed change
+	*    - editDescription: description for edit button
+	*    - editableLabel: label for edit required if onSave supplied
+	*    - cancelDescription: description for edit cancel button
+	*    - saveDescription: description for edit save button
+	* - Object containing user defined contents. These must fit within the area defined for the title in both main part of the header and the breadcrumb.
+	*    - content: title or name of current location shown in main part of page header
+	*    - breadcrumbContent: version of content used in the breadcrumb on scroll. If not supplied
+	*    - asText: String based representation of the title
+	*/
 	title: PropTypes.oneOfType([
 		PropTypes.shape({
 			text: PropTypes.string.isRequired,
@@ -103,6 +125,5 @@ PageHeaderTitle.propTypes = {
 		})
 	])
 };
-
 //#endregion
-export { PageHeaderTitle };
+export { PageHeaderTitle };

package/es/components/PageHeader/PageHeaderUtils.js

@@ -11,7 +11,6 @@ import { pkg } from "../../settings.js";
 import { scrollableAncestor } from "../../global/js/utils/scrollableAncestor.js";
 import React from "react";
 import { SkeletonText } from "@carbon/react";
-
 //#region src/components/PageHeader/PageHeaderUtils.jsx
 /**
 * Copyright IBM Corp. 2020, 2023
@@ -137,6 +136,5 @@ const utilGetBreadcrumbItemForTitle = (blockClass, collapseTitle, title) => {
 		return breadcrumbTitle;
 	}
 };
-
 //#endregion
-export { blockClass, utilCheckUpdateVerticalSpace, utilGetBreadcrumbItemForTitle, utilSetCollapsed };
+export { blockClass, utilCheckUpdateVerticalSpace, utilGetBreadcrumbItemForTitle, utilSetCollapsed };

package/es/components/PageHeader/next/PageHeader.d.ts

@@ -66,11 +66,12 @@ declare const ContentText: {
     };
 };
 declare const HeroImage: {
-    ({ className, children, ...other }: PageHeaderHeroImageProps): React.JSX.Element;
+    ({ className, children, objectFit, ...other }: PageHeaderHeroImageProps): React.JSX.Element;
     displayName: string;
     propTypes: {
         children: import("prop-types").Requireable<import("prop-types").ReactNodeLike>;
         className: import("prop-types").Requireable<string>;
+        objectFit: import("prop-types").Requireable<string>;
     };
 };
 declare const TabBar: React.ForwardRefExoticComponent<PageHeaderTabBarProps & React.RefAttributes<HTMLDivElement>>;

package/es/components/PageHeader/next/PageHeader.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"PageHeader.d.ts","sourceRoot":"","sources":["../../../../src/components/PageHeader/next/PageHeader.tsx"],"names":[],"mappings":"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"}
+{"version":3,"file":"PageHeader.d.ts","sourceRoot":"","sources":["../../../../src/components/PageHeader/next/PageHeader.tsx"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAA0D,MAAM,OAAO,CAAC;AAS/E,OAAO,EACL,uBAAuB,EACvB,KAAK,4BAA4B,EAClC,MAAM,2BAA2B,CAAC;AACnC,OAAO,EACL,iBAAiB,EACjB,KAAK,sBAAsB,EAC5B,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,4BAA4B,EAC5B,KAAK,iCAAiC,EACvC,MAAM,gCAAgC,CAAC;AACxC,OAAO,EACL,qBAAqB,EACrB,KAAK,0BAA0B,EAChC,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACL,mBAAmB,EACnB,KAAK,wBAAwB,EAC9B,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACL,gBAAgB,EAChB,KAAK,qBAAqB,EAC3B,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,qBAAqB,EACrB,KAAK,0BAA0B,EAChC,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACL,sBAAsB,EACtB,KAAK,2BAA2B,EACjC,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,yBAAyB,EAAE,MAAM,6BAA6B,CAAC;AACxE,OAAO,EACL,4BAA4B,EAC5B,KAAK,iCAAiC,EACvC,MAAM,gCAAgC,CAAC;AACxC,OAAO,EACL,+BAA+B,EAC/B,KAAK,oCAAoC,EACzC,KAAK,kCAAkC,EACxC,MAAM,mCAAmC,CAAC;AAE3C;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC3B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;OAEG;IACH,uBAAuB,CAAC,EAAE,CAAC,SAAS,EAAE,OAAO,KAAK,IAAI,CAAC;IACvD;;OAEG;IACH,cAAc,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,CAAC;IAC5C;;OAEG;IACH,uBAAuB,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,CAAC;CACtD;AAED,QAAA,MAAM,UAAU,wFAgLf,CAAC;AAGF;;;;GAIG;AACH,QAAA,MAAM,IAAI,wFAAa,CAAC;AAGxB,QAAA,MAAM,aAAa,qGAA0B,CAAC;AAG9C,QAAA,MAAM,OAAO,+FAAoB,CAAC;AAGlC,QAAA,MAAM,kBAAkB;;;;;;;;;CAA+B,CAAC;AAGxD,QAAA,MAAM,WAAW;;;;;;;;CAAwB,CAAC;AAG1C,QAAA,MAAM,SAAS;;;;;;;;CAAsB,CAAC;AAGtC,QAAA,MAAM,MAAM,8FAAmB,CAAC;AAGhC,QAAA,MAAM,YAAY,oGAAyB,CAAC;AAG5C,QAAA,MAAM,eAAe,mHAA4B,CAAC;AAGlD,QAAA,MAAM,kBAAkB,uGAA+B,CAAC;AAGxD,QAAA,MAAM,WAAW,mGAAwB,CAAC;AAG1C,QAAA,MAAM,qBAAqB;;;;;;;;;;;;;;;CAAkC,CAAC;AAG9D,OAAO,EAEL,UAAU,EACV,uBAAuB,EACvB,iBAAiB,EACjB,4BAA4B,EAC5B,qBAAqB,EACrB,mBAAmB,EACnB,gBAAgB,EAChB,sBAAsB,EACtB,yBAAyB,EACzB,4BAA4B,EAC5B,qBAAqB,EACrB,+BAA+B,EAE/B,IAAI,EACJ,aAAa,EACb,OAAO,EACP,kBAAkB,EAClB,WAAW,EACX,SAAS,EACT,MAAM,EACN,YAAY,EACZ,eAAe,EACf,kBAAkB,EAClB,WAAW,EACX,qBAAqB,GACtB,CAAC;AACF,YAAY,EACV,4BAA4B,EAC5B,sBAAsB,EACtB,iCAAiC,EACjC,0BAA0B,EAC1B,wBAAwB,EACxB,qBAAqB,EACrB,2BAA2B,EAC3B,0BAA0B,EAC1B,iCAAiC,EACjC,oCAAoC,EACpC,kCAAkC,GACnC,CAAC"}

package/es/components/PageHeader/next/PageHeader.js

@@ -24,7 +24,6 @@ import { PageHeaderTitleBreadcrumb } from "./PageHeaderTitleBreadcrumb.js";
 import { PageHeaderBreadcrumbOverflow } from "./PageHeaderBreadcrumbOverflow.js";
 import { PageHeaderBreadcrumbPageActions } from "./PageHeaderBreadcrumbPageActions.js";
 import React, { useEffect, useMemo, useRef, useState } from "react";
-
 //#region src/components/PageHeader/next/PageHeader.tsx
 /**
 * Copyright IBM Corp. 2025, 2026
@@ -164,6 +163,5 @@ const TagOverflow = PageHeaderTagOverflow;
 TagOverflow.displayName = "PageHeaderTagOverflow";
 const BreadcrumbPageActions = PageHeaderBreadcrumbPageActions;
 BreadcrumbPageActions.displayName = "PageHeaderBreadcrumbPageActions";
-
 //#endregion
-export { BreadcrumbBar, BreadcrumbOverflow, BreadcrumbPageActions, Content, ContentPageActions, ContentText, HeroImage, PageHeader, Root, ScrollButton, TabBar, TagOverflow, TitleBreadcrumb };
+export { BreadcrumbBar, BreadcrumbOverflow, BreadcrumbPageActions, Content, ContentPageActions, ContentText, HeroImage, PageHeader, Root, ScrollButton, TabBar, TagOverflow, TitleBreadcrumb };

package/es/components/PageHeader/next/PageHeaderBreadcrumbBar.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"PageHeaderBreadcrumbBar.d.ts","sourceRoot":"","sources":["../../../../src/components/PageHeader/next/PageHeaderBreadcrumbBar.tsx"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,EAAE,KAAK,aAAa,EAAE,KAAK,iBAAiB,EAAE,MAAM,OAAO,CAAC;AAI1E,OAAO,EAGL,KAAK,uBAAuB,EAC7B,MAAM,WAAW,CAAC;AAEnB;;;;GAIG;AACH,MAAM,WAAW,4BAA4B;IAC3C;;OAEG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC3B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;OAEG;IACH,UAAU,CAAC,EAAE,aAAa,GAAG,iBAAiB,CAAC;IAC/C;;;OAGG;IACH,cAAc,CAAC,EACX,KAAK,CAAC,SAAS,GACf,CAAC,CAAC,KAAK,EAAE,uBAAuB,KAAK,KAAK,CAAC,SAAS,CAAC,CAAC;IAC1D;;OAEG;IACH,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B;;;OAGG;IACH,WAAW,CAAC,EACR,KAAK,CAAC,SAAS,GACf,CAAC,CAAC,KAAK,EAAE,uBAAuB,KAAK,KAAK,CAAC,SAAS,CAAC,CAAC;IAC1D;;OAEG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED,eAAO,MAAM,uBAAuB,qGAmFlC,CAAC"}
+{"version":3,"file":"PageHeaderBreadcrumbBar.d.ts","sourceRoot":"","sources":["../../../../src/components/PageHeader/next/PageHeaderBreadcrumbBar.tsx"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,EAAE,KAAK,aAAa,EAAE,KAAK,iBAAiB,EAAE,MAAM,OAAO,CAAC;AAI1E,OAAO,EAGL,KAAK,uBAAuB,EAC7B,MAAM,WAAW,CAAC;AAEnB;;;;GAIG;AACH,MAAM,WAAW,4BAA4B;IAC3C;;OAEG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC3B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;OAEG;IACH,UAAU,CAAC,EAAE,aAAa,GAAG,iBAAiB,CAAC;IAC/C;;;OAGG;IACH,cAAc,CAAC,EACX,KAAK,CAAC,SAAS,GACf,CAAC,CAAC,KAAK,EAAE,uBAAuB,KAAK,KAAK,CAAC,SAAS,CAAC,CAAC;IAC1D;;OAEG;IACH,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B;;;OAGG;IACH,WAAW,CAAC,EACR,KAAK,CAAC,SAAS,GACf,CAAC,CAAC,KAAK,EAAE,uBAAuB,KAAK,KAAK,CAAC,SAAS,CAAC,CAAC;IAC1D;;OAEG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED,eAAO,MAAM,uBAAuB,qGA0ElC,CAAC"}

package/es/components/PageHeader/next/PageHeaderBreadcrumbBar.js

@@ -11,7 +11,6 @@ import { blockClass } from "../PageHeaderUtils.js";
 import { PageHeaderContext, usePageHeader } from "./context.js";
 import React from "react";
 import { Column, Grid } from "@carbon/react";
-
 //#region src/components/PageHeader/next/PageHeaderBreadcrumbBar.tsx
 /**
 * Copyright IBM Corp. 2026
@@ -28,14 +27,12 @@ const PageHeaderBreadcrumbBar = React.forwardRef(function PageHeaderBreadcrumbBa
 		[`${blockClass}__breadcrumb-bar-border`]: border,
 		[`${blockClass}__breadcrumb__actions-flush`]: pageActionsFlush
 	}, className);
-	const resolvedContentActions = typeof contentActions === "function" ? contentActions(observerState) : contentActions;
 	const isFunctionalContentActions = typeof contentActions === "function";
 	const contentActionsClasses = (0, import_classnames.default)({
 		[`${blockClass}__breadcrumb__content-actions`]: !contentActionsFlush,
 		[`${blockClass}__breadcrumb__content-actions-with-global-actions`]: !!globalActions,
 		[`${blockClass}__breadcrumb__content-actions-with-global-actions--show`]: observerState.contentActionsClipped || isFunctionalContentActions
 	});
-	const resolvedPageActions = typeof pageActions === "function" ? pageActions(observerState) : pageActions;
 	return /* @__PURE__ */ React.createElement(PageHeaderContext.Provider, { value: {
 		...context,
 		isContentActionsInBreadcrumbBar: true,
@@ -48,9 +45,8 @@ const PageHeaderBreadcrumbBar = React.forwardRef(function PageHeaderBreadcrumbBa
 		lg: 16,
 		md: 8,
 		sm: 4
-	}, /* @__PURE__ */ React.createElement("div", { className: `${blockClass}__breadcrumb-container` }, /* @__PURE__ */ React.createElement("div", { className: `${blockClass}__breadcrumb-wrapper` }, IconElement && /* @__PURE__ */ React.createElement("div", { className: `${blockClass}__breadcrumb__icon` }, /* @__PURE__ */ React.createElement(IconElement, null)), children), /* @__PURE__ */ React.createElement("div", { className: `${blockClass}__breadcrumb__actions` }, /* @__PURE__ */ React.createElement("div", { className: contentActionsClasses }, resolvedContentActions), resolvedPageActions))))));
+	}, /* @__PURE__ */ React.createElement("div", { className: `${blockClass}__breadcrumb-container` }, /* @__PURE__ */ React.createElement("div", { className: `${blockClass}__breadcrumb-wrapper` }, IconElement && /* @__PURE__ */ React.createElement("div", { className: `${blockClass}__breadcrumb__icon` }, /* @__PURE__ */ React.createElement(IconElement, null)), children), /* @__PURE__ */ React.createElement("div", { className: `${blockClass}__breadcrumb__actions` }, /* @__PURE__ */ React.createElement("div", { className: contentActionsClasses }, typeof contentActions === "function" ? contentActions(observerState) : contentActions), typeof pageActions === "function" ? pageActions(observerState) : pageActions))))));
 });
 PageHeaderBreadcrumbBar.displayName = "PageHeaderBreadcrumbBar";
-
 //#endregion
-export { PageHeaderBreadcrumbBar };
+export { PageHeaderBreadcrumbBar };

package/es/components/PageHeader/next/PageHeaderBreadcrumbOverflow.js

@@ -12,7 +12,6 @@ import { createOverflowHandler } from "./overflowHandler.js";
 import { PageHeaderTitleBreadcrumb } from "./PageHeaderTitleBreadcrumb.js";
 import React, { forwardRef, useEffect, useRef } from "react";
 import { Breadcrumb, BreadcrumbItem, usePrefix } from "@carbon/react";
-
 //#region src/components/PageHeader/next/PageHeaderBreadcrumbOverflow.tsx
 /**
 * Copyright IBM Corp. 2026
@@ -61,6 +60,5 @@ const PageHeaderBreadcrumbOverflow = forwardRef(({ renderOverflowBreadcrumb, cla
 	}, renderChildren());
 });
 PageHeaderBreadcrumbOverflow.displayName = "PageHeaderBreadcrumbOverflow";
-
 //#endregion
-export { PageHeaderBreadcrumbOverflow };
+export { PageHeaderBreadcrumbOverflow };

package/es/components/PageHeader/next/PageHeaderBreadcrumbPageActions.js

@@ -12,7 +12,6 @@ import React, { useEffect, useRef, useState } from "react";
 import PropTypes from "prop-types";
 import { Button, FeatureFlags, OverflowMenu, OverflowMenuItem } from "@carbon/react";
 import { createOverflowHandler } from "@carbon/utilities";
-
 //#region src/components/PageHeader/next/PageHeaderBreadcrumbPageActions.tsx
 /**
 * Copyright IBM Corp. 2026
@@ -72,12 +71,18 @@ const PageHeaderBreadcrumbPageActions = ({ actions, className, overflowMenuLabel
 };
 PageHeaderBreadcrumbPageActions.displayName = "PageHeaderBreadcrumbPageActions";
 PageHeaderBreadcrumbPageActions.propTypes = {
+	/**
+	* Array of action items to display
+	*/
 	actions: PropTypes.arrayOf(PropTypes.shape({
 		id: PropTypes.string.isRequired,
 		label: PropTypes.string.isRequired,
 		renderIcon: PropTypes.elementType.isRequired,
 		onClick: PropTypes.func
 	}).isRequired).isRequired,
+	/**
+	* Kind of the action buttons
+	*/
 	buttonKind: PropTypes.oneOf([
 		"primary",
 		"secondary",
@@ -87,14 +92,22 @@ PageHeaderBreadcrumbPageActions.propTypes = {
 		"danger--tertiary",
 		"danger--ghost"
 	]),
+	/**
+	* Size of the action buttons
+	*/
 	buttonSize: PropTypes.oneOf([
 		"sm",
 		"md",
 		"lg"
 	]),
+	/**
+	* Specify an optional className to be added to the component
+	*/
 	className: PropTypes.string,
+	/**
+	* Aria label for the overflow menu
+	*/
 	overflowMenuLabel: PropTypes.string
 };
-
 //#endregion
-export { PageHeaderBreadcrumbPageActions };
+export { PageHeaderBreadcrumbPageActions };

package/es/components/PageHeader/next/PageHeaderContent.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"PageHeaderContent.d.ts","sourceRoot":"","sources":["../../../../src/components/PageHeader/next/PageHeaderContent.tsx"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,EACZ,KAAK,aAAa,EAClB,KAAK,iBAAiB,EAMvB,MAAM,OAAO,CAAC;AAaf,OAAO,EAAiB,KAAK,uBAAuB,EAAE,MAAM,WAAW,CAAC;AAExE;;;;GAIG;AACH,MAAM,WAAW,sBAAsB;IACrC;;OAEG;IACH,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC3B;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;OAEG;IACH,UAAU,CAAC,EAAE,aAAa,GAAG,iBAAiB,CAAC;IAC/C;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;IACd;;OAEG;IACH,iBAAiB,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IACpC;;;OAGG;IACH,WAAW,CAAC,EACR,KAAK,CAAC,SAAS,GACf,CAAC,CAAC,KAAK,EAAE,uBAAuB,KAAK,KAAK,CAAC,SAAS,CAAC,CAAC;CAC3D;AAED,eAAO,MAAM,iBAAiB,+FA2G5B,CAAC"}
+{"version":3,"file":"PageHeaderContent.d.ts","sourceRoot":"","sources":["../../../../src/components/PageHeader/next/PageHeaderContent.tsx"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,EACZ,KAAK,aAAa,EAClB,KAAK,iBAAiB,EAKvB,MAAM,OAAO,CAAC;AAaf,OAAO,EAAiB,KAAK,uBAAuB,EAAE,MAAM,WAAW,CAAC;AAExE;;;;GAIG;AACH,MAAM,WAAW,sBAAsB;IACrC;;OAEG;IACH,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC3B;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;OAEG;IACH,UAAU,CAAC,EAAE,aAAa,GAAG,iBAAiB,CAAC;IAC/C;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;IACd;;OAEG;IACH,iBAAiB,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IACpC;;;OAGG;IACH,WAAW,CAAC,EACR,KAAK,CAAC,SAAS,GACf,CAAC,CAAC,KAAK,EAAE,uBAAuB,KAAK,KAAK,CAAC,SAAS,CAAC,CAAC;CAC3D;AAED,eAAO,MAAM,iBAAiB,+FAyG5B,CAAC"}

package/es/components/PageHeader/next/PageHeaderContent.js

@@ -10,10 +10,9 @@ import { require_classnames } from "../../../node_modules/classnames/index.js";
 import { useIsomorphicEffect } from "../../../global/js/hooks/useIsomorphicEffect.js";
 import { blockClass } from "../PageHeaderUtils.js";
 import { usePageHeader } from "./context.js";
-import React, { useEffect, useMemo, useRef, useState } from "react";
+import React, { useEffect, useRef, useState } from "react";
 import PropTypes from "prop-types";
 import { Column, DefinitionTooltip, Grid, Heading, Section, unstable_Text } from "@carbon/react";
-
 //#region src/components/PageHeader/next/PageHeaderContent.tsx
 /**
 * Copyright IBM Corp. 2026
@@ -25,10 +24,9 @@ var import_classnames = /* @__PURE__ */ __toESM(require_classnames());
 const PageHeaderContent = React.forwardRef(function PageHeaderContent({ className, children, title, renderIcon: IconElement, contextualActions, pageActions, ...other }, ref) {
 	const contentRef = useRef(null);
 	const componentRef = ref ?? contentRef;
-	const { setRefs, setPageActionsInstance, observerState } = usePageHeader();
+	const { setRefs, setPageActionsInstance } = usePageHeader();
 	const classNames = (0, import_classnames.default)({ [`${blockClass}__content`]: true }, className);
 	const titleRef = useRef(null);
-	const resolvedPageActions = useMemo(() => typeof pageActions === "function" ? pageActions(observerState) : pageActions, [pageActions, observerState]);
 	useEffect(() => {
 		if (componentRef?.current) setRefs((prev) => ({
 			...prev,
@@ -37,8 +35,9 @@ const PageHeaderContent = React.forwardRef(function PageHeaderContent({ classNam
 		}));
 	}, []);
 	useEffect(() => {
-		if (resolvedPageActions) setPageActionsInstance(resolvedPageActions);
-	}, [resolvedPageActions]);
+		if (typeof pageActions === "function") setPageActionsInstance(() => pageActions);
+		else setPageActionsInstance(pageActions ?? null);
+	}, [pageActions]);
 	const [isEllipsisApplied, setIsEllipsisApplied] = useState(false);
 	const isEllipsisActive = (element) => {
 		setIsEllipsisApplied(element.offsetHeight < element.scrollHeight);
@@ -64,18 +63,42 @@ const PageHeaderContent = React.forwardRef(function PageHeaderContent({ classNam
 		ref: titleRef,
 		as: Heading,
 		className: `${blockClass}__content__title`
-	}, title)), contextualActions && /* @__PURE__ */ React.createElement("div", { className: `${blockClass}__content__contextual-actions` }, contextualActions)), resolvedPageActions), children)));
+	}, title)), contextualActions && /* @__PURE__ */ React.createElement("div", { className: `${blockClass}__content__contextual-actions` }, contextualActions)), typeof pageActions === "function" ? pageActions({
+		fullyCollapsed: false,
+		titleClipped: false,
+		contentActionsClipped: false
+	}) : pageActions), children)));
 });
 PageHeaderContent.displayName = "PageHeaderContent";
 PageHeaderContent.propTypes = {
+	/**
+	* Provide child elements to be rendered inside PageHeaderContent.
+	*/
 	children: PropTypes.node,
+	/**
+	* Specify an optional className to be added to your PageHeaderContent
+	*/
 	className: PropTypes.string,
+	/**
+	* The PageHeaderContent's contextual actions
+	*/
 	contextualActions: PropTypes.node,
+	/**
+	* The PageHeaderContent's page actions
+	*/
 	pageActions: PropTypes.node,
+	/**
+	* Provide an optional icon to render in front of the PageHeaderContent's title.
+	*/
 	renderIcon: PropTypes.oneOfType([PropTypes.func, PropTypes.object]),
+	/**
+	* The PageHeaderContent's subtitle
+	*/
 	subtitle: PropTypes.string,
+	/**
+	* The PageHeaderContent's title
+	*/
 	title: PropTypes.string.isRequired
 };
-
 //#endregion
-export { PageHeaderContent };
+export { PageHeaderContent };

package/es/components/PageHeader/next/PageHeaderContentPageActions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"PageHeaderContentPageActions.d.ts","sourceRoot":"","sources":["../../../../src/components/PageHeader/next/PageHeaderContentPageActions.tsx"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAsC,MAAM,OAAO,CAAC;AAE3D,OAAO,SAAS,MAAM,YAAY,CAAC;AAOnC;;;;GAIG;AACH,MAAM,WAAW,iCAAiC;IAChD;;OAEG;IACH,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC3B;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;OAEG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB;;OAEG;IACH,OAAO,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;CAC3B;AAED,eAAO,MAAM,4BAA4B;kEAMtC,iCAAiC;;;QA8GlC;;WAEG;;QAEH;;WAEG;;QAEH;;WAEG;;QAEH;;WAEG;;;CAnBJ,CAAC"}
+{"version":3,"file":"PageHeaderContentPageActions.d.ts","sourceRoot":"","sources":["../../../../src/components/PageHeader/next/PageHeaderContentPageActions.tsx"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAsC,MAAM,OAAO,CAAC;AAE3D,OAAO,SAAS,MAAM,YAAY,CAAC;AAOnC;;;;GAIG;AACH,MAAM,WAAW,iCAAiC;IAChD;;OAEG;IACH,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC3B;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;OAEG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB;;OAEG;IACH,OAAO,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;CAC3B;AAED,eAAO,MAAM,4BAA4B;kEAMtC,iCAAiC;;;QAqHlC;;WAEG;;QAEH;;WAEG;;QAEH;;WAEG;;QAEH;;WAEG;;;CAnBJ,CAAC"}