@carbon/ibm-products 2.89.0 → 2.90.0

package/es/components/DescriptionList/DescriptionListBody.js

@@ -12,7 +12,6 @@ import { getDevtoolsProps } from "../../global/js/utils/devtools.js";
 import React from "react";
 import PropTypes from "prop-types";
 import { StructuredListBody } from "@carbon/react";
-
 //#region src/components/DescriptionList/DescriptionListBody.jsx
 /**
 * Copyright IBM Corp. 2024, 2024
@@ -32,11 +31,12 @@ let DescriptionListBody = React.forwardRef(({ children, className, ...rest }, re
 	}, children);
 });
 DescriptionListBody.propTypes = {
+	/** Provide the contents of the node */
 	children: PropTypes.node,
+	/** Provide an optional class to be applied to the containing node */
 	className: PropTypes.string
 };
 DescriptionListBody = pkg.checkComponentEnabled(DescriptionListBody, componentName);
 DescriptionListBody.displayName = componentName;
-
 //#endregion
-export { DescriptionListBody };
+export { DescriptionListBody };

package/es/components/DescriptionList/DescriptionListCell.js

@@ -12,7 +12,6 @@ import { getDevtoolsProps } from "../../global/js/utils/devtools.js";
 import React from "react";
 import PropTypes from "prop-types";
 import { StructuredListCell } from "@carbon/react";
-
 //#region src/components/DescriptionList/DescriptionListCell.jsx
 /**
 * Copyright IBM Corp. 2024, 2024
@@ -32,11 +31,12 @@ let DescriptionListCell = React.forwardRef(({ children, className, ...rest }, re
 	}, children);
 });
 DescriptionListCell.propTypes = {
+	/** Provide the contents of the node */
 	children: PropTypes.node,
+	/** Provide an optional class to be applied to the containing node */
 	className: PropTypes.string
 };
 DescriptionListCell = pkg.checkComponentEnabled(DescriptionListCell, componentName);
 DescriptionListCell.displayName = componentName;
-
 //#endregion
-export { DescriptionListCell };
+export { DescriptionListCell };

package/es/components/DescriptionList/DescriptionListRow.js

@@ -12,7 +12,6 @@ import { getDevtoolsProps } from "../../global/js/utils/devtools.js";
 import React from "react";
 import PropTypes from "prop-types";
 import { StructuredListRow } from "@carbon/react";
-
 //#region src/components/DescriptionList/DescriptionListRow.jsx
 /**
 * Copyright IBM Corp. 2024, 2024
@@ -32,11 +31,12 @@ let DescriptionListRow = React.forwardRef(({ children, className, ...rest }, ref
 	}, children);
 });
 DescriptionListRow.propTypes = {
+	/** Provide the contents of the node */
 	children: PropTypes.node,
+	/** Provide an optional class to be applied to the containing node */
 	className: PropTypes.string
 };
 DescriptionListRow = pkg.checkComponentEnabled(DescriptionListRow, componentName);
 DescriptionListRow.displayName = componentName;
-
 //#endregion
-export { DescriptionListRow };
+export { DescriptionListRow };

package/es/components/DescriptionList/constants.js

@@ -18,6 +18,5 @@ const DescriptionListSize = {
 	Medium: "md",
 	Large: "lg"
 };
-
 //#endregion
-export { DescriptionListSize };
+export { DescriptionListSize };

package/es/components/EditFullPage/EditFullPage.js

@@ -11,7 +11,6 @@ import { pkg } from "../../settings.js";
 import { getDevtoolsProps } from "../../global/js/utils/devtools.js";
 import React from "react";
 import PropTypes from "prop-types";
-
 //#region src/components/EditFullPage/EditFullPage.tsx
 /**
 * Copyright IBM Corp. 2022, 2024
@@ -44,9 +43,14 @@ EditFullPage.deprecated = {
 };
 EditFullPage.displayName = componentName;
 EditFullPage.propTypes = {
+	/**
+	* Provide the contents of the EditFullPage.
+	*/
 	children: PropTypes.node.isRequired,
