@carbon/ibm-products 2.89.0 → 2.90.0

package/lib/components/DescriptionList/DescriptionListCell.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/DescriptionList/DescriptionListCell.jsx
 /**
 * Copyright IBM Corp. 2024, 2024
@@ -34,16 +33,17 @@ let DescriptionListCell = react.default.forwardRef(({ children, className, ...re
 	}, children);
 });
 DescriptionListCell.propTypes = {
+	/** Provide the contents of the node */
 	children: prop_types.default.node,
+	/** Provide an optional class to be applied to the containing node */
 	className: prop_types.default.string
 };
 DescriptionListCell = require_settings.pkg.checkComponentEnabled(DescriptionListCell, componentName);
 DescriptionListCell.displayName = componentName;
-
 //#endregion
-Object.defineProperty(exports, 'DescriptionListCell', {
-  enumerable: true,
-  get: function () {
-    return DescriptionListCell;
-  }
-});
+Object.defineProperty(exports, "DescriptionListCell", {
+	enumerable: true,
+	get: function() {
+		return DescriptionListCell;
+	}
+});

package/lib/components/DescriptionList/DescriptionListRow.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/DescriptionList/DescriptionListRow.jsx
 /**
 * Copyright IBM Corp. 2024, 2024
@@ -34,16 +33,17 @@ let DescriptionListRow = react.default.forwardRef(({ children, className, ...res
 	}, children);
 });
 DescriptionListRow.propTypes = {
+	/** Provide the contents of the node */
 	children: prop_types.default.node,
+	/** Provide an optional class to be applied to the containing node */
 	className: prop_types.default.string
 };
 DescriptionListRow = require_settings.pkg.checkComponentEnabled(DescriptionListRow, componentName);
 DescriptionListRow.displayName = componentName;
-
 //#endregion
-Object.defineProperty(exports, 'DescriptionListRow', {
-  enumerable: true,
-  get: function () {
-    return DescriptionListRow;
-  }
-});
+Object.defineProperty(exports, "DescriptionListRow", {
+	enumerable: true,
+	get: function() {
+		return DescriptionListRow;
+	}
+});

package/lib/components/DescriptionList/constants.js

@@ -5,7 +5,6 @@
  * LICENSE file in the root directory of this source tree.
  */
 
-
 //#region src/components/DescriptionList/constants.js
 /**
 * Copyright IBM Corp. 2024
@@ -19,6 +18,5 @@ const DescriptionListSize = {
 	Medium: "md",
 	Large: "lg"
 };
-
 //#endregion
-exports.DescriptionListSize = DescriptionListSize;
+exports.DescriptionListSize = DescriptionListSize;

package/lib/components/EditFullPage/EditFullPage.js

@@ -5,15 +5,14 @@
  * 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);
-
 //#region src/components/EditFullPage/EditFullPage.tsx
 /**
 * Copyright IBM Corp. 2022, 2024
@@ -46,9 +45,14 @@ EditFullPage.deprecated = {
 };
 EditFullPage.displayName = componentName;
 EditFullPage.propTypes = {
+	/**
+	* Provide the contents of the EditFullPage.
+	*/
 	children: prop_types.default.node.isRequired,
+	/**
+	* Provide an optional class to be applied to the containing node.
+	*/
 	className: prop_types.default.string
 };
-
 //#endregion
-exports.EditFullPage = EditFullPage;
+exports.EditFullPage = EditFullPage;

