@public-ui/sample-react 4.0.0-alpha.1 → 4.0.0-alpha.11

package/public/assets/material-symbols/package.json

@@ -1,41 +1,41 @@
 {
-  "name": "material-symbols",
-  "version": "0.5.5",
-  "description": "Latest variable icon fonts and CSS for Material Symbols.",
-  "main": "index.css",
-  "sass": "index.scss",
-  "types": "index.d.ts",
-  "files": [
-    "index.d.ts",
-    "*.{css,scss,woff2}"
-  ],
-  "scripts": {
-    "build": "sass --no-source-map --no-error-css ."
-  },
-  "devDependencies": {
-    "sass": "1.56.1"
-  },
-  "license": "Apache-2.0",
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/marella/material-symbols.git",
-    "directory": "material-symbols"
-  },
-  "bugs": {
-    "url": "https://github.com/marella/material-symbols/issues"
-  },
-  "homepage": "https://marella.github.io/material-symbols/demo/",
-  "keywords": [
-    "material-symbols",
-    "material-icons",
-    "material-design-icons",
-    "material-design",
-    "material",
-    "symbols",
-    "icons",
-    "font"
-  ],
-  "publishConfig": {
-    "access": "public"
-  }
+	"name": "material-symbols",
+	"version": "0.5.5",
+	"description": "Latest variable icon fonts and CSS for Material Symbols.",
+	"main": "index.css",
+	"sass": "index.scss",
+	"types": "index.d.ts",
+	"files": [
+		"index.d.ts",
+		"*.{css,scss,woff2}"
+	],
+	"scripts": {
+		"build": "sass --no-source-map --no-error-css ."
+	},
+	"devDependencies": {
+		"sass": "1.56.1"
+	},
+	"license": "Apache-2.0",
+	"repository": {
+		"type": "git",
+		"url": "git+https://github.com/marella/material-symbols.git",
+		"directory": "material-symbols"
+	},
+	"bugs": {
+		"url": "https://github.com/marella/material-symbols/issues"
+	},
+	"homepage": "https://marella.github.io/material-symbols/demo/",
+	"keywords": [
+		"material-symbols",
+		"material-icons",
+		"material-design-icons",
+		"material-design",
+		"material",
+		"symbols",
+		"icons",
+		"font"
+	],
+	"publishConfig": {
+		"access": "public"
+	}
 }

package/src/components/FormWrap.tsx

