Initial commit: HMDesignSystem baseline

src/components/sheet.stories.tsx

@@ -0,0 +1,130 @@
+import type { Meta, StoryObj } from "@storybook/react-vite"
+import { Button, Input, Sheet, SheetBody, SheetClose, SheetContent, SheetDescription, SheetFooter, SheetHeader, SheetTitle, SheetTrigger } from "@hm-design/ui"
+import { STORY_KICKER, StoryPage, StoryPageHeader, StorySection } from "@/components/story-page"
+
+// Sheet is a modal Radix overlay (Portal), so the representative Story is a row of triggers that open the real Sheet for each
+// side and content case. The same cases start open in the verification Stories. Radix owns focus trap, Escape and focus return.
+
+type Side = "top" | "right" | "bottom" | "left"
+
+const longText = "긴 내용은 Body 영역만 세로로 scroll 하고 Header와 Footer는 그대로 보입니다. "
+
+function Frame({
+  trigger,
+  side,
+  defaultOpen,
+  title,
+  description,
+  children,
+}: {
+  trigger: string
+  side?: Side
+  defaultOpen?: boolean
+  title: string
+  description?: string
+  children: React.ReactNode
+}) {
+  return (
+    <Sheet defaultOpen={defaultOpen}>
+      <SheetTrigger asChild>
+        <Button variant="primary" appearance="outline">
+          {trigger}
+        </Button>
+      </SheetTrigger>
+      <SheetContent side={side}>
+        <SheetHeader>
+          <SheetTitle>{title}</SheetTitle>
+          {description ? <SheetDescription>{description}</SheetDescription> : null}
+        </SheetHeader>
+        <SheetBody>{children}</SheetBody>
+        <SheetFooter>
+          <SheetClose asChild>
+            <Button variant="cancel" appearance="solid">
+              취소
+            </Button>
+          </SheetClose>
+          <SheetClose asChild>
+            <Button variant="primary" appearance="solid">
+              저장
+            </Button>
+          </SheetClose>
+        </SheetFooter>
+      </SheetContent>
+    </Sheet>
+  )
+}
+
+function SideCase({ side, defaultOpen }: { side: Side; defaultOpen?: boolean }) {
+  return (
+    <Frame trigger={side} side={side} defaultOpen={defaultOpen} title="설정" description="화면 가장자리에서 열리는 보조 패널입니다.">
+      <p>{`side="${side}"`}</p>
+    </Frame>
+  )
+}
+
+function FormCase({ defaultOpen }: { defaultOpen?: boolean }) {
+  return (
+    <Frame trigger="폼" defaultOpen={defaultOpen} title="프로젝트 정보">
+      <div className="grid gap-2">
+        <label htmlFor="sheet-form-name" className="text-sm font-medium text-muted-foreground">
+          프로젝트명
+        </label>
+        <Input id="sheet-form-name" size="medium" placeholder="프로젝트명을 입력하세요" />
+      </div>
+    </Frame>
+  )
+}
+
+function LongCase({ defaultOpen }: { defaultOpen?: boolean }) {
+  return (
+    <Frame trigger="긴 내용" defaultOpen={defaultOpen} title="긴 내용" description="Body만 scroll 합니다.">
+      {Array.from({ length: 30 }, (_, i) => (
+        <p key={i} className="mb-3">
+          {longText}
+        </p>
+      ))}
+    </Frame>
+  )
+}
+
+const meta = { title: "Components/Overlay/Sheet", component: Sheet, parameters: { layout: "centered" } } satisfies Meta<typeof Sheet>
+export default meta
+type Story = StoryObj<typeof meta>
+
+export const All: Story = {
+  name: "Sheet",
+  parameters: { layout: "fullscreen", controls: { disable: true } },
+  render: () => (
+    <StoryPage>
+      <StoryPageHeader
+        kicker={STORY_KICKER.components}
+        title="Sheet"
+        description="화면 가장자리에서 열리는 보조 모달 패널입니다. 각 버튼을 눌러 실제 Sheet를 엽니다."
+      />
+      <StorySection title="Overview" description="side를 생략한 기본 방향(right)입니다.">
+        <SideCase side="right" />
+      </StorySection>
+      <StorySection title="Variants" description="side: left / top / bottom.">
+        <div className="flex flex-wrap gap-3">
+          <SideCase side="left" />
+          <SideCase side="top" />
+          <SideCase side="bottom" />
+        </div>
+      </StorySection>
+      <StorySection title="Usage" description="폼 입력 조합과, 내용이 길 때 Body만 scroll 하는 경우입니다.">
+        <div className="flex flex-wrap gap-3">
+          <FormCase />
+          <LongCase />
+        </div>
+      </StorySection>
+    </StoryPage>
+  ),
+}
+
+// Verification Stories: the same cases starting open, hidden from the sidebar (tag `verification`).
+export const Right: Story = { tags: ["verification"], render: () => <SideCase side="right" defaultOpen /> }
+export const Left: Story = { tags: ["verification"], render: () => <SideCase side="left" defaultOpen /> }
+export const Top: Story = { tags: ["verification"], render: () => <SideCase side="top" defaultOpen /> }
+export const Bottom: Story = { tags: ["verification"], render: () => <SideCase side="bottom" defaultOpen /> }
+export const Form: Story = { tags: ["verification"], render: () => <FormCase defaultOpen /> }
+export const LongContent: Story = { tags: ["verification"], name: "Long Content", render: () => <LongCase defaultOpen /> }