@carbon/ibm-products 2.89.0 → 2.90.0

package/es/components/Datagrid/useRowIsMouseOver.js

@@ -7,7 +7,6 @@
 
 import { debounce } from "../../global/js/utils/debounce.js";
 import { useCallback, useState } from "react";
-
 //#region src/components/Datagrid/useRowIsMouseOver.ts
 /**
 * Copyright IBM Corp. 2024, 2025
@@ -41,6 +40,5 @@ const useRowIsMouseOver = (hooks) => {
 	hooks.useInstance.push(useInstance);
 };
 const useDebounce = (fn, wait) => useCallback(debounce(fn, wait), []);
-
 //#endregion
-export { useRowIsMouseOver as default };
+export { useRowIsMouseOver as default };

package/es/components/Datagrid/useRowRenderer.js

@@ -6,7 +6,6 @@
  */
 
 import DatagridRow from "./Datagrid/DatagridRow.js";
-
 //#region src/components/Datagrid/useRowRenderer.js
 /**
 * Copyright IBM Corp. 2024
@@ -53,6 +52,5 @@ const useRowRenderer = (hooks) => {
 	};
 	hooks.useInstance.push(useInstance);
 };
-
 //#endregion
-export { useRowRenderer as default };
+export { useRowRenderer as default };

package/es/components/Datagrid/useRowSize.js

@@ -7,7 +7,6 @@
 
 import RowSizeDropdown from "./Datagrid/addons/RowSize/RowSizeDropdown.js";
 import { useState } from "react";
-
 //#region src/components/Datagrid/useRowSize.js
 /**
 * Copyright IBM Corp. 2020, 2024
@@ -42,6 +41,5 @@ const useRowSize = (hooks) => {
 	};
 	hooks.getTableProps.push(getTableProps);
 };
-
 //#endregion
-export { useRowSize as default };
+export { useRowSize as default };

package/es/components/Datagrid/useSelectAllToggle.js

@@ -9,10 +9,9 @@ import { __toESM } from "../../_virtual/_rolldown/runtime.js";
 import { require_classnames } from "../../node_modules/classnames/index.js";
 import { pkg } from "../../settings.js";
 import { useIsomorphicEffect } from "../../global/js/hooks/useIsomorphicEffect.js";
-import { selectionColumnId } from "./common-column-ids.js";
+import "./common-column-ids.js";
 import SelectAllWithToggle from "./Datagrid/DatagridSelectAllWithToggle.js";
 import React, { useState } from "react";
-
 //#region src/components/Datagrid/useSelectAllToggle.tsx
 /**
 * Copyright IBM Corp. 2021, 2024
@@ -30,7 +29,7 @@ const useSelectAllWithToggleComponent = (hooks) => {
 	const useInstance = (instance) => {
 		const { headers, DatagridPagination } = instance;
 		const headersWithSelectAllToggle = headers?.map((header) => {
-			if (header.id === selectionColumnId && DatagridPagination) Object.assign(header, { Header });
+			if (header.id === "datagridSelection" && DatagridPagination) Object.assign(header, { Header });
 			return header;
 		});
 		Object.assign(instance, { headers: headersWithSelectAllToggle });
@@ -51,7 +50,7 @@ const useAddClassNameToSelectRow = (hooks) => {
 		const { column } = data.cell;
 		const { DatagridPagination, columns, withStickyColumn } = data.instance;
 		const isFirstColumnStickyLeft = columns[0]?.sticky === "left" && withStickyColumn;
-		if (column.id === selectionColumnId && DatagridPagination) return [props, { className: (0, import_classnames.default)(`${blockClass}-toggle-on`, { [`${blockClass}-sticky-left`]: isFirstColumnStickyLeft && windowSize > 671 }) }];
+		if (column.id === "datagridSelection" && DatagridPagination) return [props, { className: (0, import_classnames.default)(`${blockClass}-toggle-on`, { [`${blockClass}-sticky-left`]: isFirstColumnStickyLeft && windowSize > 671 }) }];
 		return [props];
 	});
 };
@@ -69,6 +68,5 @@ const Header = (gridState) => {
 	};
 	return /* @__PURE__ */ React.createElement(SelectAllWithToggle, props);
 };
