@carbon/ibm-products 2.89.0 → 2.90.0

package/lib/components/Coachmark/CoachmarkOverlay.js

@@ -5,22 +5,21 @@
  * LICENSE file in the root directory of this source tree.
  */
 
-const require_runtime = require('../../_virtual/_rolldown/runtime.js');
-const require_index = require('../../node_modules/classnames/index.js');
-const require_settings = require('../../settings.js');
-const require_useIsomorphicEffect = require('../../global/js/hooks/useIsomorphicEffect.js');
-const require_devtools = require('../../global/js/utils/devtools.js');
-const require_uuidv4 = require('../../global/js/utils/uuidv4.js');
-const require_enums = require('./utils/enums.js');
-const require_context = require('./utils/context.js');
-const require_CoachmarkDragbar = require('./CoachmarkDragbar.js');
-const require_CoachmarkHeader = require('./CoachmarkHeader.js');
-const require_constants = require('./utils/constants.js');
+const require_runtime = require("../../_virtual/_rolldown/runtime.js");
+const require_index = require("../../node_modules/classnames/index.js");
+const require_settings = require("../../settings.js");
+const require_useIsomorphicEffect = require("../../global/js/hooks/useIsomorphicEffect.js");
+const require_devtools = require("../../global/js/utils/devtools.js");
+const require_uuidv4 = require("../../global/js/utils/uuidv4.js");
+const require_enums = require("./utils/enums.js");
+const require_context = require("./utils/context.js");
+const require_CoachmarkDragbar = require("./CoachmarkDragbar.js");
+const require_CoachmarkHeader = require("./CoachmarkHeader.js");
+const require_constants = require("./utils/constants.js");
 let react = require("react");
 react = require_runtime.__toESM(react);
 let prop_types = require("prop-types");
 prop_types = require_runtime.__toESM(prop_types);
-
 //#region src/components/Coachmark/CoachmarkOverlay.tsx
 /**
 * Copyright IBM Corp. 2023, 2025
@@ -32,7 +31,7 @@ var import_classnames = /* @__PURE__ */ require_runtime.__toESM(require_index.de
 const blockClass = `${require_settings.pkg.prefix}--coachmark-overlay`;
 const componentName = "CoachmarkOverlay";
 const defaults = {
-	kind: require_enums.COACHMARK_OVERLAY_KIND.FLOATING,
+	kind: "floating",
 	theme: "light"
 };
 /**
@@ -46,8 +45,8 @@ const CoachmarkOverlay = (0, react.forwardRef)((props, ref) => {
 	const [a11yDragMode, setA11yDragMode] = (0, react.useState)(false);
 	const overlayRef = (0, react.useRef)(null);
 	const coachmark = require_context.useCoachmark();
-	const isBeacon = kind === require_enums.COACHMARK_OVERLAY_KIND.TOOLTIP;
-	const isDraggable = kind === require_enums.COACHMARK_OVERLAY_KIND.FLOATING;
+	const isBeacon = kind === "tooltip";
+	const isDraggable = kind === "floating";
 	const isVisible = className?.includes("is-visible");
 	const handleKeyPress = (event) => {
 		const { shiftKey, key } = event;
@@ -181,13 +180,32 @@ CoachmarkOverlay.deprecated = {
 };
 CoachmarkOverlay.displayName = componentName;
 CoachmarkOverlay.propTypes = {
+	/**
+	* The CoachmarkOverlayElements child components.
+	* Validation is handled in the parent Coachmark component.
+	*/
 	children: prop_types.default.node.isRequired,
+	/**
+	* Optional class name for this component.
+	*/
 	className: prop_types.default.string,
+	/**
+	* The visibility of CoachmarkOverlay is
+	* managed in the parent Coachmark component.
+	*/
 	fixedIsVisible: prop_types.default.bool.isRequired,
+	/**
+	* What kind or style of Coachmark to render.
+	*/
 	kind: prop_types.default.oneOf(Object.values(require_enums.COACHMARK_OVERLAY_KIND)),
+	/**
+	* Function to call when the Coachmark closes.
+	*/
 	onClose: prop_types.default.func.isRequired,
+	/**
+	* Determines the theme of the component.
+	*/
 	theme: prop_types.default.oneOf(["light", "dark"])
 };