package/lib/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/lib/components/EditInPlace/EditInPlace.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/EditInPlace/EditInPlace.tsx
 /**
 * Copyright IBM Corp. 2022, 2025
@@ -32,11 +31,14 @@ const defaults = {
 };
 const EditInPlace = (0, react.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] = (0, react.useState)(false);
-	const [initialValue, setInitialValue] = (0, react.useState)("");
+	const [initialValue, setInitialValue] = (0, react.useState)(value);
 	const [dirtyInput, setDirtyInput] = (0, react.useState)(false);
 	const inputRef = (0, react.useRef)(null);
-	const canSave = value !== initialValue && !invalid;
+	const hasValueChanged = value.trim() !== initialValue.trim();
+	const canSave = hasValueChanged && !invalid;
+	const canCancel = hasValueChanged;
 	const escaping = (0, react.useRef)(false);
+	const clickingWithin = (0, react.useRef)(false);
 	const carbonPrefix = (0, _carbon_react.usePrefix)();
 	const tipAlignIsObject = typeof tooltipAlignment === "object";
 	const tipAlignments = [
@@ -47,43 +49,53 @@ const EditInPlace = (0, react.forwardRef)(({ cancelLabel, editAlwaysVisible, edi
 		acc[tips] = (tipAlignIsObject ? tooltipAlignment[tips] : tooltipAlignment) ?? defaults.tooltipAlignment;
 		return acc;
 	}, {});
-	(0, react.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);
 			}
 		}
@@ -98,6 +110,23 @@ const EditInPlace = (0, react.forwardRef)(({ cancelLabel, editAlwaysVisible, edi
 		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) {
@@ -139,7 +168,10 @@ const EditInPlace = (0, react.forwardRef)(({ cancelLabel, editAlwaysVisible, edi
 	}, readOnly ? /* @__PURE__ */ react.default.createElement(_carbon_react.Toggletip, {
 		align: toggleTipAlignment,
 		className: `${blockClass}__toggletip-wrapper`
-	}, /* @__PURE__ */ react.default.createElement(_carbon_react.ToggletipButton, { label: readOnlyLabel || "Edit off" }, inputElement), /* @__PURE__ */ react.default.createElement(_carbon_react.ToggletipContent, null, /* @__PURE__ */ react.default.createElement("p", null, readOnlyToggleTipText || "This field is read-only and cannot be edited"))) : inputElement, /* @__PURE__ */ react.default.createElement("div", { className: `${blockClass}__toolbar` }, invalid && /* @__PURE__ */ react.default.createElement(_carbon_react_icons.WarningFilled, {
+	}, /* @__PURE__ */ react.default.createElement(_carbon_react.ToggletipButton, { label: readOnlyLabel || "Edit off" }, inputElement), /* @__PURE__ */ react.default.createElement(_carbon_react.ToggletipContent, null, /* @__PURE__ */ react.default.createElement("p", null, readOnlyToggleTipText || "This field is read-only and cannot be edited"))) : inputElement, /* @__PURE__ */ react.default.createElement("div", {
+		className: `${blockClass}__toolbar`,
+		onMouseDown: handleToolbarMouseDown
+	}, invalid && /* @__PURE__ */ react.default.createElement(_carbon_react_icons.WarningFilled, {
 		size: 16,
 		className: `${blockClass}__warning-icon`
 	}), readOnly ? /* @__PURE__ */ react.default.createElement(_carbon_react.IconButton, {
@@ -153,15 +185,16 @@ const EditInPlace = (0, react.forwardRef)(({ cancelLabel, editAlwaysVisible, edi
 		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.default.createElement(_carbon_react_icons.Close, { size: 16 })), /* @__PURE__ */ react.default.createElement(_carbon_react.IconButton, {
 		align: tipAlignments.save,
 		size,
 		label: saveLabel,
-		onClick: onSaveHandler,
+		onClick: () => onSaveHandler(false),
 		kind: "ghost",
 		key: "save",
 		className: `${blockClass}__btn ${blockClass}__btn-save`,
@@ -182,7 +215,12 @@ const EditInPlace = (0, react.forwardRef)(({ cancelLabel, editAlwaysVisible, edi
 	}, inputContainer, invalid && /* @__PURE__ */ react.default.createElement("p", { className: `${blockClass}__warning-text` }, invalidText ?? deprecated_invalidLabel));
 });
 EditInPlace.displayName = componentName;
-const deprecatedProps = { invalidText: prop_types.default.string };
+const deprecatedProps = { 
+/**
+* **Deprecated**
+* invalidLabel was misnamed, using invalidText to match Carbon
+*/
+invalidText: prop_types.default.string };
 const alignPropType = prop_types.default.oneOf([
 	"top",
 	"top-left",
@@ -194,37 +232,107 @@ const alignPropType = prop_types.default.oneOf([
 	"right"
 ]);
 EditInPlace.propTypes = {
+	/**
+	* label for cancel button
+	*/
 	cancelLabel: prop_types.default.string.isRequired,
+	/**
+	* By default the edit icon is shown on hover only.
+	*/
 	editAlwaysVisible: prop_types.default.bool,
+	/**
+	* label for edit button
+	*/
 	editLabel: prop_types.default.string.isRequired,
+	/**
+	* Specify a custom id for the input
+	*/
 	id: prop_types.default.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: prop_types.default.bool,
+	/**
+	* determines if the input is invalid
+	*/
 	invalid: prop_types.default.bool,
+	/**
+	* text that is displayed if the input is invalid
+	*/
+	/**@ts-ignore*/
 	invalidText: prop_types.default.string,
+	/**
+	* Provide the text that will be read by a screen reader when visiting this control
+	*/
 	labelText: prop_types.default.string.isRequired,
+	/**
+	* handler to add custom onBlur event
+	*/
 	onBlur: prop_types.default.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: prop_types.default.func.isRequired,
+	/**
+	* handler that is called when the input is updated
+	*/
 	onChange: prop_types.default.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: prop_types.default.func.isRequired,
+	/**
+	* Placeholder for text input
+	*/
 	placeholder: prop_types.default.string,
+	/**
+	* determines if the input is in readOnly mode
+	*/
 	readOnly: prop_types.default.bool,
+	/**
+	* label for the edit off button that displays when in read only mode
+	*/
 	readOnlyLabel: prop_types.default.string,
+	/**
+	* text for the toggletip that displays when in read only mode
+	*/
 	readOnlyToggleTipText: prop_types.default.string,
+	/**
+	* label for save button
+	*/
 	saveLabel: prop_types.default.string.isRequired,
+	/**
+	* vertical size of control
+	*/
 	size: prop_types.default.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: prop_types.default.oneOfType([alignPropType, prop_types.default.shape({
 		cancel: alignPropType,
 		edit: alignPropType,
 		save: alignPropType
 	})]),
+	/**
+	* current value of the input
+	*/
 	value: prop_types.default.string.isRequired,
 	...deprecatedProps
 };
-
 //#endregion
-exports.EditInPlace = EditInPlace;
+exports.EditInPlace = EditInPlace;

package/lib/components/EditSidePanel/EditSidePanel.js

@@ -5,19 +5,18 @@
  * 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');
-require('../../global/js/utils/props-helper.js');
-const require_uuidv4 = require('../../global/js/utils/uuidv4.js');
-const require_SidePanel = require('../SidePanel/SidePanel.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");
+require("../../global/js/utils/props-helper.js");
+const require_uuidv4 = require("../../global/js/utils/uuidv4.js");
+const require_SidePanel = require("../SidePanel/SidePanel.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/EditSidePanel/EditSidePanel.tsx
 var import_classnames = /* @__PURE__ */ require_runtime.__toESM(require_index.default);
 const blockClass = `${require_settings.pkg.prefix}--edit-side-panel`;
@@ -76,20 +75,72 @@ EditSidePanel.deprecated = {
 };
 EditSidePanel.displayName = componentName;
 EditSidePanel.propTypes = {
+	/**
+	* Sets the body content of the create side panel
+	*/
+	/**@ts-ignore*/
 	children: prop_types.default.oneOfType([prop_types.default.arrayOf(prop_types.default.node), prop_types.default.node]).isRequired,
+	/**
+	* Provide an optional class to be applied to the containing node.
+	*/
 	className: prop_types.default.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: prop_types.default.bool,
+	/**
+	* Specifies an optional field that provides a additional context for a form
+	*/
 	formDescription: prop_types.default.node,
+	/**
+	* Specifies a required field that provides a title for a form
+	*/
 	formTitle: prop_types.default.node.isRequired,
+	/**
+	* Unique identifier
+	*/
 	id: prop_types.default.string,
+	/**
+	* Specifies an optional handler which is called when the CreateSidePanel
+	* is closed.
+	*/
 	onRequestClose: prop_types.default.func,
+	/**
+	* Specifies an optional handler which is called when the CreateSidePanel
+	* primary button is pressed.
+	*/
 	onRequestSubmit: prop_types.default.func,
+	/**
+	* Specifies whether the CreateSidePanel is open or not.
+	*/
 	open: prop_types.default.bool.isRequired,
+	/**
+	* Determines if the side panel is on the right or left
+	*/
 	placement: prop_types.default.oneOf(["left", "right"]),
+	/**
+	* Specifies the primary button's text in the modal.
+	*/
 	primaryButtonText: prop_types.default.string.isRequired,
+	/**
+	* Specifies the secondary button's text in the modal.
+	*/
 	secondaryButtonText: prop_types.default.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: prop_types.default.string,
+	/**
+	* Specifies which DOM element in the form should be focused.
+	*/
+	/**@ts-ignore*/
 	selectorPrimaryFocus: prop_types.default.node.isRequired,
+	/**
+	* Sets the size of the side panel
+	*/
 	size: prop_types.default.oneOf([
 		"xs",
 		"sm",
@@ -97,11 +148,23 @@ EditSidePanel.propTypes = {
 		"lg",
 		"2xl"
 	]),
+	/**
+	* Specifies which DOM element in the form should be focused.
+	*/
 	slideIn: prop_types.default.bool,
+	/**
+	*  **Experimental:** Provide a `Slug` component to be rendered inside the `SidePanel` component
+	*/
 	slug: prop_types.default.node,
+	/**
+	* The subtitle of the CreateSidePanel is optional and serves to provide more information about the modal.
+	*/
 	subtitle: prop_types.default.node,
+	/**
+	* The title of the CreateSidePanel is usually the product or service name.
+	*/
+	/**@ts-ignore*/
 	title: prop_types.default.node.isRequired
 };
-
 //#endregion
-exports.EditSidePanel = EditSidePanel;
+exports.EditSidePanel = EditSidePanel;

package/lib/components/EditTearsheet/EditTearsheet.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_props_helper = require('../../global/js/utils/props-helper.js');
-const require_TearsheetShell = require('../Tearsheet/TearsheetShell.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_props_helper = require("../../global/js/utils/props-helper.js");
+const require_TearsheetShell = require("../Tearsheet/TearsheetShell.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/EditTearsheet/EditTearsheet.tsx
 /**
 * Copyright IBM Corp. 2022, 2023
@@ -118,23 +117,74 @@ EditTearsheet.deprecated = {
 };
 EditTearsheet.displayName = componentName;
 EditTearsheet.propTypes = {
+	/**
+	* The cancel button text
+	*/
 	cancelButtonText: prop_types.default.string,
+	/**
+	* The main content of the tearsheet
+	*/
 	children: prop_types.default.node,
+	/**
+	* An optional class or classes to be added to the outermost element.
+	*/
 	className: prop_types.default.string,
+	/**
+	* A description of the flow, displayed in the header area of the tearsheet.
+	*/
 	description: prop_types.default.node,
+	/**
+	* Used to set the size of the influencer
+	*/
 	influencerWidth: prop_types.default.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: prop_types.default.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: prop_types.default.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: prop_types.default.func,
+	/**
+	* Specify a handler for submitting the tearsheet.
+	*/
 	onRequestSubmit: prop_types.default.func.isRequired,
+	/**
+	* Specifies whether the tearsheet is currently open.
+	*/
 	open: prop_types.default.bool,
+	/**
+	* Specifies the aria label for the SideNav from Carbon UIShell
+	*/
 	sideNavAriaLabel: prop_types.default.string,
+	/**
+	* The submit button text
+	*/
 	submitButtonText: prop_types.default.string,
+	/**
+	* The main title of the tearsheet, displayed in the header area.
+	*/
 	title: prop_types.default.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: prop_types.default.oneOf(["normal", "lower"])
 };
-
 //#endregion
 exports.EditTearsheet = EditTearsheet;
 exports.FormContext = FormContext;
-exports.FormNumberContext = FormNumberContext;
+exports.FormNumberContext = FormNumberContext;