-
 //#endregion
-export { useSelectAllToggle as default };
+export { useSelectAllToggle as default };

package/es/components/Datagrid/useSelectRows.js

@@ -14,7 +14,6 @@ import { selectionColumnId } from "./common-column-ids.js";
 import { SelectAll } from "./Datagrid/DatagridSelectAll.js";
 import React, { useCallback, useState } from "react";
 import { TableSelectRow, usePrefix } from "@carbon/react";
-
 //#region src/components/Datagrid/useSelectRows.tsx
 /**
 * Copyright IBM Corp. 2020, 2025
@@ -126,6 +125,5 @@ const SelectRow = (datagridState) => {
 		disabled: selectDisabled
 	});
 };
-
 //#endregion
-export { useSelectRows as default };
+export { useSelectRows as default };

package/es/components/Datagrid/useSkeletonRows.js

@@ -26,6 +26,5 @@ const useSkeletons = (hooks) => {
 	};
 	hooks.useInstance.push(useInstance);
 };
-
 //#endregion
-export { useSkeletons as default };
+export { useSkeletons as default };

package/es/components/Datagrid/useSortableColumns.js

@@ -13,7 +13,6 @@ import { SelectAll } from "./Datagrid/DatagridSelectAll.js";
 import React from "react";
 import { Button, usePrefix } from "@carbon/react";
 import { ArrowDown, ArrowUp, ArrowsVertical } from "@carbon/react/icons";
-
 //#region src/components/Datagrid/useSortableColumns.tsx
 /**
 * Copyright IBM Corp. 2020, 2025
@@ -113,6 +112,5 @@ const useSortableColumns = (hooks) => {
 	hooks.visibleColumns.push(sortableVisibleColumns);
 	hooks.useInstance.push(sortInstanceProps);
 };
-
 //#endregion
-export { useSortableColumns as default, getNewSortOrder };
+export { useSortableColumns as default, getNewSortOrder };

package/es/components/Datagrid/useStickyColumn.js

@@ -11,7 +11,6 @@ import { pkg } from "../../settings.js";
 import { useIsomorphicEffect } from "../../global/js/hooks/useIsomorphicEffect.js";
 import { debounce } from "../../global/js/utils/debounce.js";
 import { useEffect, useRef, useState } from "react";
-
 //#region src/components/Datagrid/useStickyColumn.ts
 /**
 * Copyright IBM Corp. 2021, 2025
@@ -156,6 +155,5 @@ const hasVertScroll = (element) => {
 	const { scrollHeight, clientHeight } = element;
 	return scrollHeight > clientHeight;
 };
-
 //#endregion
-export { useStickyColumn as default };
+export { useStickyColumn as default };

package/es/components/Datagrid/utils/getAutoSizedColumnWidth.js

@@ -14,6 +14,5 @@ const getAutoSizedColumnWidth = (rows, accessor, headerText) => {
 	if (cellLength <= 3) return minWidth;
 	return Math.min(maxWidth, cellLength * letterSpacing + 16);
 };
-
 //#endregion
-export { getAutoSizedColumnWidth };
+export { getAutoSizedColumnWidth };

package/es/components/Decorator/Decorator.js

@@ -11,7 +11,6 @@ import { prepareProps } from "../../global/js/utils/props-helper.js";
 import { DecoratorBase } from "../DecoratorBase/DecoratorBase.js";
 import React from "react";
 import PropTypes from "prop-types";
-
 //#region src/components/Decorator/Decorator.jsx
 /**
 * Copyright IBM Corp. 2024, 2024
@@ -44,22 +43,75 @@ let Decorator = React.forwardRef((props, ref) => {
 Decorator = pkg.checkComponentEnabled(Decorator, componentName);
 Decorator.displayName = componentName;
 Decorator.propTypes = {
+	/**
+	* Provide an optional class to be applied to the containing node.
+	*/
 	className: PropTypes.string,