-
 //#endregion
-exports.CoachmarkOverlay = CoachmarkOverlay;
+exports.CoachmarkOverlay = CoachmarkOverlay;

package/lib/components/Coachmark/CoachmarkTagline.js

@@ -5,18 +5,17 @@
  * LICENSE file in the root directory of this source tree.
  */
 
-const require_runtime = require('../../_virtual/_rolldown/runtime.js');
-const require_index = require('../../node_modules/classnames/index.js');
-const require_settings = require('../../settings.js');
-const require_devtools = require('../../global/js/utils/devtools.js');
-const require_context = require('./utils/context.js');
+const require_runtime = require("../../_virtual/_rolldown/runtime.js");
+const require_index = require("../../node_modules/classnames/index.js");
+const require_settings = require("../../settings.js");
+const require_devtools = require("../../global/js/utils/devtools.js");
+const require_context = require("./utils/context.js");
 let react = require("react");
 react = require_runtime.__toESM(react);
 let prop_types = require("prop-types");
 prop_types = require_runtime.__toESM(prop_types);
 let _carbon_react = require("@carbon/react");
 let _carbon_react_icons = require("@carbon/react/icons");
-
 //#region src/components/Coachmark/CoachmarkTagline.tsx
 /**
 * Copyright IBM Corp. 2023, 2025
@@ -67,11 +66,22 @@ CoachmarkTagline.deprecated = {
 };
 CoachmarkTagline.displayName = componentName;
 CoachmarkTagline.propTypes = {
+	/**
+	* Tooltip text and aria label for the Close button icon.
+	*/
 	closeIconDescription: prop_types.default.string,
+	/**
+	* Function to call when the close button is clicked.
+	*/
 	onClose: prop_types.default.func,
+	/**
+	* Determines the theme of the component.
+	*/
 	theme: prop_types.default.oneOf(["light", "dark"]),
+	/**
+	* The title of the tagline.
+	*/
 	title: prop_types.default.string.isRequired
 };
-
 //#endregion
-exports.CoachmarkTagline = CoachmarkTagline;
+exports.CoachmarkTagline = CoachmarkTagline;

package/lib/components/Coachmark/next/Coachmark/Coachmark.d.ts

@@ -4,7 +4,7 @@
  * 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 { FC, ForwardRefExoticComponent, ReactNode, RefAttributes } from 'react';
+import { FC, ForwardRefExoticComponent, ReactNode, RefAttributes, RefObject } from 'react';
 import { CoachmarkContentProps } from './CoachmarkContent';
 import { NewPopoverAlignment } from '@carbon/react';
 import { ContentHeaderProps } from './ContentHeader';