@@ -9,12 +9,12 @@ export const FormWrap = <P,>({ RefComponent: Component, showButtons = true, ...p
 				<Component {...props} />
 				{showButtons && (
 					<div className="flex gap-4">
-						<KolButton _label="Submit" _icons="codicon codicon-arrow-right" _type="submit" _variant="primary" />
+						<KolButton _label="Submit" _icons="kolicon-chevron-right" _type="submit" _variant="primary" />
 						<KolButton
 							_label="Bunte Icons"
 							_icons={{
-								left: { icon: 'codicon codicon-heart-filled', style: { color: '#cc006e' } },
-								right: { icon: 'codicon codicon-squirrel', style: { color: '#b41b1b' } },
+								left: { icon: 'fa-solid fa-heart', style: { color: '#cc006e' } },
+								right: { icon: 'kolicon-kolibri', style: { color: '#b41b1b' } },
 							}}
 							_type="submit"
 							_variant="secondary"

package/src/components/Navigation.tsx

@@ -1,8 +1,8 @@
-import * as React from 'react';
 import { KolAccordion, KolTree, KolTreeItem } from '@public-ui/react-v19';
-import { useMobile } from '../hooks/useMobile';
-import type { Routes, Route } from '../shares/types';
+import * as React from 'react';
 import { useHref, useMatch, useResolvedPath } from 'react-router-dom';
+import { useMobile } from '../hooks/useMobile';
+import type { Route, Routes } from '../shares/types';
 
 type NavigationProps = {
 	routes: Routes;

package/src/components/SampleColumns.tsx

@@ -1,5 +1,4 @@
-import React from 'react';
-import { type PropsWithChildren } from 'react';
+import React, { type PropsWithChildren } from 'react';
 import { useSearchParams } from 'react-router-dom';
 
 export function SampleColumns({ children }: PropsWithChildren) {

package/src/components/SampleDescription.tsx

@@ -5,8 +5,8 @@ import { PUBLIC_CODE_COMPONENT_URL, PUBLIC_DOC_COMPONENT_URL } from '../shares/c
 
 import { KolLink } from '@public-ui/react-v19';
 
-import { HideMenusContext } from '../shares/HideMenusContext';
 import { useLocation } from 'react-router';
+import { HideMenusContext } from '../shares/HideMenusContext';
 
 export const SampleDescription: FC<PropsWithChildren> = (props) => {
 	const hideMenus = useContext(HideMenusContext);

package/src/components/Sidebar.tsx

@@ -79,11 +79,11 @@ export const Sidebar: FC<Props> = ({ version, theme, routes, routeList, sample,
 				<KolSelect _label="Theme" _options={THEME_OPTIONS} _on={{ onChange: handleThemeSelectChange }} _value={theme} class="mt"></KolSelect>
 				<KolHeading _label="Components" _level={2} className="block mt"></KolHeading>
 				<div className="flex flex-justify-between flex-items-center mt">
-					<KolButton _icons="codicon codicon-arrow-left" _hideLabel _label="Previous component" _on={{ onClick: handlePreviousClick }} />
+					<KolButton _icons="kolicon-chevron-left" _hideLabel _label="Previous component" _on={{ onClick: handlePreviousClick }} />
 					<span className="text-base text-center">
 						{formatSampleAsLabel()} ({getIndexOfSample() + 1}/{routeList.length})
 					</span>
-					<KolButton _icons="codicon codicon-arrow-right" _hideLabel _label="Next component" _on={{ onClick: handleNextClick }} />
+					<KolButton _icons="kolicon-chevron-right" _hideLabel _label="Next component" _on={{ onClick: handleNextClick }} />
 				</div>
 				<Navigation routes={routes} />
 			</div>

package/src/components/accordion/basic.tsx

@@ -1,6 +1,6 @@
 import React from 'react';
 
-import { KolAccordion } from '@public-ui/react-v19';
+import { KolAccordion, KolCombobox } from '@public-ui/react-v19';
 import { SampleDescription } from '../SampleDescription';
 
 import type { FC } from 'react';
@@ -15,11 +15,15 @@ export const AccordionBasic: FC = () => (
 		</SampleDescription>
 
 		<div className="grid gap-4">
-			<KolAccordion _label="Heading Accordion Tab 1">Contents Accordion Tab 1</KolAccordion>
+			<KolAccordion _label="Heading Accordion Tab 1 (open)" _open>
+				<KolCombobox _label="Combobox in Accordion" _suggestions="['Herr','Frau','Firma']" />
+			</KolAccordion>
 			<KolAccordion _label="Heading Accordion Tab 2">Contents Accordion Tab 2</KolAccordion>
-			<KolAccordion _label="Heading Accordion Tab 2 (deactivated)" _disabled></KolAccordion>
-			<KolAccordion _label="Heading Accordion Tab 2 (disabled and open)" _disabled _open>
-				Contents Accordion Tab 2
+			<KolAccordion _label="Heading Accordion Tab 3 (deactivated)" _disabled>
+				Contents Accordion Tab 3
+			</KolAccordion>
+			<KolAccordion _label="Heading Accordion Tab 4 (disabled and open)" _disabled _open>
+				Contents Accordion Tab 4
 			</KolAccordion>
 		</div>
 	</>

package/src/components/alert/basic.tsx

@@ -1,7 +1,7 @@
-import React from 'react';
+import type { AlertTypePropType, AlertVariantPropType, HeadingLevel } from '@public-ui/components';
 import { KolAlert } from '@public-ui/react-v19';
 import type { FC } from 'react';
-import type { AlertTypePropType, AlertVariantPropType, HeadingLevel } from '@public-ui/components';
+import React from 'react';
 import { SampleDescription } from '../SampleDescription';
 
 type PropsByType = {

package/src/components/alert/card-msg.tsx

@@ -1,8 +1,8 @@
 import type { FC } from 'react';
 import React from 'react';
 
-import { AlertVariants } from './basic';
 import { SampleDescription } from '../SampleDescription';
+import { AlertVariants } from './basic';
 
 export const AlertCardMsg: FC = () => (
 	<>

package/src/components/alert/html.tsx

@@ -1,8 +1,8 @@
 import React from 'react';
 
 import { KolAlert, KolHeading } from '@public-ui/react-v19';
-import { SampleDescription } from '../SampleDescription';
 import type { FC } from 'react';
+import { SampleDescription } from '../SampleDescription';
 
 export const AlertHtml: FC = () => (
 	<>

package/src/components/avatar/basic.tsx

@@ -1,12 +1,15 @@
 import { KolAvatar } from '@public-ui/react-v19';
-import React from 'react';
 import type { FC } from 'react';
+import React from 'react';
 import { SampleDescription } from '../SampleDescription';
 
 export const AvatarBasic: FC = () => (
 	<>
 		<SampleDescription>
-			<p>KolAlert shows a user&apos;s avatar. It can be used with or without an image. If no image is defined, the name&apos;s initials are shown instead.</p>
+			<p>
+				KolAvatar shows a user&apos;s avatar with customizable colors. It can be used with or without an image. If no image is defined, the name&apos;s initials
+				are shown instead with a configurable background color.
+			</p>
 		</SampleDescription>
 
 		<div className="flex flex-wrap gap-4">
@@ -15,6 +18,7 @@ export const AvatarBasic: FC = () => (
 			{/* intentional trailing space    👇 - it's supposed to be trimmed */}
 			<KolAvatar _label="Elke Mustermann " />
 			<KolAvatar _label="Marianne" />
+			<KolAvatar _color="#0000FF" _label="Christian" />
 		</div>
 	</>
 );

package/src/components/badge/basic.tsx

@@ -15,8 +15,8 @@ export const BadgeBasic: FC = () => (
 			<KolBadge _label="black"></KolBadge>
 			<KolBadge _color="#86ffc6" _label="teal"></KolBadge>
 			<KolBadge _color="#06539e" _label="blue"></KolBadge>
-			<KolBadge _color="#ae0000" _label="red with icon" _icons="codicon codicon-smiley"></KolBadge>
-			<KolBadge _color="#8b008b" _label="purple with icon" _icons="codicon codicon-squirrel"></KolBadge>
+			<KolBadge _color="#ae0000" _label="red with icon" _icons="fa-solid fa-face-smile"></KolBadge>
+			<KolBadge _color="#8b008b" _label="purple with icon" _icons="kolicon-kolibri"></KolBadge>
 		</div>
 	</>
 );

package/src/components/badge/button.tsx

@@ -7,8 +7,9 @@ import { SampleDescription } from '../SampleDescription';
 const createBadgeProps = (label: string) => ({
 	_label: label,
 	_smartButton: {
-		_icons: 'codicon codicon-close',
-		_label: `Remove ${label}`,
+		_ariaDescription: label,
+		_icons: 'kolicon-cross',
+		_label: `Remove`,
 		_on: {
 			onClick: () => alert('clicked'),
 		},
@@ -27,8 +28,8 @@ export const BadgeButton: FC = () => (
 			<KolBadge {...createBadgeProps('black')}></KolBadge>
 			<KolBadge _color="#86ffc6" {...createBadgeProps('teal')}></KolBadge>
 			<KolBadge _color="#06539e" {...createBadgeProps('blue')}></KolBadge>
-			<KolBadge _color="#ae0000" _icons="codicon codicon-smiley" {...createBadgeProps('red with icon')}></KolBadge>
-			<KolBadge _color="#8b008b" _icons="codicon codicon-squirrel" {...createBadgeProps('purple with icon')}></KolBadge>
+			<KolBadge _color="#ae0000" _icons="fa-solid fa-face-smile" {...createBadgeProps('red with icon')}></KolBadge>
+			<KolBadge _color="#8b008b" _icons="kolicon-kolibri" {...createBadgeProps('purple with icon')}></KolBadge>
 		</div>
 	</>
 );

package/src/components/badge/formatted-label.tsx

@@ -1,6 +1,6 @@
+import { KolBadge } from '@public-ui/react-v19';
 import * as React from 'react';
 import { SampleDescription } from '../SampleDescription';
-import { KolBadge } from '@public-ui/react-v19';
 
 export const FormattedLabel = () => {
 	return (

package/src/components/breadcrumb/basic.tsx

@@ -28,7 +28,7 @@ export const BreadcrumbBasic: FC = () => (
 				_links={[
 					{
 						_label: 'Homepage',
-						_icons: 'codicon codicon-home',
+						_icons: 'fa-solid fa-house',
 						_hideLabel: true,
 						_href: '#/back-page',
 					},
@@ -45,7 +45,7 @@ export const BreadcrumbBasic: FC = () => (
 			<KolBreadcrumb
 				_label="Breadcrumb from icons and text links"
 				_links={[
-					{ _label: 'Homepage', _icons: 'codicon codicon-home', _href: '#/back-page' },
+					{ _label: 'Homepage', _icons: 'fa-solid fa-house', _href: '#/back-page' },
 					{
 						_label: 'Subpage of the main page and I_am_a_really_long_compound_word_trying_to_break_the_layout',
 						_href: '#/back-page',
@@ -56,6 +56,7 @@ export const BreadcrumbBasic: FC = () => (
 					},
 				]}
 			></KolBreadcrumb>
+			<KolBreadcrumb _label="Minimal Breadcrumb" _links={[{ _label: 'Homepage', _href: '#/back-page' }]}></KolBreadcrumb>
 		</div>
 	</>
 );

package/src/components/button/access-key.tsx

@@ -1,8 +1,8 @@
-import { KolButton, KolLink } from '@public-ui/react-v19';
-import React from 'react';
+import { KolButton, KolHeading, KolLink } from '@public-ui/react-v19';
 import type { FC } from 'react';
-import { SampleDescription } from '../SampleDescription';
+import React from 'react';
 import { useToasterService } from '../../hooks/useToasterService';
+import { SampleDescription } from '../SampleDescription';
 
 export const ButtonAccessKey: FC = () => {
 	const { dummyClickEventHandler } = useToasterService();
@@ -15,26 +15,43 @@ export const ButtonAccessKey: FC = () => {
 		<>
 			<SampleDescription>
 				<p>
-					This sample shows KolButton with{' '}
-					<KolLink _label="access keys" _href="https://developer.mozilla.org/en-US/docs/Web/HTML/Global_attributes/accesskey" _target="blank" />. The access
-					keys can be used to trigger the buttons using the keyboard.
+					This story demonstrates buttons with{' '}
+					<KolLink _label="access keys" _href="https://developer.mozilla.org/en-US/docs/Web/HTML/Global_attributes/accesskey" _target="blank" />. Access keys
+					allow users to trigger buttons using keyboard shortcuts.
 				</p>
 			</SampleDescription>
 
-			<div className="flex flex-wrap gap-4">
-				<KolButton _label="With S access key" _accessKey="S" _on={dummyEventHandler}></KolButton>
-				<KolButton _label="Very small b" _accessKey="b" _on={dummyEventHandler}></KolButton>
-				<KolButton _label="Access key does not appear in label" _accessKey="x" _on={dummyEventHandler}></KolButton>
-				<KolButton _label="access key without label" _hideLabel _accessKey="a" _icons="codicon codicon-dashboard" _on={dummyEventHandler}></KolButton>
-				<KolButton
-					_label="with inline icons"
-					_icons={{
-						left: 'codicon codicon-dashboard',
-						right: 'codicon codicon-dashboard',
-					}}
-					_accessKey="n"
-					_on={dummyEventHandler}
-				/>
+			<div className="grid gap-8">
+				<section className="grid gap-4">
+					<KolHeading _level={2} _label="Buttons with Access Keys" />
+					<div className="flex flex-wrap gap-4">
+						<KolButton _label="With S access key" _accessKey="S" _on={dummyEventHandler} />
+						<KolButton _label="Very small b" _accessKey="b" _on={dummyEventHandler} />
+						<KolButton _label="Access key does not appear in label" _accessKey="x" _on={dummyEventHandler} />
+					</div>
+				</section>
+
+				<section className="grid gap-4">
+					<KolHeading _level={2} _label="Access Key with Hidden Label" />
+					<div className="flex flex-wrap gap-4">
+						<KolButton _label="access key without label" _hideLabel _accessKey="a" _icons="fa-solid fa-gauge" _on={dummyEventHandler} />
+					</div>
+				</section>
+
+				<section className="grid gap-4">
+					<KolHeading _level={2} _label="Access Key with Inline Icons" />
+					<div className="flex flex-wrap gap-4">
+						<KolButton
+							_label="with inline icons"
+							_icons={{
+								left: 'fa-solid fa-gauge',
+								right: 'fa-solid fa-gauge',
+							}}
+							_accessKey="n"
+							_on={dummyEventHandler}
+						/>
+					</div>
+				</section>
 			</div>
 		</>
 	);

package/src/components/button/aria-description.tsx

@@ -1,8 +1,8 @@
-import { KolButton } from '@public-ui/react-v19';
-import React from 'react';
+import { KolButton, KolHeading } from '@public-ui/react-v19';
 import type { FC } from 'react';
-import { SampleDescription } from '../SampleDescription';
+import React from 'react';
 import { useToasterService } from '../../hooks/useToasterService';
+import { SampleDescription } from '../SampleDescription';
 
 export const ButtonAriaDescription: FC = () => {
 	const { dummyClickEventHandler } = useToasterService();
@@ -14,12 +14,20 @@ export const ButtonAriaDescription: FC = () => {
 	return (
 		<>
 			<SampleDescription>
-				<p>This sample shows KolButton with aria-description</p>
+				<p>
+					This story demonstrates buttons with ARIA descriptions. The aria-description attribute provides additional descriptive text for screen readers,
+					helping users understand the button&apos;s purpose or action in more detail.
+				</p>
 			</SampleDescription>
 
-			<div className="flex flex-wrap gap-4">
-				<KolButton _label="Button Text without area description" _on={dummyEventHandler}></KolButton>
-				<KolButton _label="Button Text" _ariaDescription="Button Area Description" _on={dummyEventHandler}></KolButton>
+			<div className="grid gap-8">
+				<section className="grid gap-4">
+					<KolHeading _level={2} _label="Buttons with and without ARIA Description" />
+					<div className="flex flex-wrap gap-4">
+						<KolButton _label="Button without ARIA description" _on={dummyEventHandler} />
+						<KolButton _label="Button with ARIA description" _ariaDescription="This button performs an important action" _on={dummyEventHandler} />
+					</div>
+				</section>
 			</div>
 		</>
 	);

package/src/components/button/baselined.tsx

@@ -1,10 +1,8 @@
-import React from 'react';
-
-import { KolButton } from '@public-ui/react-v19';
-
+import { KolButton, KolHeading } from '@public-ui/react-v19';
 import type { FC } from 'react';
-import { SampleDescription } from '../SampleDescription';
+import React from 'react';
 import { useToasterService } from '../../hooks/useToasterService';
+import { SampleDescription } from '../SampleDescription';
 
 export const ButtonBaselined: FC = () => {
 	const { dummyClickEventHandler } = useToasterService();
@@ -16,14 +14,20 @@ export const ButtonBaselined: FC = () => {
 	return (
 		<>
 			<SampleDescription>
-				<p>This KolButton sample is used for internal testing purposes: It features multiple buttons with and without icons which are vertically aligned.</p>
+				<p>
+					This story demonstrates button baseline alignment. It shows multiple buttons with and without icons that are vertically aligned, useful for testing
+					layout consistency.
+				</p>
 			</SampleDescription>
 
-			<div className="flex flex-wrap gap-2">
-				<KolButton _label="Label-Text" _on={dummyEventHandler}></KolButton>
-				<KolButton _label="Label-Text" _on={dummyEventHandler}></KolButton>
-				<KolButton _label="Label-Text" _on={dummyEventHandler}></KolButton>
-				<KolButton _icons="codicon codicon-reactions" _label="Label-Text with Icon" _on={dummyEventHandler}></KolButton>
+			<div className="grid gap-8">
+				<section className="grid gap-4">
+					<KolHeading _level={2} _label="Vertically Aligned Buttons" />
+					<div className="flex flex-wrap gap-2">
+						<KolButton _label="Label-Text" _on={dummyEventHandler} />
+						<KolButton _icons="fa-solid fa-face-smile" _label="Label-Text with Icon" _on={dummyEventHandler} />
+					</div>
+				</section>
 			</div>
 		</>
 	);

package/src/components/button/basic.tsx

@@ -1,16 +1,88 @@
+import { KolButton, KolHeading } from '@public-ui/react-v19';
 import type { FC } from 'react';
 import React from 'react';
-import { ButtonVariants } from './partials/variants';
+import { useToasterService } from '../../hooks/useToasterService';
 import { SampleDescription } from '../SampleDescription';
 
-export const ButtonBasic: FC = () => (
-	<>
-		<SampleDescription>
-			<p>
-				KolButton shows a button-element. This sample demonstrates the basic usage with its different styling variants, icons, disabled state and hidden labels.
-			</p>
-		</SampleDescription>
+export const ButtonBasic: FC = () => {
+	const { dummyClickEventHandler } = useToasterService();
 
-		<ButtonVariants />
-	</>
-);
+	const dummyEventHandler = {
+		onClick: dummyClickEventHandler,
+	};
+
+	return (
+		<>
+			<SampleDescription>
+				<p>
+					This story demonstrates the most important features of the KolButton component. It showcases the different button variants, icons, disabled state, and
+					hidden labels.
+				</p>
+			</SampleDescription>
+
+			<div className="grid gap-8">
+				{/* Button Variants */}
+				<section className="grid gap-4">
+					<KolHeading _level={2} _label="Button Variants" />
+					<div className="flex flex-wrap gap-4">
+						<KolButton _icons="fa-solid fa-house" _label="Primary" _variant="primary" _on={dummyEventHandler} />
+						<KolButton _icons="fa-solid fa-heart" _label="Secondary" _variant="secondary" _on={dummyEventHandler} />
+						<KolButton _icons="fa-solid fa-robot" _label="Tertiary" _variant="tertiary" _on={dummyEventHandler} />
+						<KolButton _icons="fa-solid fa-robot" _label="Normal" _variant="normal" _on={dummyEventHandler} />
+						<KolButton _icons="fa-solid fa-trash" _label="Danger" _variant="danger" _on={dummyEventHandler} />
+						<KolButton _icons="fa-solid fa-smile" _label="Ghost" _variant="ghost" _on={dummyEventHandler} />
+					</div>
+				</section>
+
+				{/* Disabled State */}
+				<section className="grid gap-4">
+					<KolHeading _level={2} _label="Disabled State" />
+					<div className="flex flex-wrap gap-4">
+						<KolButton _disabled _icons="fa-solid fa-house" _label="Primary" _variant="primary" _on={dummyEventHandler} />
+						<KolButton _disabled _icons="fa-solid fa-heart" _label="Secondary" _variant="secondary" _on={dummyEventHandler} />
+						<KolButton _disabled _icons="fa-solid fa-trash" _label="Danger" _variant="danger" _on={dummyEventHandler} />
+					</div>
+				</section>
+
+				{/* Hidden Label */}
+				<section className="grid gap-4">
+					<KolHeading _level={2} _label="Hidden Label (Icon Only)" />
+					<div className="flex flex-wrap gap-4">
+						<KolButton _hideLabel _icons="fa-solid fa-house" _label="Primary" _variant="primary" _on={dummyEventHandler} />
+						<KolButton _hideLabel _icons="fa-solid fa-heart" _label="Secondary" _variant="secondary" _on={dummyEventHandler} />
+						<KolButton _hideLabel _icons="fa-solid fa-trash" _label="Danger" _variant="danger" _on={dummyEventHandler} />
+					</div>
+				</section>
+
+				{/* Icon Positions */}
+				<section className="grid gap-4">
+					<KolHeading _level={2} _label="Icon Positions" />
+					<div className="flex flex-wrap gap-4">
+						<KolButton
+							_icons={{
+								left: 'kolicon-chevron-left',
+							}}
+							_label="Icon Left"
+							_on={dummyEventHandler}
+						/>
+						<KolButton
+							_icons={{
+								right: 'kolicon-chevron-right',
+							}}
+							_label="Icon Right"
+							_on={dummyEventHandler}
+						/>
+						<KolButton
+							_icons={{
+								left: 'kolicon-chevron-left',
+								right: 'kolicon-chevron-right',
+							}}
+							_label="Icons Both Sides"
+							_on={dummyEventHandler}
+						/>
+					</div>
+				</section>
+			</div>
+		</>
+	);
+};

package/src/components/button/disabled.tsx

@@ -0,0 +1,43 @@
+import { KolButton, KolHeading } from '@public-ui/react-v19';
+import type { FC } from 'react';
+import React from 'react';
+import { useToasterService } from '../../hooks/useToasterService';
+import { SampleDescription } from '../SampleDescription';
+
+export const ButtonDisabled: FC = () => {
+	const { dummyClickEventHandler } = useToasterService();
+
+	const dummyEventHandler = {
+		onClick: dummyClickEventHandler,
+	};
+
+	return (
+		<>
+			<SampleDescription>
+				<p>This story demonstrates the disabled state of buttons. Disabled buttons are not clickable and appear visually dimmed.</p>
+			</SampleDescription>
+
+			<div className="grid gap-8">
+				<section className="grid gap-4">
+					<KolHeading _level={2} _label="Disabled Buttons" />
+					<div className="flex flex-wrap gap-4">
+						<KolButton _disabled _icons="fa-solid fa-house" _label="Primary" _variant="primary" _on={dummyEventHandler} />
+						<KolButton _disabled _icons="fa-solid fa-heart" _label="Secondary" _variant="secondary" _on={dummyEventHandler} />
+						<KolButton _disabled _icons="fa-solid fa-robot" _label="Tertiary" _variant="tertiary" _on={dummyEventHandler} />
+						<KolButton _disabled _icons="fa-solid fa-robot" _label="Normal" _variant="normal" _on={dummyEventHandler} />
+						<KolButton _disabled _icons="fa-solid fa-trash" _label="Danger" _variant="danger" _on={dummyEventHandler} />
+						<KolButton _disabled _icons="fa-solid fa-smile" _label="Ghost" _variant="ghost" _on={dummyEventHandler} />
+					</div>
+				</section>
+
+				<section className="grid gap-4">
+					<KolHeading _level={2} _label="Comparison: Enabled vs Disabled" />
+					<div className="flex flex-wrap gap-4">
+						<KolButton _icons="fa-solid fa-house" _label="Enabled" _variant="primary" _on={dummyEventHandler} />
+						<KolButton _disabled _icons="fa-solid fa-house" _label="Disabled" _variant="primary" _on={dummyEventHandler} />
+					</div>
+				</section>
+			</div>
+		</>
+	);
+};