From 3159fa2864b9f1cd560a82cd81550eff1f66616a Mon Sep 17 00:00:00 2001
From: Ankit Kumar Shah <ankit.shah@rtcamp.com>
Date: Wed, 18 Dec 2024 19:45:35 +0530
Subject: [PATCH] Storybook: Add stories for BlockCard component (#67191)

* Doc: add story file for BlockCard

* Refactor: Refactor `block-card` storybook

* Refactor: Remove redundant doc comment

* Refactor: `BlockCard` story docs

* Refactor: `BlockCard` story docs

Co-authored-by: Infinite-Null <ankitkumarshah@git.wordpress.org>
Co-authored-by: t-hamano <wildworks@git.wordpress.org>
---
 .../block-card/stories/index.story.js         | 79 +++++++++++++++++++
 1 file changed, 79 insertions(+)
 create mode 100644 packages/block-editor/src/components/block-card/stories/index.story.js

diff --git a/packages/block-editor/src/components/block-card/stories/index.story.js b/packages/block-editor/src/components/block-card/stories/index.story.js
new file mode 100644
index 00000000000000..0fe68e2032d394
--- /dev/null
+++ b/packages/block-editor/src/components/block-card/stories/index.story.js
@@ -0,0 +1,79 @@
+/**
+ * WordPress dependencies
+ */
+import { box, button, cog, paragraph } from '@wordpress/icons';
+
+/**
+ * Internal dependencies
+ */
+import BlockCard from '../';
+
+const meta = {
+	title: 'BlockEditor/BlockCard',
+	component: BlockCard,
+	parameters: {
+		docs: {
+			description: {
+				component:
+					'The `BlockCard` component allows to display a "card" which contains the title of a block, its icon and its description.',
+			},
+			canvas: { sourceState: 'shown' },
+		},
+	},
+	argTypes: {
+		title: {
+			control: 'text',
+			description: 'The title of the block.',
+			table: {
+				type: { summary: 'string' },
+			},
+		},
+		description: {
+			control: 'text',
+			description: 'A description of the block functionality.',
+			table: {
+				type: { summary: 'string' },
+			},
+		},
+		icon: {
+			control: 'select',
+			options: [ 'paragraph', 'cog', 'box', 'button' ],
+			mapping: {
+				paragraph,
+				cog,
+				box,
+				button,
+			},
+			description:
+				'The icon of the block. This can be any of [WordPress Dashicons](https://developer.wordpress.org/resource/dashicons/), or a custom `svg` element.',
+			table: {
+				type: { summary: 'string | object' },
+			},
+		},
+		name: {
+			control: 'text',
+			description: 'Optional custom name for the block.',
+			table: {
+				type: { summary: 'string' },
+			},
+		},
+		className: {
+			control: 'text',
+			description: 'Additional CSS class names.',
+			table: {
+				type: { summary: 'string' },
+			},
+		},
+	},
+};
+
+export default meta;
+
+export const Default = {
+	args: {
+		title: 'Paragraph',
+		icon: paragraph,
+		description: 'This is a paragraph block description.',
+		name: 'Paragraph Block',
+	},
+};