+	/**
+	* Provide an optional class to be applied to the containing node.
+	*/
 	className: PropTypes.string
 };
-
 //#endregion
-export { EditFullPage };
+export { EditFullPage };

package/es/components/EditInPlace/EditInPlace.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"EditInPlace.d.ts","sourceRoot":"","sources":["../../../src/components/EditInPlace/EditInPlace.tsx"],"names":[],"mappings":"AAAA;;;;;GAKG;AASH,OAAO,KAAK,EAAE,EACZ,iBAAiB,EAKlB,MAAM,OAAO,CAAC;AAUf,OAAO,SAAS,MAAM,YAAY,CAAC;AAYnC,KAAK,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;AAC/B,KAAK,aAAa,GACd,KAAK,GACL,UAAU,GACV,WAAW,GACX,QAAQ,GACR,aAAa,GACb,cAAc,GACd,MAAM,GACN,OAAO,CAAC;AACZ,KAAK,KAAK,GAAG;IACX,MAAM,EAAE,aAAa,CAAC;IACtB,IAAI,EAAE,aAAa,CAAC;IACpB,IAAI,EAAE,aAAa,CAAC;CACrB,CAAC;AAEF,MAAM,WAAW,gBAAiB,SAAQ,iBAAiB;IACzD;;OAEG;IACH,WAAW,EAAE,MAAM,CAAC;IACpB;;OAEG;IACH,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;IAClB;;OAEG;IACH,EAAE,EAAE,MAAM,CAAC;IACX;;;;;;OAMG;IACH,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B;;OAEG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACjC;;OAEG;IACH,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAClC;;OAEG;IACH,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAClC;;OAEG;IACH,MAAM,EAAE,MAAM,IAAI,CAAC;IACnB;;OAEG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB;;OAEG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;OAEG;IACH,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;IAClB;;OAEG;IACH,kBAAkB,CAAC,EAAE,aAAa,CAAC;IACnC;;OAEG;IACH,IAAI,CAAC,EAAE,IAAI,CAAC;IACZ;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,aAAa,GAAG,KAAK,CAAC;IACzC;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;IACd;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,eAAO,MAAM,WAAW,yFA2QvB,CAAC;AAIF,eAAO,MAAM,eAAe;IAC1B;;;OAGG;;CAEJ,CAAC"}
+{"version":3,"file":"EditInPlace.d.ts","sourceRoot":"","sources":["../../../src/components/EditInPlace/EditInPlace.tsx"],"names":[],"mappings":"AAAA;;;;;GAKG;AASH,OAAO,KAAK,EAAE,EACZ,iBAAiB,EAKlB,MAAM,OAAO,CAAC;AAUf,OAAO,SAAS,MAAM,YAAY,CAAC;AAYnC,KAAK,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;AAC/B,KAAK,aAAa,GACd,KAAK,GACL,UAAU,GACV,WAAW,GACX,QAAQ,GACR,aAAa,GACb,cAAc,GACd,MAAM,GACN,OAAO,CAAC;AACZ,KAAK,KAAK,GAAG;IACX,MAAM,EAAE,aAAa,CAAC;IACtB,IAAI,EAAE,aAAa,CAAC;IACpB,IAAI,EAAE,aAAa,CAAC;CACrB,CAAC;AAEF,MAAM,WAAW,gBAAiB,SAAQ,iBAAiB;IACzD;;OAEG;IACH,WAAW,EAAE,MAAM,CAAC;IACpB;;OAEG;IACH,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;IAClB;;OAEG;IACH,EAAE,EAAE,MAAM,CAAC;IACX;;;;;;OAMG;IACH,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B;;OAEG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACjC;;OAEG;IACH,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAClC;;OAEG;IACH,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAClC;;OAEG;IACH,MAAM,EAAE,MAAM,IAAI,CAAC;IACnB;;OAEG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB;;OAEG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;OAEG;IACH,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;IAClB;;OAEG;IACH,kBAAkB,CAAC,EAAE,aAAa,CAAC;IACnC;;OAEG;IACH,IAAI,CAAC,EAAE,IAAI,CAAC;IACZ;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,aAAa,GAAG,KAAK,CAAC;IACzC;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;IACd;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,eAAO,MAAM,WAAW,yFAmWvB,CAAC;AAIF,eAAO,MAAM,eAAe;IAC1B;;;OAGG;;CAEJ,CAAC"}