@@ -58,6 +58,10 @@ export interface CoachmarkPropsNext {
      * If not provided, no automatic focus management will occur.
      */
     selectorPrimaryFocus?: string;
+    /**
+     * Optional ref for an external trigger element, used when the trigger is not part of the coachmark.
+     */
+    triggerRef?: RefObject<HTMLElement>;
 }
 type CoachmarkContentComponent = FC<CoachmarkContentProps> & {
     Header: FC<ContentHeaderProps>;

package/lib/components/Coachmark/next/Coachmark/Coachmark.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Coachmark.d.ts","sourceRoot":"","sources":["../../../../../src/components/Coachmark/next/Coachmark/Coachmark.tsx"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAc,EACZ,EAAE,EACF,yBAAyB,EACzB,SAAS,EACT,aAAa,EAMd,MAAM,OAAO,CAAC;AAOf,OAAyB,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAC7E,OAAO,EAAW,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAE7D,OAAO,EAAiB,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AACpE,OAAO,EAAe,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAiB9D,MAAM,WAAW,kBAAkB;IACjC;;OAEG;IACH,QAAQ,EAAE,SAAS,CAAC;IAEpB;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;OAEG;IACH,IAAI,CAAC,EAAE,OAAO,CAAC;IACf;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IACrB;;OAEG;IACH,KAAK,CAAC,EAAE,mBAAmB,CAAC;IAC5B;;OAEG;IACH,QAAQ,CAAC,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACpC;;OAEG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB;;OAEG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB;;OAEG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB;;OAEG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB;;;OAGG;IACH,oBAAoB,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED,KAAK,yBAAyB,GAAG,EAAE,CAAC,qBAAqB,CAAC,GAAG;IAC3D,MAAM,EAAE,EAAE,CAAC,kBAAkB,CAAC,CAAC;IAC/B,IAAI,EAAE,EAAE,CAAC,gBAAgB,CAAC,CAAC;CAC5B,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG,yBAAyB,CACxD,kBAAkB,GAAG,aAAa,CAAC,cAAc,CAAC,CACnD,GAAG;IACF,OAAO,EAAE,yBAAyB,CAAC;CACpC,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,SAAS,EAuIjB,kBAAkB,CAAC"}
+{"version":3,"file":"Coachmark.d.ts","sourceRoot":"","sources":["../../../../../src/components/Coachmark/next/Coachmark/Coachmark.tsx"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAc,EACZ,EAAE,EACF,yBAAyB,EACzB,SAAS,EACT,aAAa,EACb,SAAS,EAKV,MAAM,OAAO,CAAC;AAOf,OAAyB,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAC7E,OAAO,EAAW,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAE7D,OAAO,EAAiB,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AACpE,OAAO,EAAe,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAiB9D,MAAM,WAAW,kBAAkB;IACjC;;OAEG;IACH,QAAQ,EAAE,SAAS,CAAC;IAEpB;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;OAEG;IACH,IAAI,CAAC,EAAE,OAAO,CAAC;IACf;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IACrB;;OAEG;IACH,KAAK,CAAC,EAAE,mBAAmB,CAAC;IAC5B;;OAEG;IACH,QAAQ,CAAC,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACpC;;OAEG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB;;OAEG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB;;OAEG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB;;OAEG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB;;;OAGG;IACH,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B;;OAEG;IACH,UAAU,CAAC,EAAE,SAAS,CAAC,WAAW,CAAC,CAAC;CACrC;AAED,KAAK,yBAAyB,GAAG,EAAE,CAAC,qBAAqB,CAAC,GAAG;IAC3D,MAAM,EAAE,EAAE,CAAC,kBAAkB,CAAC,CAAC;IAC/B,IAAI,EAAE,EAAE,CAAC,gBAAgB,CAAC,CAAC;CAC5B,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG,yBAAyB,CACxD,kBAAkB,GAAG,aAAa,CAAC,cAAc,CAAC,CACnD,GAAG;IACF,OAAO,EAAE,yBAAyB,CAAC;CACpC,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,SAAS,EAwJjB,kBAAkB,CAAC"}

package/lib/components/Coachmark/next/Coachmark/Coachmark.js

@@ -5,20 +5,19 @@
  * LICENSE file in the root directory of this source tree.
  */
 
-const require_runtime = require('../../../../_virtual/_rolldown/runtime.js');
-const require_index = require('../../../../node_modules/classnames/index.js');
-const require_useIsomorphicEffect = require('../../../../global/js/hooks/useIsomorphicEffect.js');
-const require_devtools = require('../../../../global/js/utils/devtools.js');
-const require_context = require('./context.js');
-const require_CoachmarkContent = require('./CoachmarkContent.js');
-const require_ContentHeader = require('./ContentHeader.js');
-const require_ContentBody = require('./ContentBody.js');
+const require_runtime = require("../../../../_virtual/_rolldown/runtime.js");
+const require_index = require("../../../../node_modules/classnames/index.js");
+const require_useIsomorphicEffect = require("../../../../global/js/hooks/useIsomorphicEffect.js");
+const require_devtools = require("../../../../global/js/utils/devtools.js");
+const require_context = require("./context.js");
+const require_CoachmarkContent = require("./CoachmarkContent.js");
+const require_ContentHeader = require("./ContentHeader.js");
+const require_ContentBody = require("./ContentBody.js");
 let react = require("react");
 react = require_runtime.__toESM(react);
 let prop_types = require("prop-types");
 prop_types = require_runtime.__toESM(prop_types);
 let _carbon_react = require("@carbon/react");
-
 //#region src/components/Coachmark/next/Coachmark/Coachmark.tsx
 /**
 * Copyright IBM Corp. 2024, 2025
@@ -37,8 +36,9 @@ const Coachmark = (0, react.forwardRef)((props, ref) => {
 	const { children, className, onClose, align = "bottom", open, position = {
 		x: 0,
 		y: 0
-	}, floating, dropShadow, highContrast, caret, selectorPrimaryFocus, ...rest } = props;
-	const triggerRef = (0, react.useRef)(null);
+	}, floating, dropShadow, highContrast, caret, selectorPrimaryFocus, triggerRef: triggerRefProp, ...rest } = props;
+	const internalTriggerRef = (0, react.useRef)(null);
+	const triggerRef = triggerRefProp ?? internalTriggerRef;
 	const internalRef = (0, react.useRef)(null);
 	const [contentRef, setContentRef] = (0, react.useState)(null);
 	const [openState, setOpenState] = (0, react.useState)(false);
@@ -49,15 +49,20 @@ const Coachmark = (0, react.forwardRef)((props, ref) => {
 	const currentOpen = open ?? openState;
 	const caretValue = caret !== void 0 ? caret : floating === true ? false : true;
 	(0, react.useEffect)(() => {
+		if (triggerRefProp?.current) return;
 		const container = internalRef.current;
 		if (!container) return;
 		const firstFocusable = Array.from(container.querySelectorAll("*")).find((el) => el.tabIndex >= 0 && !el.hasAttribute("disabled"));
 		if (firstFocusable) triggerRef.current = firstFocusable;
-	}, [children]);
+	}, [
+		children,
+		triggerRef,
+		triggerRefProp
+	]);
 	(0, react.useEffect)(() => {
 		const el = triggerRef.current;
 		if (el) el.setAttribute("aria-expanded", String(!!open));
-	}, [open]);
+	}, [open, triggerRef]);
 	(0, react.useEffect)(() => {
 		if (!open && contentRef && floating) {
 			contentRef.style.transform = "none";
@@ -107,28 +112,70 @@ const Coachmark = (0, react.forwardRef)((props, ref) => {
 		caret: caretValue,
 		highContrast: highContrast ?? true,
 		dropShadow
-	}, children)));
+	}, triggerRefProp?.current ? /* @__PURE__ */ react.default.createElement("span", {
+		"aria-hidden": "true",
+		style: { display: "contents" },
+		ref: (node) => {
+			if (node && triggerRefProp.current) node.replaceWith(triggerRefProp.current);
+		}
+	}) : null, children)));
 });
 Coachmark.Content = require_CoachmarkContent.default;
 Coachmark.Content.Header = require_ContentHeader.ContentHeader;
 Coachmark.Content.Body = require_ContentBody.default;
 Coachmark.displayName = componentName;
 Coachmark.propTypes = {
+	/**
+	* Where to render the Coachmark relative to its target.
+	*/
 	align: prop_types.default.string,
+	/**
+	* Specify whether a caret should be rendered on the popover. This is intended to use only for coachmark patterns.
+	*/
 	caret: prop_types.default.bool,
+	/**
+	* Provide the contents of the CoachmarkV2.
+	*/
 	children: prop_types.default.node.isRequired,
+	/**
+	* Provide an optional class to be applied to the containing node.
+	*/
 	className: prop_types.default.string,
+	/**
+	* Specify whether a drop shadow should be rendered on the popover.
+	*/
 	dropShadow: prop_types.default.bool,
+	/**
+	* Specifies whether the component is floating or not.
+	*/
 	floating: prop_types.default.bool,
+	/**
+	* Specify whether the component should be rendered on high-contrast.
+	*/
 	highContrast: prop_types.default.bool,
+	/**
+	* Function to call when the close button is clicked.
+	*/
 	onClose: prop_types.default.func,
+	/**
+	* Specifies whether the component is currently open.
+	*/
 	open: prop_types.default.bool,
+	/**
+	* Fine tune the position of the target in pixels. Applies only to Beacons.
+	*/
 	position: prop_types.default.shape({
 		x: prop_types.default.number,
 		y: prop_types.default.number
 	}),
-	selectorPrimaryFocus: prop_types.default.string
+	/**
+	* CSS selector for the element that should receive focus when the coachmark opens.
+	*/
+	selectorPrimaryFocus: prop_types.default.string,
+	/**
+	* Optional ref for an external trigger element, used when the trigger is not part of the coachmark.
+	*/
+	triggerRef: prop_types.default.shape({ current: prop_types.default.any })
 };
