feat: add Storybook for WealthLedger components

src/shared/ui/StateView.stories.tsx

@@ -0,0 +1,78 @@
+import { Button } from "@mantine/core";
+import type { Meta, StoryObj } from "@storybook/react-vite";
+import type { ComponentProps } from "react";
+import { fn } from "storybook/test";
+import { StateView } from "./StateView";
+
+type StateStoryArgs = ComponentProps<typeof StateView> & {
+	withAction: boolean;
+	onAction: () => void;
+};
+
+const meta = {
+	title: "WealthLedger/StateView",
+	component: StateView,
+	tags: ["autodocs"],
+	args: {
+		title: "Нет учебных данных",
+		text: "Синтетическое пустое состояние. Пользовательские данные не загружаются.",
+		error: false,
+		withAction: false,
+		onAction: fn(),
+	},
+	argTypes: {
+		title: { control: "text" },
+		text: { control: "text" },
+		error: { control: "boolean" },
+		action: { table: { disable: true } },
+		withAction: {
+			control: "boolean",
+			description: "Показать необязательное действие StateView",
+		},
+		onAction: { control: false },
+	},
+	parameters: {
+		docs: {
+			description: {
+				component:
+					"Общее empty/error состояние WealthLedger с необязательным действием. Error сохраняет alert semantics. Для initial loading используйте skeleton страницы, для refetch — локальное предупреждение рядом с сохранёнными данными. Кнопка вызывает только Actions; API recovery и полный пользовательский сценарий здесь не проверяются.",
+			},
+		},
+	},
+	render: (args) => {
+		const { withAction, onAction, ...stateProps } = args;
+		return (
+			<StateView
+				{...stateProps}
+				action={
+					withAction ? (
+						<Button onClick={onAction} variant="default">
+							{args.error ? "Повторить локально" : "Выполнить пример"}
+						</Button>
+					) : undefined
+				}
+			/>
+		);
+	},
+} satisfies Meta<StateStoryArgs>;
+
+export default meta;
+
+type Story = StoryObj<typeof meta>;
+export const Empty: Story = { name: "Пустое состояние" };
+export const EmptyWithAction: Story = {
+	name: "Пустое состояние с действием",
+	args: { withAction: true },
+};
+export const Failed: Story = {
+	name: "Ошибка",
+	args: {
+		error: true,
+		title: "Учебная ошибка",
+		text: "Демонстрация недоступных данных без вызова API.",
+	},
+};
+export const ErrorWithAction: Story = {
+	name: "Ошибка с retry",
+	args: { ...Failed.args, withAction: true },
+};