UI: Match item JSDoc to package conventions

mirka · Sep 29, 2026 · Sep 24, 2026 · Sep 24, 2026 · Sep 25, 2026 · Sep 28, 2026
commit 6fc7bf8dc1044a749d8b7c6d14a8513436e04c32
@@ -4,7 +4,9 @@ import { Text } from '../../../text';
 import itemPopupStyles from '../../../utils/css/item-popup.module.css';
 import type { AutocompleteItemDescriptionProps } from './types';
 
-/** Supplementary text below an autocomplete item label. */
+/**
+ * Supplementary text below an autocomplete item label.
+ */
 export const ItemDescription = forwardRef<
 	HTMLSpanElement,
 	AutocompleteItemDescriptionProps

@@ -4,7 +4,9 @@ import { Text } from '../../../text';
 import itemPopupStyles from '../../../utils/css/item-popup.module.css';
 import type { AutocompleteItemLabelProps } from './types';
 
-/** The primary label and accessible name of an autocomplete item. */
+/**
+ * The primary label and accessible name of an autocomplete item.
+ */
 export const ItemLabel = forwardRef<
 	HTMLSpanElement,
 	AutocompleteItemLabelProps

@@ -90,7 +90,9 @@ export const Default: Story = {
 	},
 };
 
-/** Item descriptions appear below labels and contribute to each suggestion's accessible description. */
+/**
+ * Item descriptions appear below labels and contribute to each suggestion's accessible description.
+ */
 export const WithItemDescriptions: Story = {
 	args: {
 		items: URLS.slice( 0, 3 ),

@@ -45,12 +45,16 @@ export type AutocompleteInputGroupProps = ComponentProps<
 };
 
 export interface AutocompleteItemLabelProps extends ComponentProps< 'span' > {
-	/** The primary label and accessible name of an autocomplete item. */
+	/**
+	 * The primary label and accessible name of an autocomplete item.
+	 */
 	children: ReactNode;
 }
 
 export interface AutocompleteItemDescriptionProps extends ComponentProps< 'span' > {
-	/** Supplementary content described by the autocomplete item. */
+	/**
+	 * Supplementary content described by the autocomplete item.
+	 */
 	children: ReactNode;
 }
 
@@ -70,7 +74,9 @@ export type AutocompleteItemProps = Omit<
 	ComponentProps< typeof _Autocomplete.Item >,
 	'children'
 > & {
-	/** One direct ItemLabel, followed by zero or more ItemDescription components. */
+	/**
+	 * One direct ItemLabel, followed by zero or more ItemDescription components.
+	 */
 	children: AutocompleteItemChildren;
 };
 

@@ -60,12 +60,16 @@ export type ComboboxInputGroupProps = ComponentProps<
 };
 
 export interface ComboboxItemLabelProps extends ComponentProps< 'span' > {
-	/** The primary label and accessible name of a combobox item. */
+	/**
+	 * The primary label and accessible name of a combobox item.
+	 */
 	children: ReactNode;
 }
 
 export interface ComboboxItemDescriptionProps extends ComponentProps< 'span' > {
-	/** Supplementary content described by the combobox item. */
+	/**
+	 * Supplementary content described by the combobox item.
+	 */
 	children: ReactNode;
 }
 
@@ -85,7 +89,9 @@ export type ComboboxItemProps = Omit<
 	ComponentProps< typeof _Combobox.Item >,
 	'children'
 > & {
-	/** One direct ItemLabel, followed by zero or more ItemDescription components. */
+	/**
+	 * One direct ItemLabel, followed by zero or more ItemDescription components.
+	 */
 	children: ComboboxItemChildren;
 	/**
 	 * The variant of the item.

@@ -47,7 +47,9 @@ export const Default: Story = {
 	},
 };
 
-/** Item descriptions appear below labels in the popup and are not copied to chips. */
+/**
+ * Item descriptions appear below labels in the popup and are not copied to chips.
+ */
 export const WithItemDescriptions: Story = {
 	args: {
 		...Default.args,

@@ -12,7 +12,9 @@ export type Item = {
 	label: string;
 	value: string;
 	disabled?: boolean;
-	/** Supplementary text shown below the item label in the popup. */
+	/**
+	 * Supplementary text shown below the item label in the popup.
+	 */
 	description?: string;
 	/**
 	 * When `true`, the item renders in the list footer, not the main list,

@@ -43,7 +43,9 @@ export const Default: Story = {
 	},
 };
 
-/** Item descriptions appear below labels in the popup and are not copied to the trigger. */
+/**
+ * Item descriptions appear below labels in the popup and are not copied to the trigger.
+ */
 export const WithItemDescriptions: Story = {
 	args: {
 		...Default.args,

@@ -14,7 +14,9 @@ export type Item = {
 	label: string;
 	value: string;
 	disabled?: boolean;
-	/** Supplementary text shown below the item label in the popup. */
+	/**
+	 * Supplementary text shown below the item label in the popup.
+	 */
 	description?: string;
 	/**
 	 * When `true`, the item renders in the list footer, not the main list,