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

+4 -16
View File
@@ -11,7 +11,7 @@ import {
TunnelReferenceDemo,
} from "@hm-design/center-graphic/reference"
import { StoryPage, StoryPageHeader, StorySection } from "@/components/story-page"
import { CENTER_BOUNDARY, withRepresentation } from "./center-shared"
import { withRepresentation } from "./center-shared"
// Owners: ui-viz docs/visualization/facility.md and facility-assets.md (128 approved SVG references, shipped unchanged).
// The display scale (Q2b) is HOLD and Facility has no Selected / Hover state.
@@ -29,11 +29,8 @@ const page = (name: string, Demo: ComponentType): Story => ({
parameters: { layout: "fullscreen", controls: { disable: true } },
render: () => (
<StoryPage>
<StoryPageHeader
title={name}
description="승인 SVG Reference · 위치도 / 실사화"
/>
<StorySection title="Overview" description={CENTER_BOUNDARY}>
<StoryPageHeader title={name} />
<StorySection title="Overview">
{withRepresentation(() => <Demo />)}
</StorySection>
</StoryPage>
@@ -52,16 +49,7 @@ export const Linked: Story = {
...page("연계 시설물", LinkedFacilityReferenceDemo),
render: () => (
<StoryPage className="sb-center-linked-page">
<StoryPageHeader
title="연계 시설물"
description={
<>
승인 SVG Reference · 위치도 / 실사화
<br />
{CENTER_BOUNDARY}
</>
}
/>
<StoryPageHeader title="연계 시설물" />
{withRepresentation(() => <LinkedFacilityReferenceDemo />)}
</StoryPage>
),
+3 -6
View File
@@ -1,7 +1,7 @@
import type { Meta, StoryObj } from "@storybook/react-vite"
import { CenterInformationDisplayReferenceDemo } from "@hm-design/center-graphic/reference"
import { StoryPage, StoryPageHeader, StorySection } from "@/components/story-page"
import { CENTER_BOUNDARY, withRepresentation } from "./center-shared"
import { withRepresentation } from "./center-shared"
// Owner: ui-viz docs/patterns/center-information-presentation.md and center-information-{box,table,emphasis}.md.
// Single-line ellipsis is resolved; multi-line overflow, exact placement and the presentation scale (Q3) are not.
@@ -17,11 +17,8 @@ export const Information: Story = {
name: "Information",
render: () => (
<StoryPage>
<StoryPageHeader
title="Information"
description="Box · Table · Emphasis · 배율(Q3) 미정"
/>
<StorySection title="Overview" description={CENTER_BOUNDARY}>
<StoryPageHeader title="Information" />
<StorySection title="Overview">
{withRepresentation(() => (
<div className="sb-center-information">
<CenterInformationDisplayReferenceDemo />
+5 -3
View File
@@ -1,6 +1,6 @@
import type { Meta, StoryObj } from "@storybook/react-vite"
import { StoryPage, StoryPageHeader, StorySection } from "@/components/story-page"
import { CENTER_BOUNDARY, CenterFrame, SCALE_NOTE, StatusTable } from "./center-shared"
import { CenterFrame, SCALE_NOTE, StatusTable } from "./center-shared"
// Mirrors the ui-viz docs/governance/center-domain.md §5 registry rows. The values stay in the owner documents.
const STATUS: [string, string, string, string][] = [
@@ -24,17 +24,19 @@ const meta = { title: "Center Graphic/Overview", parameters: { layout: "fullscre
export default meta
type Story = StoryObj<typeof meta>
// Hidden from the sidebar (verification); the Story ID and direct URL stay. Keeps the scale rule and the status registry.
export const Overview: Story = {
tags: ["verification"],
name: "Overview",
render: () => (
<StoryPage>
<StoryPageHeader title="Overview" description={CENTER_BOUNDARY} />
<StoryPageHeader title="Overview" />
<CenterFrame>
<div className="sb-center-overview">
<StorySection title="Representation Scale">
<p className="sb-center-note">{SCALE_NOTE}</p>
</StorySection>
<StorySection title="Status" description="항목별 확정 상태와 Storybook 표현">
<StorySection title="Status">
<div className="sb-center-scroll">
<StatusTable rows={STATUS} />
</div>
+3 -6
View File
@@ -2,7 +2,7 @@ import type { Meta, StoryObj } from "@storybook/react-vite"
import { RouteLine } from "@hm-design/center-graphic"
import { CenterSpatialInformationReferenceDemo } from "@hm-design/center-graphic/reference"
import { StoryPage, StoryPageHeader, StorySection } from "@/components/story-page"
import { CENTER_BOUNDARY, withRepresentation } from "./center-shared"
import { withRepresentation } from "./center-shared"
// Owners: ui-viz docs/visualization/route.md, spatial-map.md, spatial-section.md, composition.md.
// Route layer order Shadow -> Outline -> Primary Stroke is CONFIRMED; the whole-map layer order is Candidate and line join is TBD.
@@ -19,11 +19,8 @@ export const Spatial: Story = {
name: "Spatial",
render: () => (
<StoryPage className="sb-center-spatial-page">
<StoryPageHeader
title="Spatial"
description="노선 레이어 순서 확정 · 전체 지도 레이어 순서 Candidate · line join TBD"
/>
<StorySection title="Overview" description={CENTER_BOUNDARY}>
<StoryPageHeader title="Spatial" />
<StorySection title="Overview">
{withRepresentation(() => <CenterSpatialInformationReferenceDemo />)}
</StorySection>
</StoryPage>
+3 -6
View File
@@ -2,7 +2,7 @@ import type { Meta, StoryObj } from "@storybook/react-vite"
import { CenterTitle, CENTER_TITLE_COMPOSITIONS, type CenterTitleComposition } from "@hm-design/center-graphic"
import { CenterTitleReferenceDemo } from "@hm-design/center-graphic/reference"
import { StoryPage, StoryPageHeader, StorySection } from "@/components/story-page"
import { CENTER_BOUNDARY, withRepresentation } from "./center-shared"
import { withRepresentation } from "./center-shared"
// Owner: ui-viz docs/components/center-title.md. Title Resolution B numeric output is TBD; the per-Type palette is SCOPED_DESIGN_APPROVAL.
const meta = {
@@ -20,11 +20,8 @@ export const Compositions: Story = {
parameters: { layout: "fullscreen", controls: { disable: true } },
render: () => (
<StoryPage>
<StoryPageHeader
title="Title"
description="4가지 Type · Resolution B 수치 TBD · palette SCOPED_DESIGN_APPROVAL"
/>
<StorySection title="Overview" description={CENTER_BOUNDARY}>
<StoryPageHeader title="Title" />
<StorySection title="Overview">
{withRepresentation(() => <CenterTitleReferenceDemo />)}
</StorySection>
</StoryPage>