-
 //#endregion
-exports.Coachmark = Coachmark;
+exports.Coachmark = Coachmark;

package/lib/components/Coachmark/next/Coachmark/CoachmarkBeacon/CoachmarkBeacon.js

@@ -5,16 +5,15 @@
  * LICENSE file in the root directory of this source tree.
  */
 
-const require_runtime = require('../../../../../_virtual/_rolldown/runtime.js');
-const require_index = require('../../../../../node_modules/classnames/index.js');
-const require_settings = require('../../../../../settings.js');
-const require_devtools = require('../../../../../global/js/utils/devtools.js');
+const require_runtime = require("../../../../../_virtual/_rolldown/runtime.js");
+const require_index = require("../../../../../node_modules/classnames/index.js");
+const require_settings = require("../../../../../settings.js");
+const require_devtools = require("../../../../../global/js/utils/devtools.js");
 let react = require("react");
 react = require_runtime.__toESM(react);
 let prop_types = require("prop-types");
 prop_types = require_runtime.__toESM(prop_types);
 let _carbon_react = require("@carbon/react");
-
 //#region src/components/Coachmark/next/Coachmark/CoachmarkBeacon/CoachmarkBeacon.tsx
 /**
 * Copyright IBM Corp. 2024, 2025
@@ -52,18 +51,33 @@ const CoachmarkBeacon = (0, react.forwardRef)((props, ref) => {
 });
 CoachmarkBeacon.displayName = componentName;
 CoachmarkBeacon.propTypes = {
+	/**
+	* button props
+	*/
 	buttonProps: prop_types.default.shape({
+		/**@ts-ignore*/
 		..._carbon_react.Button.propTypes,
+		/**@ts-ignore*/
 		id: prop_types.default.string,
 		onClick: prop_types.default.func,
 		onDoubleClick: prop_types.default.func,
 		tabIndex: prop_types.default.number,
 		["aria-expanded"]: prop_types.default.bool
 	}),
