refactor(storybook): simplify component and preview examples

Drop page / section descriptions, state notes and repeated captions from
the representative Stories of 44 components, the Patterns, Center
Graphic and OrgChart pages. Value readouts, spec lists and captions hide
only on the representative page; hidden verification Stories keep them.
Tabs Default API and the Filter Bar draft / applied counts move to the
hidden DefaultApi and DraftApplied Stories; Center Overview is hidden
with its direct URL kept. Story IDs are unchanged.

Align the component, pattern and OrgChart docs with the pages, point the
quality reference check at the DraftApplied Story, and make the P8
styles check expect no section header on the preview-only Expanded page.
This commit is contained in:
shkim4 committed 2026-10-23 00:28:05 +09:00
1 parent 48977e7823
commit 4c29894e56
81 files changed
+520 -671

No files matched your search

+7 -9
View File
@@ -28,7 +28,8 @@ function Sizes() {
)
}
function Fallbacks() {
// `showCaption={false}` drops the captions on the representative page (they restate the visible fallback text); the verification Story keeps them.
function Fallbacks({ showCaption = true }: { showCaption?: boolean }) {
const items = [
{ label: "한글 두 글자", text: "김한" },
{ label: "영문 두 글자", text: "HM" },
@@ -43,7 +44,7 @@ function Fallbacks() {
<AvatarImage src="/broken-avatar-image.png" alt="" />
<AvatarFallback>{i.text}</AvatarFallback>
</Avatar>
<span className="text-xs text-muted-foreground">{i.label}</span>
{showCaption ? <span className="text-xs text-muted-foreground">{i.label}</span> : null}
</div>
))}
</div>
@@ -66,8 +67,8 @@ function Group() {
}
const sections = [
{ id: "image", label: "Image", note: "이미지가 로드되면 fallback은 나타나지 않습니다", node: <Sizes /> },
{ id: "fallback", label: "Fallback (image error)", note: "이미지 로드 실패 시 initials", node: <Fallbacks /> },
{ id: "image", label: "Image", node: <Sizes /> },
{ id: "fallback", label: "Fallback", node: <Fallbacks showCaption={false} /> },
{ id: "composition", label: "Composition", node: <Group /> },
]
@@ -76,7 +77,7 @@ export default meta
type Story = StoryObj<typeof meta>
const board = (...ids: string[]) => (
<StateBoard min={320} states={sections.filter((s) => ids.includes(s.id)).map((s) => ({ id: s.id, label: s.label, note: s.note, children: s.node }))} />
<StateBoard min={320} states={sections.filter((s) => ids.includes(s.id)).map((s) => ({ id: s.id, label: s.label, children: s.node }))} />
)
// Representative Story: the common Story page; the sections group the same specimens.
@@ -85,10 +86,7 @@ export const All: Story = {
parameters: { layout: "fullscreen", controls: { disable: true } },
render: () => (
<StoryPage>
<StoryPageHeader
title="Avatar"
description="이미지 실패 시 fallback 글자"
/>
<StoryPageHeader title="Avatar" />
<StorySection title="Overview">{board("image")}</StorySection>
<StorySection title="States">{board("fallback")}</StorySection>
<StorySection title="Usage">{board("composition")}</StorySection>