From 1a3cd813a57543516158e0cb6b207bcdb4723304 Mon Sep 17 00:00:00 2001
From: Sainath Poojary <spoojary614@gmail.com>
Date: Fri, 22 Nov 2024 18:51:16 +0530
Subject: [PATCH] Doc: Add Storybook for BlockTitle

---
 .../block-title/stories/index.story.js        | 152 ++++++++++++++++++
 1 file changed, 152 insertions(+)
 create mode 100644 packages/block-editor/src/components/block-title/stories/index.story.js

diff --git a/packages/block-editor/src/components/block-title/stories/index.story.js b/packages/block-editor/src/components/block-title/stories/index.story.js
new file mode 100644
index 0000000000000..9015e709ece59
--- /dev/null
+++ b/packages/block-editor/src/components/block-title/stories/index.story.js
@@ -0,0 +1,152 @@
+/**
+ * WordPress dependencies
+ */
+import { registerCoreBlocks } from '@wordpress/block-library';
+import { createBlock } from '@wordpress/blocks';
+import { BlockEditorProvider } from '@wordpress/block-editor';
+
+/**
+ * Internal dependencies
+ */
+import BlockTitle from '../';
+
+// Register core blocks for the story environment
+registerCoreBlocks();
+
+// Create more comprehensive sample blocks for testing
+const blocks = [
+	createBlock( 'core/paragraph', {
+		content: 'This is a sample paragraph block.',
+		className: 'sample-paragraph',
+	} ),
+	createBlock( 'core/heading', {
+		level: 2,
+		content: 'Sample Heading Block',
+	} ),
+	createBlock(
+		'core/group',
+		{
+			layout: { type: 'flex', justifyContent: 'center' },
+		},
+		[
+			createBlock( 'core/paragraph', {
+				content: 'Nested paragraph within a group block',
+			} ),
+		]
+	),
+];
+
+/**
+ * Storybook configuration for BlockTitle component
+ */
+const meta = {
+	title: 'BlockEditor/BlockTitle',
+	component: BlockTitle,
+	parameters: {
+		docs: {
+			canvas: { sourceState: 'shown' },
+			description: {
+				component:
+					"The Block Title component renders a block's configured title as a string.",
+			},
+		},
+	},
+	decorators: [
+		( Story ) => (
+			<BlockEditorProvider value={ blocks }>
+				<div style={ { padding: '20px', backgroundColor: '#f0f0f0' } }>
+					<Story />
+				</div>
+			</BlockEditorProvider>
+		),
+	],
+	argTypes: {
+		clientId: {
+			control: {
+				type: 'select',
+				labels: {
+					[ blocks[ 0 ].clientId ]: "Paragraph's Client ID",
+					[ blocks[ 1 ].clientId ]: "Heading's Client ID",
+					[ blocks[ 2 ].clientId ]: "Group's Client ID",
+					[ blocks[ 2 ].innerBlocks[ 0 ].clientId ]:
+						"Nested Paragraph's Client ID",
+				},
+			},
+			options: [
+				blocks[ 0 ].clientId,
+				blocks[ 1 ].clientId,
+				blocks[ 2 ].clientId,
+				blocks[ 2 ].innerBlocks[ 0 ].clientId,
+			],
+			description: 'The client ID of the block to render',
+		},
+		maximumLength: {
+			control: {
+				type: 'number',
+				min: 5,
+				max: 50,
+				step: 1,
+			},
+			description: 'Maximum length before title truncation',
+		},
+		context: {
+			control: { type: 'text' },
+			description: 'Optional context to pass to getBlockLabel',
+		},
+	},
+};
+
+export default meta;
+
+/**
+ * Story variations demonstrating BlockTitle component capabilities
+ */
+export const Default = {
+	args: {
+		clientId: blocks[ 0 ].clientId,
+	},
+	parameters: {
+		docs: {
+			description: {
+				story: 'Default rendering of BlockTitle for a paragraph block',
+			},
+		},
+	},
+};
+
+/**
+ * Story variations demonstrating BlockTitle component with maximum length
+ */
+export const WithMaxLength = {
+	args: {
+		clientId: blocks[ 0 ].clientId,
+		maximumLength: 5,
+	},
+};
+
+/**
+ * Story variations demonstrating BlockTitle component with client ID of a heading block
+ */
+export const HeadingBlock = {
+	args: {
+		clientId: blocks[ 1 ].clientId,
+	},
+};
+
+/**
+ * Story variations demonstrating BlockTitle component with client ID of a paragraph block
+ */
+export const ParagraphBlock = {
+	args: {
+		clientId: blocks[ 0 ].clientId,
+	},
+};
+
+/**
+ * Story variations demonstrating BlockTitle component with client ID of a nested block within a group
+ */
+export const NestedBlock = {
+	args: {
+		clientId: blocks[ 2 ].innerBlocks[ 0 ].clientId,
+	},
+};