+	/**
+	* Optional class name for this component.
+	*/
 	className: prop_types.default.string,
+	/**
+	* What style of beacon.
+	* BEACON_KIND is an exported enum from the Coachmark and can be used for this value.
+	* @see {@link BEACON_KIND}
+	*/
 	kind: prop_types.default.oneOf(["default"]),
+	/**
+	* The aria label.
+	*/
 	label: prop_types.default.string.isRequired
 };
-
 //#endregion
-exports.CoachmarkBeacon = CoachmarkBeacon;
+exports.CoachmarkBeacon = CoachmarkBeacon;

package/lib/components/Coachmark/next/Coachmark/CoachmarkContent.js

@@ -5,16 +5,15 @@
  * LICENSE file in the root directory of this source tree.
  */
 
-const require_runtime = require('../../../../_virtual/_rolldown/runtime.js');
-const require_index = require('../../../../node_modules/classnames/index.js');
-const require_settings = require('../../../../settings.js');
-const require_context = require('./context.js');
+const require_runtime = require("../../../../_virtual/_rolldown/runtime.js");
+const require_index = require("../../../../node_modules/classnames/index.js");
+const require_settings = require("../../../../settings.js");
+const require_context = require("./context.js");
 let react = require("react");
 react = require_runtime.__toESM(react);
 let prop_types = require("prop-types");
 prop_types = require_runtime.__toESM(prop_types);
 let _carbon_react = require("@carbon/react");