+	/**
+	* Do not show the icon, regardless of score.
+	*/
 	hideIcon: PropTypes.bool,
+	/**
+	* The label for the data.
+	*/
 	label: PropTypes.string,
+	/**
+	* Used in conjunction with `scoreThresholds`, determines the color, shape, and type of magnitude of the icon.
+	*
+	* If you don't want to show the icon at all, set `hideIcon={true}`.
+	*/
 	score: PropTypes.number,
+	/**
+	* Used in conjunction with `score`, determines the color, shape, and type of magnitude of the icon.
+	*
+	* An array of 4 numbers determines the range of thresholds.
+	*
+	* Example using `[0, 4, 7, 10]`:
+	* <br/>- `<= 0` "Benign"
+	* <br/>- `1-3` "Low"
+	* <br/>- `4-6` "Medium"
+	* <br/>- `7-9` "High"
+	* <br/>- `>= 10` "Critical"
+	* <br/>- `NaN` "Unknown"
+	*/
 	scoreThresholds: PropTypes.arrayOf(PropTypes.number),
+	/**
+	* Optional callback function for building a more detailed descriptive text.
+	* Returns `score`, `scoreThresholds`, `magnitude`.
+	*
+	* Typical description is in the form of
+	* '"(magnitude)" magnitude: score (score) out of (last element of scoreThresholds array)'.
+	*
+	* E.g. `"Medium" magnitude: score 5 out of 10`.
+	*
+	* If not defined, the title will default to the `label` prop.
+	*/
 	setLabelTitle: PropTypes.func,
+	/**
+	* Styled smaller to better fit inline with text.
+	*/
 	small: PropTypes.bool,
+	/**
+	* Override the default theme of the component.
+	* Useful if you want "invert" the component's theme.
+	*/
 	theme: PropTypes.oneOf(["light", "dark"]),
+	/**
+	* If not defined, it will behave as `display:inline-block`.
+	*/
 	truncateValue: PropTypes.oneOfType([PropTypes.oneOf(["end", "start"]), PropTypes.shape({
 		maxLength: PropTypes.number,
 		front: PropTypes.number,
 		back: PropTypes.number
 	})]),
+	/**
+	* The value of the data.
+	*/
 	value: PropTypes.string.isRequired,
+	/**
+	* Overrides the default title for the Decorator's value.
+	*/
 	valueTitle: PropTypes.string
 };
-
 //#endregion
-export { Decorator };
+export { Decorator };

package/es/components/DecoratorBase/DecoratorBase.js

@@ -12,7 +12,6 @@ import { getMagnitude, truncate } from "./utils.js";
 import { DecoratorIcon } from "./DecoratorIcon.js";
 import React from "react";
 import PropTypes from "prop-types";
