From dca00751353e8b76b3d96a4bb1ade2eac6ae785e Mon Sep 17 00:00:00 2001
From: George Mamadashvili <georgemamadashvili@gmail.com>
Date: Mon, 10 Oct 2022 11:00:10 +0400
Subject: [PATCH] Add missing props and descriptions

---
 .../components/src/button/stories/index.js    | 113 +++++++++++++++++-
 1 file changed, 112 insertions(+), 1 deletion(-)

diff --git a/packages/components/src/button/stories/index.js b/packages/components/src/button/stories/index.js
index a86238ed89fd8..04571f7b05c7d 100644
--- a/packages/components/src/button/stories/index.js
+++ b/packages/components/src/button/stories/index.js
@@ -21,42 +21,137 @@ export default {
 	argTypes: {
 		label: {
 			control: { type: 'text' },
+			description:
+				'Sets the `aria-label` of the component, if none is provided. Sets the Tooltip content if `showTooltip` is provided.',
+			table: {
+				defaultValue: { summary: '' },
+			},
 		},
 		children: {
 			control: { type: 'text' },
+			table: {
+				defaultValue: { summary: undefined },
+			},
 		},
 		icon: {
 			control: { type: 'select' },
+			description:
+				'If provided, renders an `Icon` component inside the button.',
 			options: [ 'wordpress', 'link', 'more' ],
 			mapping: {
 				wordpress,
 				link,
 				more,
 			},
+			table: {
+				defaultValue: { summary: `null` },
+			},
 		},
 		iconSize: {
 			control: { type: 'number' },
+			description: 'If provided with `icon`, sets the icon size.',
+			table: {
+				defaultValue: { summary: 24 },
+			},
+		},
+		iconPosition: {
+			control: { type: 'select' },
+			description:
+				'If provided with `icon`, sets the position of icon relative to the `text`. Available options are `left|right`.',
+			options: [ 'left', 'right' ],
+			table: {
+				defaultValue: { summary: `left` },
+			},
 		},
 		isBusy: {
 			control: 'boolean',
+			description:
+				'Indicates activity while a action is being performed.',
+			table: {
+				defaultValue: { summary: false },
+			},
 		},
 		isDestructive: {
 			control: 'boolean',
+			description:
+				'Renders a red text-based button style to indicate destructive behavior.',
+			table: {
+				defaultValue: { summary: false },
+			},
+		},
+		isPressed: {
+			control: 'boolean',
+			description: 'Renders a pressed button style.',
+			table: {
+				defaultValue: { summary: false },
+			},
 		},
 		isSmall: {
 			control: 'boolean',
+			description: 'Decreases the size of the button.',
+			table: {
+				defaultValue: { summary: false },
+			},
 		},
 		disabled: {
 			control: 'boolean',
+			description:
+				'Whether the button is disabled. If `true`, this will force a `button` element to be rendered.',
+			table: {
+				defaultValue: { summary: false },
+			},
+		},
+		shortcut: {
+			control: { type: 'text' },
+			description:
+				'If provided with `showTooltip`, appends the Shortcut label to the tooltip content. If an `Object` is provided, it should contain `display` and `ariaLabel` keys.',
+			table: {
+				defaultValue: { summary: 'undefined' },
+			},
+		},
+		showTooltip: {
+			control: 'boolean',
+			description:
+				'If provided, renders a `Tooltip` component for the button.',
+			table: {
+				defaultValue: { summary: false },
+			},
+		},
+		tooltipPosition: {
+			control: { type: 'text' },
+			description:
+				'If provided with `showTooltip`, sets the position of the tooltip.',
+			table: {
+				defaultValue: { summary: 'top center' },
+			},
+		},
+		text: {
+			control: { type: 'text' },
+			description:
+				'If provided, displays the given text inside the button. If the button contains `children` elements, the text is displayed before them.',
+			table: {
+				defaultValue: { summary: '' },
+			},
 		},
 		variant: {
-			options: [ 'primary', 'secondary', 'tertiary', 'link' ],
 			control: { type: 'select' },
+			description: "Specifies the button's style.",
+			options: [ 'primary', 'secondary', 'tertiary', 'link' ],
+			table: {
+				defaultValue: { summary: `undefined` },
+			},
 		},
 		__experimentalIsFocusable: {
 			control: 'boolean',
+			table: {
+				defaultValue: { summary: false },
+			},
 		},
 	},
+	parameters: {
+		controls: { expanded: true },
+		docs: { source: { state: 'open' } },
+	},
 };
 
 function Template( { children, ...props } ) {
@@ -66,11 +161,27 @@ function Template( { children, ...props } ) {
 export const Default = Template.bind( {} );
 Default.args = {
 	children: 'Code is poetry',
+	disabled: false,
+	icon: null,
+	iconSize: 24,
+	iconPosition: 'left',
+	isBusy: false,
+	isDestructive: false,
+	isPressed: false,
+	isSmall: false,
+	label: '',
+	shortcut: undefined,
+	showTooltip: false,
+	tooltipPosition: 'top center',
+	text: '',
 	variant: undefined,
+	__experimentalIsFocusable: false,
 };
 
 export const Icon = Template.bind( {} );
 Icon.args = {
+	...Default.args,
+	children: undefined,
 	label: 'Code is poetry',
 	icon: 'wordpress',
 	iconSize: 24,