-
 //#region src/components/Coachmark/next/Coachmark/CoachmarkContent.tsx
 /**
 * Copyright IBM Corp. 2024, 2026
@@ -84,9 +83,15 @@ const CoachmarkContent = (0, react.forwardRef)((props, ref) => {
 	}, children);
 });
 CoachmarkContent.propTypes = {
+	/**
+	* This is a required callback that has to return the content to render in the body section.
+	* It can be a single child or an array of children depending on your need
+	*/
 	children: prop_types.default.node,
+	/**
+	* Provide an optional class to be applied to the containing node.
+	*/
 	className: prop_types.default.string
 };
-
 //#endregion
-exports.default = CoachmarkContent;
+exports.default = CoachmarkContent;

package/lib/components/Coachmark/next/Coachmark/CoachmarkTagline/CoachmarkTagline.js

@@ -5,17 +5,16 @@
  * LICENSE file in the root directory of this source tree.
  */
 
-const require_runtime = require('../../../../../_virtual/_rolldown/runtime.js');
-const require_index = require('../../../../../node_modules/classnames/index.js');
-const require_settings = require('../../../../../settings.js');
-const require_devtools = require('../../../../../global/js/utils/devtools.js');
+const require_runtime = require("../../../../../_virtual/_rolldown/runtime.js");
+const require_index = require("../../../../../node_modules/classnames/index.js");
+const require_settings = require("../../../../../settings.js");
+const require_devtools = require("../../../../../global/js/utils/devtools.js");
 let react = require("react");
 react = require_runtime.__toESM(react);
 let prop_types = require("prop-types");
 prop_types = require_runtime.__toESM(prop_types);
 let _carbon_react = require("@carbon/react");
 let _carbon_react_icons = require("@carbon/react/icons");
-
 //#region src/components/Coachmark/next/Coachmark/CoachmarkTagline/CoachmarkTagline.tsx
 /**
 * Copyright IBM Corp. 2025
@@ -59,19 +58,35 @@ const CoachmarkTagline = react.default.forwardRef(({ closeIconDescription = defa
 });
 CoachmarkTagline.displayName = componentName;
 CoachmarkTagline.propTypes = {
+	/**
+	* button props
+	*/
 	buttonProps: prop_types.default.shape({
+		/**@ts-ignore*/
 		..._carbon_react.Button.propTypes,
+		/**@ts-ignore*/
 		id: prop_types.default.string,
 		onClick: prop_types.default.func,
 		onDoubleClick: prop_types.default.func,
 		tabIndex: prop_types.default.number,
 		["aria-expanded"]: prop_types.default.bool
 	}),
+	/**
+	* Optional class name for this component.
+	*/
 	className: prop_types.default.string,
+	/**
+	* Tooltip text and aria label for the Close button icon.
+	*/
 	closeIconDescription: prop_types.default.string,
+	/**
+	* Function to call when the close button is clicked.
+	*/
 	onClose: prop_types.default.func,
+	/**
+	* The title of the tagline.
+	*/
 	title: prop_types.default.string.isRequired
 };
-
 //#endregion
-exports.CoachmarkTagline = CoachmarkTagline;
+exports.CoachmarkTagline = CoachmarkTagline;

package/lib/components/Coachmark/next/Coachmark/ContentBody.js

@@ -5,14 +5,13 @@
  * LICENSE file in the root directory of this source tree.
  */
 
-const require_runtime = require('../../../../_virtual/_rolldown/runtime.js');
-const require_index = require('../../../../node_modules/classnames/index.js');
-const require_context = require('./context.js');
+const require_runtime = require("../../../../_virtual/_rolldown/runtime.js");
+const require_index = require("../../../../node_modules/classnames/index.js");
+const require_context = require("./context.js");
 let react = require("react");
 react = require_runtime.__toESM(react);
 let prop_types = require("prop-types");
 prop_types = require_runtime.__toESM(prop_types);