-
 //#region src/components/DecoratorBase/DecoratorBase.jsx
 /**
 * Copyright IBM Corp. 2024, 2024
@@ -174,6 +173,9 @@ DecoratorBase.propTypes = {
 	disabled: PropTypes.bool,
 	hideIcon: PropTypes.bool,
 	href: PropTypes.string,
+	/**
+	* `kind` differentiates between each type of Decorator, and is for internal use only.
+	*/
 	kind: PropTypes.oneOf([
 		"default",
 		"link",
@@ -200,6 +202,5 @@ DecoratorBase.propTypes = {
 	value: PropTypes.string.isRequired,
 	valueTitle: PropTypes.string
 };
-
 //#endregion
-export { DecoratorBase };
+export { DecoratorBase };

package/es/components/DecoratorBase/DecoratorIcon.js

@@ -12,7 +12,6 @@ import { getDevtoolsProps } from "../../global/js/utils/devtools.js";
 import React from "react";
 import PropTypes from "prop-types";
 import { Caution, ChevronMini, CircleFill, CircleStroke, DiamondFill, SquareFill } from "@carbon/react/icons";
-
 //#region src/components/DecoratorBase/DecoratorIcon.jsx
 /**
 * Copyright IBM Corp. 2024, 2024
@@ -65,7 +64,13 @@ let DecoratorIcon = React.forwardRef(({ className, magnitude = defaults.magnitud
 DecoratorIcon = pkg.checkComponentEnabled(DecoratorIcon, componentName);
 DecoratorIcon.displayName = componentName;
 DecoratorIcon.propTypes = {
+	/**
+	* Provide an optional class to be applied to the containing node.
+	*/
 	className: PropTypes.string,
+	/**
+	* Determines the shape and color of the icon.
+	*/
 	magnitude: PropTypes.oneOf([
 		"unknown",
 		"benign",
@@ -74,8 +79,10 @@ DecoratorIcon.propTypes = {
 		"high",
 		"critical"
 	]),
+	/**
+	* Reduce the size of the icon in proportion to a smaller Decorator.
+	*/
 	small: PropTypes.bool
 };
-
 //#endregion
-export { DecoratorIcon };
+export { DecoratorIcon };

package/es/components/DecoratorBase/utils.js

@@ -26,6 +26,5 @@ const truncate = (inputText, truncateValue) => {
 	if (maxLength && inputText.length > maxLength) return `${inputText.substring(0, front)}…${inputText.substr(inputText.length - back)}`;
 	return inputText;
 };
-
 //#endregion
-export { getMagnitude, truncate };
+export { getMagnitude, truncate };

package/es/components/DecoratorDualButton/DecoratorDualButton.js

@@ -11,7 +11,6 @@ import { prepareProps } from "../../global/js/utils/props-helper.js";
 import { DecoratorBase } from "../DecoratorBase/DecoratorBase.js";
 import React from "react";
 import PropTypes from "prop-types";
-
 //#region src/components/DecoratorDualButton/DecoratorDualButton.jsx
 /**
 * Copyright IBM Corp. 2024, 2024
@@ -45,27 +44,99 @@ DecoratorDualButton.deprecated = {
 DecoratorDualButton = pkg.checkComponentEnabled(DecoratorDualButton, componentName);
 DecoratorDualButton.displayName = componentName;
 DecoratorDualButton.propTypes = {
+	/**
+	* Provide an optional class to be applied to the containing node.
+	*/
 	className: PropTypes.string,
+	/**
+	* `disabled` only applies if `kind` is "single-button" or "dual-button".
+	*/
 	disabled: PropTypes.bool,
+	/**
+	* Do not show the icon, regardless of score.
+	*/
 	hideIcon: PropTypes.bool,
+	/**
+	* The label for the data.
+	*/
 	label: PropTypes.string,
+	/**
+	* Optional callback function.
+	* Returns two objects: `event` and `{ score, label, value, magnitude }`
+	*/
 	onClickLabel: PropTypes.func,
+	/**
+	* Optional callback function.
+	* Returns two objects: `event` and `{ score, label, value, magnitude }`
+	*/
 	onClickValue: PropTypes.func,
+	/**
+	* Optional callback function.
+	* Returns two objects: `event` and `{ score, label, value, magnitude }`
+	*/
 	onContextMenuLabel: PropTypes.func,
+	/**
+	* Optional callback function.
+	* Returns two objects: `event` and `{ score, label, value, magnitude }`
+	*/
 	onContextMenuValue: PropTypes.func,
+	/**
+	* Used in conjunction with `scoreThresholds`, determines the color, shape, and type of magnitude of the icon.
+	*
+	* If you don't want to show the icon at all, set `hideIcon={true}`.
+	*/
 	score: PropTypes.number,
+	/**
+	* Used in conjunction with `score`, determines the color, shape, and type of magnitude of the icon.
+	*
+	* An array of 4 numbers determines the range of thresholds.
+	*
+	* Example using `[0, 4, 7, 10]`:
+	* <br/>- `<= 0` "Benign"
+	* <br/>- `1-3` "Low"
+	* <br/>- `4-6` "Medium"
+	* <br/>- `7-9` "High"
+	* <br/>- `>= 10` "Critical"
+	* <br/>- `NaN` "Unknown"
+	*/
 	scoreThresholds: PropTypes.arrayOf(PropTypes.number),
+	/**
+	* Optional callback function for building a more detailed descriptive text.
+	* Returns `score`, `scoreThresholds`, `magnitude`.
+	*
+	* Typical description is in the form of
+	* '"(magnitude)" magnitude: score (score) out of (last element of scoreThresholds array)'.
+	*
+	* E.g. `"Medium" magnitude: score 5 out of 10`.
+	*
+	* If not defined, the title will default to the `label` prop.
+	*/
 	setLabelTitle: PropTypes.func,
+	/**
+	* Styled smaller to better fit inline with text.
+	*/
 	small: PropTypes.bool,
+	/**
+	* Override the default theme of the component.
+	* Useful if you want "invert" the component's theme.
+	*/
 	theme: PropTypes.oneOf(["light", "dark"]),
+	/**
+	* If not defined, it will behave as `display:inline-block`.
+	*/
 	truncateValue: PropTypes.oneOfType([PropTypes.oneOf(["end", "start"]), PropTypes.shape({
 		maxLength: PropTypes.number,
 		front: PropTypes.number,
 		back: PropTypes.number
 	})]),
+	/**
+	* The value of the data.
+	*/
 	value: PropTypes.string.isRequired,
+	/**
+	* Overrides the default title for the Decorator's value.
+	*/
 	valueTitle: PropTypes.string
 };
-
 //#endregion
-export { DecoratorDualButton };
+export { DecoratorDualButton };

package/es/components/DecoratorLink/DecoratorLink.js

@@ -11,7 +11,6 @@ import { prepareProps } from "../../global/js/utils/props-helper.js";
 import { DecoratorBase } from "../DecoratorBase/DecoratorBase.js";
 import React from "react";
 import PropTypes from "prop-types";
-
 //#region src/components/DecoratorLink/DecoratorLink.jsx
 /**
 * Copyright IBM Corp. 2024, 2024
@@ -47,25 +46,89 @@ DecoratorLink.deprecated = {
 DecoratorLink = pkg.checkComponentEnabled(DecoratorLink, componentName);
 DecoratorLink.displayName = componentName;
 DecoratorLink.propTypes = {
+	/**
+	* Provide an optional class to be applied to the containing node.
+	*/
 	className: PropTypes.string,
+	/**
+	* Do not show the icon, regardless of score.
+	*/
 	hideIcon: PropTypes.bool,
+	/**
+	* The component's URL.
+	*/
 	href: PropTypes.string.isRequired,
+	/**
+	* The label for the data.
+	*/
 	label: PropTypes.string,
+	/**
+	* Optional callback function.
+	* Returns two objects: `event` and `{ score, label, value, magnitude }`
+	*/
 	onClick: PropTypes.func,
+	/**
+	* Optional callback function.
+	* Returns two objects: `event` and `{ score, label, value, magnitude }`
+	*/
 	onContextMenu: PropTypes.func,
+	/**
+	* Used in conjunction with `scoreThresholds`, determines the color, shape, and type of magnitude of the icon.
+	*
+	* If you don't want to show the icon at all, set `hideIcon={true}`.
+	*/
 	score: PropTypes.number,
+	/**
+	* Used in conjunction with `score`, determines the color, shape, and type of magnitude of the icon.
+	*
+	* An array of 4 numbers determines the range of thresholds.
+	*
+	* Example using `[0, 4, 7, 10]`:
+	* <br/>- `<= 0` "Benign"
+	* <br/>- `1-3` "Low"
+	* <br/>- `4-6` "Medium"
+	* <br/>- `7-9` "High"
+	* <br/>- `>= 10` "Critical"
+	* <br/>- `NaN` "Unknown"
+	*/
 	scoreThresholds: PropTypes.arrayOf(PropTypes.number),
+	/**
+	* Optional callback function for building a more detailed descriptive text.
+	* Returns `score`, `scoreThresholds`, `magnitude`.
+	*
+	* Typical description is in the form of
+	* '"(magnitude)" magnitude: score (score) out of (last element of scoreThresholds array)'.
+	*
+	* E.g. `"Medium" magnitude: score 5 out of 10`.
+	*
+	* If not defined, the title will default to the `label` prop.
+	*/
 	setLabelTitle: PropTypes.func,
+	/**
+	* Styled smaller to better fit inline with text.
+	*/
 	small: PropTypes.bool,
+	/**
+	* Override the default theme of the component.
+	* Useful if you want "invert" the component's theme.
+	*/
 	theme: PropTypes.oneOf(["light", "dark"]),
+	/**
+	* If not defined, it will behave as `display:inline-block`.
+	*/
 	truncateValue: PropTypes.oneOfType([PropTypes.oneOf(["end", "start"]), PropTypes.shape({
 		maxLength: PropTypes.number,
 		front: PropTypes.number,
 		back: PropTypes.number
 	})]),
+	/**
+	* The value of the data.
+	*/
 	value: PropTypes.string.isRequired,
+	/**
+	* Overrides the default title for the Decorator's value.
+	*/
 	valueTitle: PropTypes.string
 };
