chore: Storybook 10 업그레이드 및 Docs 스크롤 수정

.storybook/main.ts

@@ -6,14 +6,13 @@ import svgr from 'vite-plugin-svgr';
 
 const config: StorybookConfig = {
   stories: ['../src/renderer/src/components/**/*.stories.@(ts|tsx)'],
-  addons: ['@storybook/addon-essentials', '@storybook/addon-interactions', '@storybook/addon-a11y'],
+  addons: ['@storybook/addon-a11y', '@storybook/addon-docs'],
+
   framework: {
     name: '@storybook/react-vite',
     options: {}
   },
-  docs: {
-    autodocs: 'tag'
-  },
+
   async viteFinal(baseConfig) {
     return mergeConfig(baseConfig, {
       resolve: {

.storybook/preview.css

@@ -0,0 +1,10 @@
+/*
+ * main.css 의 body { overflow: hidden; height: 100% } 는 AppShell 이 자체 스크롤 영역을
+ * 갖기 때문에 둔 규칙이다. Storybook 은 Docs·캔버스 모두 미리보기 iframe 의 body 가
+ * 직접 스크롤돼야 하므로, Storybook 이 body 에 붙이는 클래스로 범위를 좁혀 풀어 준다.
+ */
+body.sb-show-main {
+  height: auto;
+  min-height: 100%;
+  overflow: auto;
+}

.storybook/preview.tsx

@@ -1,6 +1,7 @@
 import type { Preview } from '@storybook/react-vite';
 import { QueryClient, QueryClientProvider } from '@tanstack/react-query';
 import '../src/renderer/src/assets/main.css';
+import './preview.css';
 import { ToastProvider } from '../src/renderer/src/components/ui/ToastProvider';
 
 const createQueryClient = (): QueryClient =>

eslint.config.mjs

@@ -1,3 +1,6 @@
+// For more info, see https://github.com/storybookjs/eslint-plugin-storybook#configuration-flat-config-format
+import storybook from 'eslint-plugin-storybook';
+
 import { defineConfig } from 'eslint/config';
 import tseslint from '@electron-toolkit/eslint-config-ts';
 import eslintConfigPrettier from '@electron-toolkit/eslint-config-prettier';
@@ -12,6 +15,7 @@ export default defineConfig(
   tseslint.configs.recommended,
   eslintPluginReact.configs.flat.recommended,
   eslintPluginReact.configs.flat['jsx-runtime'],
+  ...storybook.configs['flat/recommended'],
   {
     settings: {
       react: {

package.json

@@ -53,10 +53,9 @@
     "@electron-toolkit/eslint-config-prettier": "^3.0.0",
     "@electron-toolkit/eslint-config-ts": "^3.1.0",
     "@electron-toolkit/tsconfig": "^2.0.0",
-    "@storybook/addon-a11y": "^8.6.14",
-    "@storybook/addon-essentials": "^8.6.14",
-    "@storybook/addon-interactions": "^8.6.14",
-    "@storybook/react-vite": "^8.6.14",
+    "@storybook/addon-a11y": "^10.6.1",
+    "@storybook/addon-docs": "^10.6.1",
+    "@storybook/react-vite": "^10.6.1",
     "@tailwindcss/postcss": "^4.1.18",
     "@testing-library/dom": "^10",
     "@testing-library/jest-dom": "^6",
@@ -74,6 +73,7 @@
     "eslint-plugin-react": "^7.37.5",
     "eslint-plugin-react-hooks": "^7.0.1",
     "eslint-plugin-react-refresh": "^0.4.24",
+    "eslint-plugin-storybook": "10.6.1",
     "husky": "^9.1.7",
     "jsdom": "^25",
     "lint-staged": "^16.2.7",
@@ -82,7 +82,7 @@
     "prettier": "^3.7.4",
     "react": "^19.2.1",
     "react-dom": "^19.2.1",
-    "storybook": "^8.6.14",
+    "storybook": "^10.6.1",
     "swagger-typescript-api": "^13.0.3",
     "tailwindcss": "^4.1.18",
     "tsx": "^4.23.13",