[Feature] TextField 컴포넌트 구현

apps/wow-docs/app/page.tsx

@@ -1,8 +1,6 @@
 import { css } from "@styled-system/css/css";
 import Switch from "wowds-ui/Switch";
 
-import Checkbox from "../../../packages/wow-ui/src/components/Checkbox";
-
 const Home = () => {
   return (
     <>
@@ -16,7 +14,6 @@ const Home = () => {
         <p>docs</p>
       </main>
       <Switch />
-      <Checkbox />
     </>
   );
 };

packages/theme/src/tokens/breakpoint.ts

@@ -0,0 +1,8 @@
+import { breakpoint } from "wowds-tokens";
+
+export const breakpoints = {
+  xs: breakpoint.xs,
+  sm: breakpoint.sm,
+  md: breakpoint.md,
+  lg: breakpoint.lg,
+};

packages/theme/src/tokens/index.ts

@@ -1,5 +1,7 @@
+export * from "./breakpoint.ts";
 export * from "./color.ts";
 export * from "./typography.ts";
+
 import { defineTokens } from "@pandacss/dev";
 
 import { colors, gradients } from "./color.ts";

packages/wow-tokens/src/breakpoint.ts

@@ -0,0 +1,4 @@
+export const xs = "360px";
+export const sm = "600px";
+export const md = "900px";
+export const lg = "1280px";

packages/wow-tokens/src/color.ts

@@ -90,14 +90,14 @@ export const blackOpacity80 = "rgba(0, 0, 0, 0.8)";
 
 // 시맨틱 토큰
 export const primary = blue500;
-export const success = green500;
-export const error = red500;
+export const success = green600;
+export const error = red600;
 
 export const backgroundNormal = white;
 export const backgroundAlternative = mono50;
 export const backgroundDimmer = blackOpacity80;
 
-export const sub = mono600;
+export const sub = mono700;
 export const outline = mono400;
 export const textBlack = black;
 export const textWhite = white;

packages/wow-tokens/src/index.ts

@@ -1,3 +1,4 @@
+export * as breakpoint from "./breakpoint.ts";
 export * as color from "./color.ts";
 export * as radius from "./radius.ts";
 export * as space from "./space.ts";

packages/wow-tokens/src/typography.ts

@@ -64,6 +64,7 @@ export const label2 = {
   fontSize: "0.875rem",
   lineHeight: "100%",
   fontWeight: 600,
+  letterSpacing: "-0.01rem",
 };
 
 export const label3 = {

packages/wow-ui/package.json

@@ -40,6 +40,11 @@
       "require": "./dist/Switch.cjs",
       "import": "./dist/Switch.js"
     },
+    "./TextField": {
+      "types": "./dist/components/TextField/index.d.ts",
+      "require": "./dist/TextField.cjs",
+      "import": "./dist/TextField.js"
+    },
     "./Chip": {
       "types": "./dist/components/Chip/index.d.ts",
       "require": "./dist/Chip.cjs",

packages/wow-ui/panda.config.ts

@@ -1,5 +1,5 @@
 import { defineConfig, defineGlobalStyles } from "@pandacss/dev";
-import { semanticTokens, textStyles, tokens } from "theme";
+import { semanticTokens, textStyles, tokens, breakpoints } from "theme";
 import { removeUnusedCssVars, removeUnusedKeyframes } from "theme/utils";
 
 const globalCss = defineGlobalStyles({
@@ -32,5 +32,6 @@ export default defineConfig({
     tokens,
     textStyles,
     semanticTokens,
+    breakpoints,
   },
 });

packages/wow-ui/rollup.config.js

@@ -23,6 +23,7 @@ export default {
     Button: "./src/components/Button",
     Checkbox: "./src/components/Checkbox",
     Switch: "./src/components/Switch",
+    TextField: "./src/components/TextField",
   },
   output: [
     {

packages/wow-ui/src/components/TextField/TextField.stories.tsx

@@ -0,0 +1,246 @@
+import type { Meta, StoryObj } from "@storybook/react";
+import { useState } from "react";
+
+import TextField from "@/components/TextField";
+
+const meta = {
+  title: "UI/TextField",
+  component: TextField,
+  tags: ["autodocs"],
+  parameters: {
+    componentSubtitle: "텍스트필드 컴포넌트",
+    a11y: {
+      config: {
+        rules: [{ id: "color-contrast", enabled: false }],
+      },
+    },
+  },
+  argTypes: {
+    label: {
+      description: "텍스트필드의 라벨입니다.",
+      table: {
+        type: { summary: "string" },
+        defaultValue: { summary: null },
+      },
+      control: {
+        type: "text",
+      },
+      type: {
+        name: "string",
+        required: true,
+      },
+    },
+    placeholder: {
+      description: "텍스트필드의 플레이스홀더 텍스트입니다.",
+      table: {
+        type: { summary: "string" },
+        defaultValue: { summary: null },
+      },
+      control: {
+        type: "text",
+      },
+    },
+    defaultValue: {
+      description: "텍스트필드의 기본 값입니다.",
+      table: {
+        type: { summary: "string" },
+        defaultValue: { summary: null },
+      },
+      control: {
+        type: "text",
+      },
+    },
+    value: {
+      description: "외부에서 제어할 활성 상태입니다.",
+      table: {
+        type: { summary: "string" },
+        defaultValue: { summary: null },
+      },
+      control: {
+        type: "text",
+      },
+    },
+    maxLength: {
+      description: "텍스트필드의 최대 입력 길이입니다.",
+      table: {
+        type: { summary: "number" },
+        defaultValue: { summary: null },
+      },
+      control: {
+        type: "number",
+      },
+    },
+    error: {
+      description: "텍스트필드의 오류 상태 여부입니다.",
+      table: {
+        type: { summary: "boolean" },
+        defaultValue: { summary: false },
+      },
+      control: {
+        type: "boolean",
+      },
+    },
+    success: {
+      description: "텍스트필드의 성공 상태 여부입니다.",
+      table: {
+        type: { summary: "boolean" },
+        defaultValue: { summary: false },
+      },
+      control: {
+        type: "boolean",
+      },
+    },
+    helperText: {
+      description: "텍스트필드 아래 추가적인 텍스트입니다.",
+      table: {
+        type: { summary: "ReactNode" },
+        defaultValue: { summary: null },
+      },
+      control: {
+        type: "text",
+      },
+    },
+    onChange: {
+      description: "외부 활성 상태가 변경될 때 호출될 콜백 함수입니다.",
+      table: {
+        type: { summary: "(value: string) => void" },
+        defaultValue: { summary: null },
+        control: {
+          type: "function",
+        },
+      },
+    },
+    onBlur: {
+      description: "텍스트필드가 포커스를 잃을 때 호출될 콜백 함수입니다.",
+      table: {
+        type: { summary: "() => void" },
+        defaultValue: { summary: null },
+        control: {
+          type: "function",
+        },
+      },
+    },
+    onFocus: {
+      description: "텍스트필드가 포커스됐을 때 호출될 콜백 함수입니다.",
+      table: {
+        type: { summary: "() => void" },
+        defaultValue: { summary: null },
+        control: {
+          type: "function",
+        },
+      },
+    },
+    textareaProps: {
+      description: "텍스트필드에 전달할 추가 textarea 속성입니다.",
+      table: {
+        type: { summary: "TextareaHTMLAttributes<HTMLTextAreaElement>" },
+        defaultValue: { summary: null },
+        control: {
+          type: "object",
+        },
+      },
+    },
+    style: {
+      description: "텍스트필드의 커스텀 스타일 속성입니다.",
+      table: {
+        type: { summary: "CSSProperties" },
+        defaultValue: { summary: null },
+        control: {
+          type: "object",
+        },
+      },
+    },
+    className: {
+      description: "텍스트필드에 전달하는 커스텀 클래스명입니다.",
+      table: {
+        type: { summary: "string" },
+        defaultValue: { summary: null },
+        control: {
+          type: "text",
+        },
+      },
+    },
+  },
+} satisfies Meta<typeof TextField>;
+
+export default meta;
+
+type Story = StoryObj<typeof meta>;
+
+export const Primary: Story = {
+  args: {
+    label: "Label",
+  },
+};
+
+export const WithMaxLength: Story = {
+  args: {
+    label: "Label",
+    maxLength: 10,
+  },
+};
+
+export const WithPlaceholder: Story = {
+  args: {
+    label: "Label",
+    placeholder:
+      "PlaceholderPlaceholderPlaceholderPlaceholderPlaceholderPlaceholderPlaceholder",
+  },
+};
+
+export const WithDefaultValue: Story = {
+  args: {
+    label: "Label",
+    defaultValue: "Text",
+  },
+};
+
+export const WithHelperText: Story = {
+  args: {
+    label: "Label",
+    helperText: "*Caption",
+  },
+};
+
+export const WithMaxLengthAndHelperText: Story = {
+  args: {
+    label: "Label",
+    maxLength: 100,
+    helperText: "*Caption",
+  },
+};
+
+export const Success: Story = {
+  args: {
+    label: "Label",
+    maxLength: 100,
+    helperText: "*Caption",
+    success: true,
+  },
+};
+
+export const Error: Story = {
+  args: {
+    label: "Label",
+    maxLength: 100,
+    helperText: "*Caption",
+    error: true,
+  },
+};
+
+const ControlledTextField = () => {
+  const [value, setValue] = useState("");
+
+  const handleChange = (value: string) => {
+    setValue(value);
+  };
+
+  return <TextField label="Label" value={value} onChange={handleChange} />;
+};
+
+export const ControlledState: Story = {
+  render: () => <ControlledTextField />,
+  args: {
+    label: "Label",
+  },
+};