-
 //#endregion
-export { DecoratorLink };
+export { DecoratorLink };

package/es/components/DecoratorSingleButton/DecoratorSingleButton.js

@@ -11,7 +11,6 @@ import { prepareProps } from "../../global/js/utils/props-helper.js";
 import { DecoratorBase } from "../DecoratorBase/DecoratorBase.js";
 import React from "react";
 import PropTypes from "prop-types";
-
 //#region src/components/DecoratorSingleButton/DecoratorSingleButton.jsx
 /**
 * Copyright IBM Corp. 2024, 2024
@@ -47,25 +46,89 @@ DecoratorSingleButton.deprecated = {
 DecoratorSingleButton = pkg.checkComponentEnabled(DecoratorSingleButton, componentName);
 DecoratorSingleButton.displayName = componentName;
 DecoratorSingleButton.propTypes = {
+	/**
+	* Provide an optional class to be applied to the containing node.
+	*/
 	className: PropTypes.string,
+	/**
+	* `disabled` only applies if `kind` is "single-button" or "dual-button".
+	*/
 	disabled: PropTypes.bool,
+	/**
+	* Do not show the icon, regardless of score.
+	*/
 	hideIcon: PropTypes.bool,
+	/**
+	* The label for the data.
+	*/
 	label: PropTypes.string,