package/es/components/EditInPlace/EditInPlace.js

@@ -9,11 +9,10 @@ import { __toESM } from "../../_virtual/_rolldown/runtime.js";
 import { require_classnames } from "../../node_modules/classnames/index.js";
 import { pkg } from "../../settings.js";
 import { getDevtoolsProps } from "../../global/js/utils/devtools.js";
-import React, { forwardRef, useEffect, useRef, useState } from "react";
+import React, { forwardRef, useRef, useState } from "react";
 import PropTypes from "prop-types";
 import { IconButton, Toggletip, ToggletipButton, ToggletipContent, usePrefix } from "@carbon/react";
 import { Checkmark, Close, Edit, EditOff, WarningFilled } from "@carbon/react/icons";
-
 //#region src/components/EditInPlace/EditInPlace.tsx
 /**
 * Copyright IBM Corp. 2022, 2025
@@ -30,11 +29,14 @@ const defaults = {
 };
 const EditInPlace = forwardRef(({ cancelLabel, editAlwaysVisible, editLabel, id, inheritTypography, invalid, invalidLabel: deprecated_invalidLabel = " ", invalidText, labelText, onCancel, onChange, onSave, onBlur, readOnly, readOnlyLabel, readOnlyToggleTipText, saveLabel, size = "sm", toggleTipAlignment, tooltipAlignment, value, placeholder, ...rest }, ref) => {
 	const [focused, setFocused] = useState(false);
-	const [initialValue, setInitialValue] = useState("");
+	const [initialValue, setInitialValue] = useState(value);
 	const [dirtyInput, setDirtyInput] = useState(false);
 	const inputRef = useRef(null);
-	const canSave = value !== initialValue && !invalid;
+	const hasValueChanged = value.trim() !== initialValue.trim();
+	const canSave = hasValueChanged && !invalid;
+	const canCancel = hasValueChanged;
 	const escaping = useRef(false);
+	const clickingWithin = useRef(false);
 	const carbonPrefix = usePrefix();
 	const tipAlignIsObject = typeof tooltipAlignment === "object";
 	const tipAlignments = [
@@ -45,43 +47,53 @@ const EditInPlace = forwardRef(({ cancelLabel, editAlwaysVisible, editLabel, id,
 		acc[tips] = (tipAlignIsObject ? tooltipAlignment[tips] : tooltipAlignment) ?? defaults.tooltipAlignment;
 		return acc;
 	}, {});
-	useEffect(() => {
-		if (!initialValue && !dirtyInput) setInitialValue(value);
-	}, [
-		initialValue,
-		dirtyInput,
-		value
-	]);
 	const isTargetingChild = ({ currentTarget, relatedTarget }) => currentTarget.contains(relatedTarget);
 	const onChangeHandler = ({ target }) => {
 		if (!dirtyInput) setDirtyInput(true);
 		onChange(target.value);
 	};
 	const onFocusHandler = (e) => {
-		if (!isTargetingChild(e)) {
-			inputRef.current?.focus();
-			setFocused(true);
-		}
+		if (!isTargetingChild(e)) inputRef.current?.focus();
+		setFocused(true);
 	};
-	const onSaveHandler = () => {
+	const onSaveHandler = (exitEditMode = false) => {
 		setInitialValue(value);
 		setDirtyInput(false);
 		onSave();
-		setFocused(false);
+		if (exitEditMode) setFocused(false);
+		else requestAnimationFrame(() => {
+			inputRef.current?.focus();
+		});
 	};
-	const onCancelHandler = () => {
+	const onCancelHandler = (exitEditMode = false) => {
 		setDirtyInput(false);
 		onCancel(initialValue);
+		if (exitEditMode) setFocused(false);
+		else requestAnimationFrame(() => {
+			if (inputRef.current) {
+				inputRef.current.focus();
+				const length = inputRef.current.value.length;
+				inputRef.current.setSelectionRange(length, length);
+			}
+		});
 	};
 	const onBlurHandler = (e) => {
-		if (typeof onBlur === "function" && !isTargetingChild(e)) {
+		const clickedWithin = clickingWithin.current;
+		const targetingChild = isTargetingChild(e);
+		if (clickedWithin && targetingChild) {
+			clickingWithin.current = false;
+			return;
+		}
+		if (clickedWithin && !targetingChild) clickingWithin.current = false;
+		if (!clickedWithin && targetingChild) return;
+		if (typeof onBlur === "function") {
 			onBlur(initialValue);
 			setFocused(false);
 		} else {
 			if (escaping.current) return;
-			if (!isTargetingChild(e)) if (canSave) onSaveHandler();
+			if (canSave) onSaveHandler(true);
 			else {
-				onCancelHandler();
+				onCancelHandler(true);
 				setFocused(false);
 			}
 		}
@@ -96,6 +108,23 @@ const EditInPlace = forwardRef(({ cancelLabel, editAlwaysVisible, editLabel, id,
 		inputRef.current?.blur();
 		setFocused(false);
 	};
+	const handleToolbarMouseDown = (e) => {
+		const element = e.target;
+		let foundButton = null;
+		let current = element;
+		while (current && current !== e.currentTarget) {
+			if (current.tagName === "BUTTON") {
+				foundButton = current;
+				break;
+			}
+			current = current.parentElement;
+		}
+		if (!foundButton) foundButton = element.querySelector("button");
+		if (foundButton) {
+			clickingWithin.current = true;
+			if (foundButton.hasAttribute("disabled") || foundButton.getAttribute("aria-disabled") === "true") e.preventDefault();
+		}
+	};
 	const onKeyHandler = (e) => {
 		escaping.current = true;
 		switch (e.key) {
@@ -137,7 +166,10 @@ const EditInPlace = forwardRef(({ cancelLabel, editAlwaysVisible, editLabel, id,
 	}, readOnly ? /* @__PURE__ */ React.createElement(Toggletip, {
 		align: toggleTipAlignment,
 		className: `${blockClass}__toggletip-wrapper`
-	}, /* @__PURE__ */ React.createElement(ToggletipButton, { label: readOnlyLabel || "Edit off" }, inputElement), /* @__PURE__ */ React.createElement(ToggletipContent, null, /* @__PURE__ */ React.createElement("p", null, readOnlyToggleTipText || "This field is read-only and cannot be edited"))) : inputElement, /* @__PURE__ */ React.createElement("div", { className: `${blockClass}__toolbar` }, invalid && /* @__PURE__ */ React.createElement(WarningFilled, {
+	}, /* @__PURE__ */ React.createElement(ToggletipButton, { label: readOnlyLabel || "Edit off" }, inputElement), /* @__PURE__ */ React.createElement(ToggletipContent, null, /* @__PURE__ */ React.createElement("p", null, readOnlyToggleTipText || "This field is read-only and cannot be edited"))) : inputElement, /* @__PURE__ */ React.createElement("div", {
+		className: `${blockClass}__toolbar`,
+		onMouseDown: handleToolbarMouseDown
+	}, invalid && /* @__PURE__ */ React.createElement(WarningFilled, {
 		size: 16,
 		className: `${blockClass}__warning-icon`
 	}), readOnly ? /* @__PURE__ */ React.createElement(IconButton, {
@@ -151,15 +183,16 @@ const EditInPlace = forwardRef(({ cancelLabel, editAlwaysVisible, editLabel, id,
 		align: tipAlignments.cancel,
 		size,
 		label: cancelLabel,
-		onClick: onCancelHandler,
+		onClick: () => onCancelHandler(false),
 		kind: "ghost",
 		key: "cancel",
-		className: `${blockClass}__btn ${blockClass}__btn-cancel`
+		className: `${blockClass}__btn ${blockClass}__btn-cancel`,
+		disabled: !canCancel
 	}, /* @__PURE__ */ React.createElement(Close, { size: 16 })), /* @__PURE__ */ React.createElement(IconButton, {
 		align: tipAlignments.save,
 		size,
 		label: saveLabel,
-		onClick: onSaveHandler,
+		onClick: () => onSaveHandler(false),
 		kind: "ghost",
 		key: "save",
 		className: `${blockClass}__btn ${blockClass}__btn-save`,
@@ -180,7 +213,12 @@ const EditInPlace = forwardRef(({ cancelLabel, editAlwaysVisible, editLabel, id,
 	}, inputContainer, invalid && /* @__PURE__ */ React.createElement("p", { className: `${blockClass}__warning-text` }, invalidText ?? deprecated_invalidLabel));
 });
 EditInPlace.displayName = componentName;
-const deprecatedProps = { invalidText: PropTypes.string };
+const deprecatedProps = { 
+/**
+* **Deprecated**
+* invalidLabel was misnamed, using invalidText to match Carbon
+*/
+invalidText: PropTypes.string };
 const alignPropType = PropTypes.oneOf([
 	"top",
 	"top-left",
@@ -192,37 +230,107 @@ const alignPropType = PropTypes.oneOf([
 	"right"
 ]);
 EditInPlace.propTypes = {
+	/**
+	* label for cancel button
+	*/
 	cancelLabel: PropTypes.string.isRequired,
+	/**
+	* By default the edit icon is shown on hover only.
+	*/
 	editAlwaysVisible: PropTypes.bool,
+	/**
+	* label for edit button
+	*/
 	editLabel: PropTypes.string.isRequired,
+	/**
+	* Specify a custom id for the input
+	*/
 	id: PropTypes.string.isRequired,
+	/**
+	* inheritTypography - causes the text entry field to inherit typography settings
+	* assigned to the container. This is useful when editing titles for instance.
+	*
+	* NOTE: The size property limits the vertical size of the input element.
+	* Inherited font's should be selected to fit within the size selected.
+	*/
 	inheritTypography: PropTypes.bool,
+	/**
+	* determines if the input is invalid
+	*/
 	invalid: PropTypes.bool,
+	/**
+	* text that is displayed if the input is invalid
+	*/
+	/**@ts-ignore*/
 	invalidText: PropTypes.string,
+	/**
+	* Provide the text that will be read by a screen reader when visiting this control
+	*/
 	labelText: PropTypes.string.isRequired,
+	/**
+	* handler to add custom onBlur event
+	*/
 	onBlur: PropTypes.func,
+	/**
+	* handler that is called when the cancel button is pressed or when the user removes focus from the input and there is no new value
+	*/
 	onCancel: PropTypes.func.isRequired,
+	/**
+	* handler that is called when the input is updated
+	*/
 	onChange: PropTypes.func.isRequired,
+	/**
+	* handler that is called when the save button is pressed or when the user removes focus from the input if it has a new value
+	*/
 	onSave: PropTypes.func.isRequired,
+	/**
+	* Placeholder for text input
+	*/
 	placeholder: PropTypes.string,
+	/**
+	* determines if the input is in readOnly mode
+	*/
 	readOnly: PropTypes.bool,
+	/**
+	* label for the edit off button that displays when in read only mode
+	*/
 	readOnlyLabel: PropTypes.string,
+	/**
+	* text for the toggletip that displays when in read only mode
+	*/
 	readOnlyToggleTipText: PropTypes.string,
+	/**
+	* label for save button
+	*/
 	saveLabel: PropTypes.string.isRequired,
+	/**
+	* vertical size of control
+	*/
 	size: PropTypes.oneOf([
 		"sm",
 		"md",
 		"lg"
 	]),
+	/**
+	* alignment for the toggletip that displays when in read only mode
+	*/
 	toggleTipAlignment: alignPropType,
+	/**
+	* tooltipAlignment from the standard tooltip. Default center.
+	*
+	* Can be passed either as one of tooltip options or as an object specifying cancel, edit and save separately
+	*/
+	/**@ts-ignore*/
 	tooltipAlignment: PropTypes.oneOfType([alignPropType, PropTypes.shape({
 		cancel: alignPropType,
 		edit: alignPropType,
 		save: alignPropType
 	})]),
+	/**
+	* current value of the input
+	*/
 	value: PropTypes.string.isRequired,
 	...deprecatedProps
 };
-
 //#endregion
-export { EditInPlace };
+export { EditInPlace };

package/es/components/EditSidePanel/EditSidePanel.js

@@ -15,7 +15,6 @@ import { SidePanel } from "../SidePanel/SidePanel.js";
 import React from "react";
 import PropTypes from "prop-types";
 import { Form } from "@carbon/react";
-
 //#region src/components/EditSidePanel/EditSidePanel.tsx
 var import_classnames = /* @__PURE__ */ __toESM(require_classnames());
 const blockClass = `${pkg.prefix}--edit-side-panel`;
@@ -74,20 +73,72 @@ EditSidePanel.deprecated = {
 };
 EditSidePanel.displayName = componentName;
 EditSidePanel.propTypes = {
+	/**
+	* Sets the body content of the create side panel
+	*/
+	/**@ts-ignore*/
 	children: PropTypes.oneOfType([PropTypes.arrayOf(PropTypes.node), PropTypes.node]).isRequired,
+	/**
+	* Provide an optional class to be applied to the containing node.
+	*/
 	className: PropTypes.string,
+	/**
+	* Specifies a boolean for disabling or enabling the primary button. This is important for form validation
+	* Returning `true` prevents the primary button from being clicked until required fields are completed.
+	*/
 	disableSubmit: PropTypes.bool,
+	/**
+	* Specifies an optional field that provides a additional context for a form
+	*/
 	formDescription: PropTypes.node,
+	/**
+	* Specifies a required field that provides a title for a form
+	*/
 	formTitle: PropTypes.node.isRequired,
+	/**
+	* Unique identifier
+	*/
 	id: PropTypes.string,
+	/**
+	* Specifies an optional handler which is called when the CreateSidePanel
+	* is closed.
+	*/
 	onRequestClose: PropTypes.func,
+	/**
+	* Specifies an optional handler which is called when the CreateSidePanel
+	* primary button is pressed.
+	*/
 	onRequestSubmit: PropTypes.func,
+	/**
+	* Specifies whether the CreateSidePanel is open or not.
+	*/
 	open: PropTypes.bool.isRequired,
+	/**
+	* Determines if the side panel is on the right or left
+	*/
 	placement: PropTypes.oneOf(["left", "right"]),
+	/**
+	* Specifies the primary button's text in the modal.
+	*/
 	primaryButtonText: PropTypes.string.isRequired,
+	/**
+	* Specifies the secondary button's text in the modal.
+	*/
 	secondaryButtonText: PropTypes.string.isRequired,
+	/**
+	* This is the selector to the element that contains all of the page content that will shrink if the panel is a slide in.
+	* This prop is required when using the `slideIn` variant of the side panel.
+	*/
+	/**@ts-ignore*/
 	selectorPageContent: PropTypes.string,
+	/**
+	* Specifies which DOM element in the form should be focused.
+	*/
+	/**@ts-ignore*/
 	selectorPrimaryFocus: PropTypes.node.isRequired,
+	/**
+	* Sets the size of the side panel
+	*/
 	size: PropTypes.oneOf([
 		"xs",
 		"sm",
@@ -95,11 +146,23 @@ EditSidePanel.propTypes = {
 		"lg",
 		"2xl"
 	]),
+	/**
+	* Specifies which DOM element in the form should be focused.
+	*/
 	slideIn: PropTypes.bool,
+	/**
+	*  **Experimental:** Provide a `Slug` component to be rendered inside the `SidePanel` component
+	*/
 	slug: PropTypes.node,
+	/**
+	* The subtitle of the CreateSidePanel is optional and serves to provide more information about the modal.
+	*/
 	subtitle: PropTypes.node,
+	/**
+	* The title of the CreateSidePanel is usually the product or service name.
+	*/
+	/**@ts-ignore*/
 	title: PropTypes.node.isRequired
 };
-
 //#endregion
-export { EditSidePanel };
+export { EditSidePanel };

package/es/components/EditTearsheet/EditTearsheet.js

@@ -14,7 +14,6 @@ import { TearsheetShell } from "../Tearsheet/TearsheetShell.js";
 import React, { createContext, forwardRef, useRef, useState } from "react";
 import PropTypes from "prop-types";
 import { Form, SideNav, SideNavItems, SideNavMenuItem } from "@carbon/react";
-
 //#region src/components/EditTearsheet/EditTearsheet.tsx
 /**
 * Copyright IBM Corp. 2022, 2023
@@ -116,21 +115,72 @@ EditTearsheet.deprecated = {
 };
 EditTearsheet.displayName = componentName;
 EditTearsheet.propTypes = {
+	/**
+	* The cancel button text
+	*/
 	cancelButtonText: PropTypes.string,
+	/**
+	* The main content of the tearsheet
+	*/
 	children: PropTypes.node,
+	/**
+	* An optional class or classes to be added to the outermost element.
+	*/
 	className: PropTypes.string,
+	/**
+	* A description of the flow, displayed in the header area of the tearsheet.
+	*/
 	description: PropTypes.node,
+	/**
+	* Used to set the size of the influencer
+	*/
 	influencerWidth: PropTypes.oneOf(["narrow", "wide"]),
+	/**
+	* A label for the tearsheet, displayed in the header area of the tearsheet
+	* to maintain context for the tearsheet (e.g. as the title changes from page
+	* to page of a multi-page task).
+	*/
 	label: PropTypes.node,
+	/**
+	* An optional handler that is called when the user closes the tearsheet (by
+	* clicking the close button, if enabled, or clicking outside, if enabled).
+	* Returning `false` here prevents the modal from closing.
+	*/
 	onClose: PropTypes.func,
+	/**
+	* An optional handler that is called when a user changes forms via clicking
+	* an influencer nav item.
+	* Returns the index of the selected form.
+	*/
 	onFormChange: PropTypes.func,
+	/**
+	* Specify a handler for submitting the tearsheet.
+	*/
 	onRequestSubmit: PropTypes.func.isRequired,
+	/**
+	* Specifies whether the tearsheet is currently open.
+	*/
 	open: PropTypes.bool,
+	/**
+	* Specifies the aria label for the SideNav from Carbon UIShell
+	*/
 	sideNavAriaLabel: PropTypes.string,
+	/**
+	* The submit button text
+	*/
 	submitButtonText: PropTypes.string,
+	/**
+	* The main title of the tearsheet, displayed in the header area.
+	*/
 	title: PropTypes.node,
+	/**
+	* The position of the top of tearsheet in the viewport. The 'normal'
+	* position (the default) is a short distance down from the top of the
+	* viewport, leaving room at the top for a global header bar to show through
+	* from below. The 'lower' position provides a little extra room at the top
+	* to allow an action bar navigation or breadcrumbs to also show through.
+	*/
 	verticalPosition: PropTypes.oneOf(["normal", "lower"])
 };
-
 //#endregion
-export { EditTearsheet, FormContext, FormNumberContext };
+export { EditTearsheet, FormContext, FormNumberContext };

package/es/components/EditTearsheet/EditTearsheetForm.js

@@ -14,7 +14,6 @@ import { useRetrieveFormTitles } from "../../global/js/hooks/useRetrieveFormTitl
 import React, { forwardRef, useContext } from "react";
 import PropTypes from "prop-types";
 import { Column, FormGroup, Grid } from "@carbon/react";
-
 //#region src/components/EditTearsheet/EditTearsheetForm.tsx
 /**
 * Copyright IBM Corp. 2022, 2025
@@ -53,15 +52,46 @@ const EditTearsheetForm = forwardRef(({ children, className, description, fields
 	}, /* @__PURE__ */ React.createElement(Grid, null, children)) : children))) : pconsole_default.warn(`You have tried using a ${componentName} component outside of a EditTearsheet. This is not allowed. ${componentName}s should always be children of the EditTearsheet`);
 });
 EditTearsheetForm.propTypes = {
+	/**
+	* Content that shows in the tearsheet form
+	*/
 	children: PropTypes.node,
+	/**
+	* Sets an optional className to be added to the tearsheet form
+	*/
 	className: PropTypes.string,
+	/**
+	* Sets an optional description on the form component
+	*/
 	description: PropTypes.string,
+	/**
+	* This is the required legend id that appears as the aria-labelledby of fieldset for accessibility purposes.
+	*/
+	/**@ts-ignore */
 	fieldsetLegendId: PropTypes.node,
+	/**
+	* This is the required legend text that appears above a fieldset html element for accessibility purposes.
+	* You can set the `hasFieldset` prop to false if you have multiple fieldset elements or want to control the children of your Full Page's form content.
+	* Otherwise, use CSS to hide/remove this label text.
+	*/
+	/**@ts-ignore */
 	fieldsetLegendText: PropTypes.string,
+	/**
+	* This optional prop will render your form content inside of a fieldset html element
+	* and is defaulted to true.
+	* You can set this prop to `false` if you have multiple fieldset elements or want to control the children of your Full Page's form content.
+	*/
+	/**@ts-ignore*/
 	hasFieldset: PropTypes.bool,
+	/**
+	* Sets an optional subtitle on the form component
+	*/
+	/**@ts-ignore*/
 	subtitle: PropTypes.string,
+	/**
+	* Sets the title text for a tearsheet form
+	*/
 	title: PropTypes.node.isRequired
 };
-
 //#endregion
-export { EditTearsheetForm };
+export { EditTearsheetForm };

package/es/components/EditTearsheetNarrow/EditTearsheetNarrow.js

@@ -11,7 +11,6 @@ import { pkg } from "../../settings.js";
 import { getDevtoolsProps } from "../../global/js/utils/devtools.js";
 import React from "react";
 import PropTypes from "prop-types";
-
 //#region src/components/EditTearsheetNarrow/EditTearsheetNarrow.tsx
 /**
 * Copyright IBM Corp. 2022, 2022
@@ -43,9 +42,14 @@ EditTearsheetNarrow.deprecated = {
 };
 EditTearsheetNarrow.displayName = componentName;
 EditTearsheetNarrow.propTypes = {
+	/**
+	* Provide the contents of the EditTearsheetNarrow.
+	*/
 	children: PropTypes.node.isRequired,
+	/**
+	* Provide an optional class to be applied to the containing node.
+	*/
 	className: PropTypes.string
 };
-
 //#endregion
-export { EditTearsheetNarrow };
+export { EditTearsheetNarrow };