-
 //#region src/components/Coachmark/next/Coachmark/ContentBody.tsx
 /**
 * Copyright IBM Corp. 2024, 2025
@@ -30,9 +29,15 @@ const ContentBody = (0, react.forwardRef)((props, ref) => {
 	}, children);
 });
 ContentBody.propTypes = {
+	/**
+	* Provide the optional content for header section and will be render after header titles and before progress indicator.
+	* People can make use of this if they want to have custom header.
+	*/
 	children: prop_types.default.node.isRequired,
+	/**
+	* Provide an optional class to be applied to the containing node.
+	*/
 	className: prop_types.default.string
 };
-
 //#endregion
-exports.default = ContentBody;
+exports.default = ContentBody;

package/lib/components/Coachmark/next/Coachmark/ContentHeader.js

@@ -5,18 +5,17 @@
  * LICENSE file in the root directory of this source tree.
  */
 
-const require_runtime = require('../../../../_virtual/_rolldown/runtime.js');
-const require_index = require('../../../../node_modules/classnames/index.js');
-const require_settings = require('../../../../settings.js');
-const require_context = require('./context.js');
-const require_makeDraggable = require('../../../../global/js/utils/makeDraggable/makeDraggable.js');
+const require_runtime = require("../../../../_virtual/_rolldown/runtime.js");
+const require_index = require("../../../../node_modules/classnames/index.js");
+const require_settings = require("../../../../settings.js");
+const require_context = require("./context.js");
+const require_makeDraggable = require("../../../../global/js/utils/makeDraggable/makeDraggable.js");
 let react = require("react");
 react = require_runtime.__toESM(react);
 let prop_types = require("prop-types");
 prop_types = require_runtime.__toESM(prop_types);
 let _carbon_react = require("@carbon/react");
 let _carbon_react_icons = require("@carbon/react/icons");
-
 //#region src/components/Coachmark/next/Coachmark/ContentHeader.tsx
 /**
 * Copyright IBM Corp. 2024, 2026
@@ -96,11 +95,22 @@ const ContentHeader = (0, react.forwardRef)((props, ref) => {
 	}));
 });
 ContentHeader.propTypes = {
+	/**
+	* Optional contents of the Coachmark Header.
+	*/
 	children: prop_types.default.node,
+	/**
+	* Provide an optional class to be applied to the containing node.
+	*/
 	className: prop_types.default.string,
+	/**
+	* Tooltip text and aria label for the Close button icon.
+	*/
 	closeIconDescription: prop_types.default.string,
+	/**
+	* Tooltip text and aria label for the Drag button icon.
+	*/
 	dragIconDescription: prop_types.default.string
 };
-
 //#endregion
-exports.ContentHeader = ContentHeader;
+exports.ContentHeader = ContentHeader;

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

@@ -5,10 +5,8 @@
  * LICENSE file in the root directory of this source tree.
  */
 
-const require_runtime = require('../../../../_virtual/_rolldown/runtime.js');
-const require_settings = require('../../../../settings.js');
-let react = require("react");
-
+require("../../../../_virtual/_rolldown/runtime.js");
+const require_settings = require("../../../../settings.js");
 //#region src/components/Coachmark/next/Coachmark/context.ts
 /**
 * Copyright IBM Corp. 2025
@@ -16,7 +14,7 @@ let react = require("react");
 * This source code is licensed under the Apache-2.0 license found in the
 * LICENSE file in the root directory of this source tree.
 */
-const CoachmarkContext = (0, react.createContext)({
+const CoachmarkContext = (0, require("react").createContext)({
 	open: false,
 	setOpen: () => {},
 	align: "bottom",
@@ -30,7 +28,6 @@ const CoachmarkContext = (0, react.createContext)({
 	floating: false
 });
 const blockClass = `${require_settings.pkg.prefix}--coachmark__next`;
-
 //#endregion
 exports.CoachmarkContext = CoachmarkContext;
-exports.blockClass = blockClass;
+exports.blockClass = blockClass;