+	/**
+	* Optional callback function.
+	* Returns two objects: `event` and `{ score, label, value, magnitude }`
+	*/
 	onClick: PropTypes.func,
+	/**
+	* Optional callback function.
+	* Returns two objects: `event` and `{ score, label, value, magnitude }`
+	*/
 	onContextMenu: PropTypes.func,
+	/**
+	* Used in conjunction with `scoreThresholds`, determines the color, shape, and type of magnitude of the icon.
+	*
+	* If you don't want to show the icon at all, set `hideIcon={true}`.
+	*/
 	score: PropTypes.number,
+	/**
+	* Used in conjunction with `score`, determines the color, shape, and type of magnitude of the icon.
+	*
+	* An array of 4 numbers determines the range of thresholds.
+	*
+	* Example using `[0, 4, 7, 10]`:
+	* <br/>- `<= 0` "Benign"
+	* <br/>- `1-3` "Low"
+	* <br/>- `4-6` "Medium"
+	* <br/>- `7-9` "High"
+	* <br/>- `>= 10` "Critical"
+	* <br/>- `NaN` "Unknown"
+	*/
 	scoreThresholds: PropTypes.arrayOf(PropTypes.number),
+	/**
+	* Optional callback function for building a more detailed descriptive text.
+	* Returns `score`, `scoreThresholds`, `magnitude`.
+	*
+	* Typical description is in the form of
+	* '"(magnitude)" magnitude: score (score) out of (last element of scoreThresholds array)'.
+	*
+	* E.g. `"Medium" magnitude: score 5 out of 10`.
+	*
+	* If not defined, the title will default to the `label` prop.
+	*/
 	setLabelTitle: PropTypes.func,
