feat: integrate latest HMDesign design system updates

src/components/tabs.stories.tsx

@@ -1,20 +1,24 @@
 import type { Meta, StoryObj } from "@storybook/react-vite"
-import type { ComponentProps } from "react"
-import { Tabs, TabsContent, TabsList, TabsTrigger } from "@hm-design/ui"
+import { useId, useState, type ComponentProps } from "react"
+import {
+  Card, CardContent, CardHeader, CardTitle, Input, Label, Textarea,
+  Table, TableBody, TableCaption, TableCell, TableHead, TableHeader, TableRow,
+  Tabs, TabsContent, TabsList, TabsTrigger,
+} from "@hm-design/ui"
 import { StateBoard } from "@/components/story-board"
 import { STORY_KICKER, StoryPage, StoryPageHeader, StorySection } from "@/components/story-page"
 
 // Representative "Tabs" Story shows default Primary, explicit API comparisons and Secondary; Legacy stays verification-only.
-// Selected connects to the content surface, so every specimen puts the Tabs on a plain bordered panel supplied by the consumer
-// (TabsContent here). The panel is layout, not part of Tabs.
+// D-01 applies to every Fill specimen: flat panels use the actual parent surface and padding 24px 0.
+// D-02 is shipped by the public Tabs theme mapping (Primary top White alpha .8). Legacy stays compatibility-only.
 
 type Variant = "primary" | "secondary"
 type ListProps = Pick<ComponentProps<typeof TabsList>, "fill" | "panelSurface">
 
 // Primary = Fill + panelSurface="content", Secondary = Fill + panelSurface="surface" (2026-10-06 사용자 결정).
 const variantProps = {
-  primary: { listProps: {}, panel: "border bg-background" },
-  secondary: { listProps: { fill: true, panelSurface: "surface" }, panel: "border bg-card" },
+  primary: { listProps: {}, surface: "bg-background" },
+  secondary: { listProps: { fill: true, panelSurface: "surface" }, surface: "bg-card" },
 } as const
 
 function Specimen({
@@ -32,12 +36,14 @@ function Specimen({
   labels?: string[]
   listProps?: ListProps
 }) {
-  const { listProps: defaults, panel } = variantProps[variant]
+  const { listProps: defaults, surface } = variantProps[variant]
+  const effectiveListProps: ListProps = listProps ?? defaults
+  const legacy = effectiveListProps.fill === false
   const items = labels?.map((label, i) => ({ value: `menu${i + 1}`, label }))
     ?? Array.from({ length: count }, (_, i) => ({ value: `menu${i + 1}`, label: `메뉴 ${i + 1}` }))
   return (
-    <Tabs defaultValue={defaultValue}>
-      <TabsList aria-label="업무 필터" {...(listProps ?? defaults)}>
+    <Tabs defaultValue={defaultValue} className={legacy ? undefined : `min-w-0 ${surface}`}>
+      <TabsList aria-label="업무 필터" {...effectiveListProps}>
         {items.map(({ value, label }, i) => (
           <TabsTrigger key={value} value={value} disabled={disabledSecond && i === 1}>
             {label}
@@ -45,7 +51,7 @@ function Specimen({
         ))}
       </TabsList>
       {items.map(({ value }, i) => (
-        <TabsContent key={value} value={value} className={`rounded-b p-4 text-sm ${panel}`}>
+        <TabsContent key={value} value={value} className={legacy ? "rounded-b p-4 text-sm border bg-card" : "px-0 py-6 text-sm"}>
           메뉴 {i + 1} 콘텐츠
         </TabsContent>
       ))}
@@ -55,6 +61,47 @@ function Specimen({
 
 const longLabels = ["기본 정보", "보상 협의 및 계약 진행 현황", "토지 및 지장물 조사 내역"]
 
+// Component composition reference, not a new application screen. All visual controls use public HM exports.
+// Input state lives above the panels so the draft survives Radix's inactive-panel unmount.
+function SurfaceUsage({ inCard = false }: { inCard?: boolean }) {
+  const id = useId()
+  const [project, setProject] = useState("")
+  const [purpose, setPurpose] = useState("")
+  const tabs = (
+    <Tabs defaultValue="information" className="min-w-0">
+      <TabsList panelSurface={inCard ? "surface" : "content"} aria-label={inCard ? "Card 내부 프로젝트 정보" : "페이지 프로젝트 정보"}>
+        <TabsTrigger value="information">기본 정보</TabsTrigger>
+        <TabsTrigger value="schedule">일정·산출물</TabsTrigger>
+      </TabsList>
+      <TabsContent value="information" className="px-0 py-6">
+        <div className="grid gap-4">
+          <div className="grid gap-2">
+            <Label htmlFor={`${id}-project`}>프로젝트명 (필수)</Label>
+            <Input id={`${id}-project`} required value={project} onChange={event => setProject(event.target.value)} placeholder="프로젝트명을 입력하세요" />
+          </div>
+          <div className="grid gap-2">
+            <Label htmlFor={`${id}-purpose`}>목적 및 배경</Label>
+            <Textarea id={`${id}-purpose`} value={purpose} onChange={event => setPurpose(event.target.value)} placeholder="프로젝트의 목적을 입력하세요" />
+          </div>
+        </div>
+      </TabsContent>
+      <TabsContent value="schedule" className="px-0 py-6">
+        <Table>
+          <TableCaption>프로젝트 산출물 일정 예시</TableCaption>
+          <TableHeader><TableRow><TableHead scope="col">산출물</TableHead><TableHead scope="col">마감일</TableHead></TableRow></TableHeader>
+          <TableBody><TableRow><TableCell>화면 설계서</TableCell><TableCell>10월 14일</TableCell></TableRow></TableBody>
+        </Table>
+      </TabsContent>
+    </Tabs>
+  )
+  return inCard ? (
+    <Card className="min-w-0">
+      <CardHeader><CardTitle>프로젝트 정보</CardTitle></CardHeader>
+      <CardContent className="min-w-0">{tabs}</CardContent>
+    </Card>
+  ) : <div className="min-w-0 bg-background">{tabs}</div>
+}
+
 function LongLabelSpecimens() {
   return (
     <div className="grid min-w-0 max-w-full gap-5">
@@ -86,7 +133,7 @@ const meta = {
     docs: {
       description: {
         component:
-          "기본 TabsList는 Primary(fill=true, panelSurface=\"content\")입니다. 대표 Story는 기본 API와 명시적 Primary, Secondary(fill + panelSurface=\"surface\"), Primary Overflow를 비교합니다. Legacy non-fill은 fill={false}로 유지하며 숨김 Compatibility에서 확인합니다. 높이 34, 좌우 16, 상단 radius 4, 16/24/700과 8px 곡선 연결은 기존 값 그대로입니다. Selected는 패널 배경과 이어지고 Hover는 비선택에만 Black 20%입니다. 넘칠 때만 이전/다음 이동 버튼이 나타납니다. 곡선 반경 8px과 비선택 합성색의 과거 REVIEW / TEMPORARY 이력은 유지합니다.",
+          "기본 TabsList는 Primary(fill=true, panelSurface=\"content\")입니다. 대표 Story는 기본 API와 명시적 Primary, Secondary(fill + panelSurface=\"surface\"), Primary Overflow를 비교합니다. 모든 Fill 예제는 중첩 박스 없는 TabsContent(px-0 py-6)를 사용하며 Usage는 Card 내부 surface와 페이지 content 위의 조합입니다. panelSurface는 List의 선택 면만 바꾸므로 실제 상위 배경에 맞춰 선택합니다. Primary 선택 탭의 gradient는 상단 White alpha 0.8 → content이며 전체 opacity는 1입니다. Secondary는 기존 불투명 White를 유지합니다. Legacy non-fill은 fill={false}로 유지하며 숨김 Compatibility에서 확인합니다. 높이 34, 좌우 16, 상단 radius 4, 16/24/700과 8px 곡선 연결은 기존 값 그대로입니다. Hover는 비선택에만 Black 20%이며 넘칠 때만 이전/다음 이동 버튼이 나타납니다. aria-label과 연결된 입력 Label을 제공하고, 방향키·Home/End·포커스·Disabled·모바일 내부 스크롤을 확인합니다. 곡선 반경 8px과 비선택 합성색의 과거 REVIEW / TEMPORARY 이력은 유지합니다.",
       },
     },
   },
@@ -107,7 +154,7 @@ export const All: Story = {
       <StorySection title="Overview">
         <StateBoard
           states={[
-            { id: "primary", label: "Primary · 기본 TabsList", noteAfter: true, note: "fill / panelSurface 생략 → Primary. 선택 면이 위 White → 아래 content panel색 gradient로 콘텐츠와 이어집니다. 비선택 탭에 hover하면 Black 20% overlay가 적용됩니다.", children: <Specimen /> },
+            { id: "primary", label: "Primary · 기본 TabsList", noteAfter: true, note: "fill / panelSurface 생략 → Primary. 선택 면이 위 White alpha 0.8 → 아래 content panel색 gradient로 콘텐츠와 이어집니다. 탭 전체 opacity는 1이며 비선택 hover는 기존 Black 20% overlay입니다.", children: <Specimen /> },
           ]}
         />
       </StorySection>
@@ -129,10 +176,19 @@ export const All: Story = {
       <StorySection title="States">
         <StateBoard
           states={[
-            { id: "overflow", label: "Overflow · Primary + 이동 버튼", noteAfter: true, note: "Primary Tabs에 탭이 많거나 가용 폭이 좁으면 이전/다음 이동 버튼이 나타납니다. 버튼은 선택을 바꾸지 않고 목록만 한 항목씩 이동합니다. 260px 폭은 Story wrapper의 검증 폭이며 Tabs 자체 폭이 아닙니다.", children: <div className="max-w-[260px]"><Specimen count={8} /></div> },
+            { id: "overflow", wide: true, label: "Overflow · Primary + 이동 버튼", noteAfter: true, note: "일반 화면 폭에서 20개 탭의 넘침을 확인합니다. 이전/다음 버튼은 선택을 바꾸지 않고 목록만 이동합니다. 모바일에서도 같은 내부 스크롤을 유지합니다.", children: <div className="w-full min-w-0 max-w-4xl"><Specimen count={20} /></div> },
           ]}
         />
       </StorySection>
+      <StorySection title="Usage" description="실제 상위 표면에 panelSurface를 맞추고 TabsContent의 중복 박스를 제거합니다. px-0 py-6는 이 조합의 예시이며 공통 spacing 규칙이 아닙니다.">
+        <StateBoard states={[
+          { id: "usage-card", label: "Card 내부 · Secondary", noteAfter: true, note: "바깥 Card의 배경·테두리·기본 여백 24px은 유지합니다. 내부 패널은 배경 transparent·border 0·padding 24px 0이며 입력 요소의 테두리를 보존합니다.", children: <SurfaceUsage inCard /> },
+          { id: "usage-page", label: "페이지 직접 배치 · Primary", noteAfter: true, note: "기존 Layout의 content 배경을 사용하는 조합입니다. 추가 흰색 박스를 만들지 않습니다. 일정 탭의 Table은 고유 표면과 내부 스크롤을 유지하고 입력값은 탭 전환 후에도 보존됩니다.", children: <SurfaceUsage /> },
+        ]} />
+      </StorySection>
+      <StorySection title="Do / Don't" description="Card 전용 Token을 화면 전체 간격에 사용하거나 모든 제목·설명 간격을 24px로 통일하지 않습니다.">
+        <p className="text-sm text-muted-foreground">Do: Card 또는 Layout이 외곽 여백을 소유하고 내부 Input·Table·Alert의 고유 스타일을 유지합니다. Don't: 패널 박스 제거를 모든 border 제거로 해석하거나, 그라데이션 alpha 조정을 탭 전체 opacity 변경으로 구현하지 않습니다. 실제 패널 계산값·키보드 동작·모바일 넘침을 확인합니다.</p>
+      </StorySection>
     </StoryPage>
   ),
 }