+	/**
+	* Styled smaller to better fit inline with text.
+	*/
 	small: PropTypes.bool,
+	/**
+	* Override the default theme of the component.
+	* Useful if you want "invert" the component's theme.
+	*/
 	theme: PropTypes.oneOf(["light", "dark"]),
+	/**
+	* If not defined, it will behave as `display:inline-block`.
+	*/
 	truncateValue: PropTypes.oneOfType([PropTypes.oneOf(["end", "start"]), PropTypes.shape({
 		maxLength: PropTypes.number,
 		front: PropTypes.number,
 		back: PropTypes.number
 	})]),
+	/**
+	* The value of the data.
+	*/
 	value: PropTypes.string.isRequired,
+	/**
+	* Overrides the default title for the Decorator's value.
+	*/
 	valueTitle: PropTypes.string
 };
-
 //#endregion
-export { DecoratorSingleButton };
+export { DecoratorSingleButton };

package/es/components/DelimitedList/DelimitedList.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/DelimitedList/DelimitedList.tsx
 /**
 * Copyright IBM Corp. 2024, 2024
@@ -47,11 +46,22 @@ DelimitedList.deprecated = {
 };
 DelimitedList.displayName = componentName;
 DelimitedList.propTypes = {
+	/**
+	* Provide an optional class to be applied to the containing node.
+	*/
 	className: PropTypes.string,
+	/**
+	* The character(s) used to separate the items.
+	*/
 	delimiter: PropTypes.string,
+	/**
+	* Array of items to be listed.
+	*/
 	items: PropTypes.arrayOf(PropTypes.any),
+	/**
+	* Toggle the component's ability to truncate or not.
+	*/
 	truncate: PropTypes.bool
 };
-
 //#endregion
-export { DelimitedList };
+export { DelimitedList };

package/es/components/DescriptionList/DescriptionList.js

@@ -13,7 +13,6 @@ import { DescriptionListSize } from "./constants.js";
 import React from "react";
 import PropTypes from "prop-types";
 import { StructuredListWrapper } from "@carbon/react";
-
 //#region src/components/DescriptionList/DescriptionList.jsx
 /**
 * Copyright IBM Corp. 2024, 2024
@@ -53,11 +52,14 @@ DescriptionList.deprecated = {
 DescriptionList = pkg.checkComponentEnabled(DescriptionList, componentName);
 DescriptionList.displayName = componentName;
 DescriptionList.propTypes = {
+	/** Specify if the type layout has a border */
 	border: PropTypes.bool,
+	/** Provide the contents of the node */
 	children: PropTypes.node,
+	/** Provide an optional class to be applied to the containing node */
 	className: PropTypes.string,
+	/** Specify the size of the type layout, from a list of available sizes */
 	size: PropTypes.oneOf(Object.values(DescriptionListSize))
 };
-
 //#endregion
-export { DescriptionList };
+export { DescriptionList };