@nexus-cross/design-system 1.0.0 → 1.0.2

package/dist/schemas.mjs

@@ -3,358 +3,432 @@ import { z } from 'zod';
 
 var buttonPropsSchema = z.object({
   semantic: z.enum(["primary", "secondary", "normal", "danger"]).default("primary").describe(
-    "\uC0C9\uC0C1 \uD14C\uB9C8 (primary=\uC8FC\uC694, secondary=\uBCF4\uC870, normal=\uC911\uB9BD, danger=\uC704\uD5D8)"
+    "Color theme (primary=main, secondary=sub, normal=neutral, danger=danger)"
   ),
   variant: z.enum(["contained", "outlined", "subtle", "ghost"]).default("contained").describe(
-    "\uC2DC\uAC01 \uC2A4\uD0C0\uC77C (contained=\uCC44\uC6C0, outlined=\uD14C\uB450\uB9AC, subtle=\uC5F0\uD55C\uBC30\uACBD, ghost=\uD22C\uBA85)"
+    "Visual style (contained=filled, outlined=border, subtle=light bg, ghost=transparent)"
   ),
-  size: z.enum(["xl", "lg", "md", "sm"]).default("md").describe("\uD06C\uAE30"),
-  radius: z.enum(["default", "circle"]).default("default").describe("\uBAA8\uC11C\uB9AC (default=size\uBCC4 radius, circle=pill \uD615\uD0DC)"),
-  asChild: z.boolean().optional().describe("true\uBA74 \uC790\uC2DD \uC694\uC18C\uB85C \uB80C\uB354\uB9C1 (Slot \uD328\uD134)"),
-  detectDoubleClick: z.boolean().optional().describe("500ms \uB0B4 \uB354\uBE14 \uD074\uB9AD \uBC29\uC9C0"),
-  disabled: z.boolean().optional().describe("\uBE44\uD65C\uC131 (aria-disabled \uC790\uB3D9)"),
-  className: z.string().optional().describe("\uC2A4\uD0C0\uC77C \uC624\uBC84\uB77C\uC774\uB4DC")
+  size: z.enum(["xl", "lg", "md", "sm"]).default("md").describe("Size"),
+  radius: z.enum(["default", "circle"]).default("default").describe("Corner radius (default=size-based radius, circle=pill shape)"),
+  asChild: z.boolean().optional().describe("If true, renders as child element (Slot pattern)"),
+  detectDoubleClick: z.boolean().optional().describe("Prevent double click within 500ms"),
+  disabled: z.boolean().optional().describe("Disabled (auto aria-disabled)"),
+  children: z.any().optional().describe("Button content (ReactNode)"),
+  onClick: z.any().optional().describe("Click event handler"),
+  type: z.enum(["button", "submit", "reset"]).optional().describe("HTML button type (default: button)"),
+  style: z.any().optional().describe("Inline style (CSSProperties)"),
+  className: z.string().optional().describe("Style override")
 }).describe(
-  "\uC778\uD130\uB799\uD2F0\uBE0C \uBC84\uD2BC. semantic(\uC0C9\uC0C1)\xD7variant(\uC2A4\uD0C0\uC77C) 2\uCD95 \uC2DC\uC2A4\uD15C. asChild\uB85C \uB80C\uB354\uB9C1 \uC694\uC18C \uBCC0\uACBD \uAC00\uB2A5."
+  "Interactive button. semantic(color) x variant(style) 2-axis system. Rendering element changeable via asChild."
 );
 var textInputPropsSchema = z.object({
-  size: z.enum(["sm", "md", "lg", "xl"]).default("md").describe("\uD06C\uAE30"),
-  error: z.boolean().optional().describe("\uC5D0\uB7EC \uC0C1\uD0DC (aria-invalid \uC790\uB3D9)"),
-  prefixIcon: z.any().optional().describe("\uC55E\uCABD \uC544\uC774\uCF58 (ReactNode)"),
-  suffixIcon: z.any().optional().describe("\uB4A4\uCABD \uC544\uC774\uCF58 (ReactNode)"),
-  label: z.any().optional().describe("\uC785\uB825 \uD544\uB4DC \uC704 \uB77C\uBCA8 (ReactNode)"),
-  description: z.any().optional().describe("\uC785\uB825 \uD544\uB4DC \uC544\uB798 \uC124\uBA85 \uD14D\uC2A4\uD2B8 (ReactNode, error \uC2DC \uBE68\uAC04\uC0C9)"),
-  showCount: z.boolean().optional().describe("\uAE00\uC790 \uC218 \uCE74\uC6B4\uD2B8 \uD45C\uC2DC (maxLength \uD544\uC694)"),
-  maxLength: z.number().optional().describe("\uCD5C\uB300 \uAE00\uC790 \uC218"),
-  clearable: z.boolean().optional().describe("X \uBC84\uD2BC\uC73C\uB85C \uC785\uB825\uAC12 \uCD08\uAE30\uD654"),
-  placeholder: z.string().optional().describe("\uD50C\uB808\uC774\uC2A4\uD640\uB354"),
-  disabled: z.boolean().optional().describe("\uBE44\uD65C\uC131"),
-  onValueChange: z.any().optional().describe("\uAC12 \uBCC0\uACBD \uCF5C\uBC31 (value: string) => void"),
-  className: z.string().optional().describe("\uC2A4\uD0C0\uC77C \uC624\uBC84\uB77C\uC774\uB4DC")
-}).describe("\uD14D\uC2A4\uD2B8 \uC785\uB825 \uD544\uB4DC. label, description, prefix/suffix \uC544\uC774\uCF58, clearable, \uAE00\uC790 \uC218 \uCE74\uC6B4\uD2B8 \uC9C0\uC6D0.");
+  size: z.enum(["md", "lg", "xl"]).default("md").describe("Size"),
+  error: z.boolean().optional().describe("Error state (auto aria-invalid)"),
+  prefixIcon: z.any().optional().describe("Prefix icon (ReactNode)"),
+  suffixIcon: z.any().optional().describe("Suffix icon (ReactNode)"),
+  label: z.any().optional().describe("Label above input field (ReactNode)"),
+  description: z.any().optional().describe("Description below input field (ReactNode, red on error)"),
+  showCount: z.boolean().optional().describe("Show character count (requires maxLength)"),
+  maxLength: z.number().optional().describe("Maximum character count"),
+  clearable: z.boolean().optional().describe("Clear input via X button"),
+  placeholder: z.string().optional().describe("Placeholder"),
+  disabled: z.boolean().optional().describe("Disabled"),
+  readOnly: z.boolean().optional().describe("Read-only"),
+  value: z.string().optional().describe("Input value (controlled mode)"),
+  defaultValue: z.string().optional().describe("Initial value (uncontrolled mode)"),
+  type: z.string().optional().describe("Input type (text, password, email, url, etc.)"),
+  name: z.string().optional().describe("Form field name"),
+  id: z.string().optional().describe("Element ID (for label htmlFor binding)"),
+  autoFocus: z.boolean().optional().describe("Auto focus"),
+  autoComplete: z.string().optional().describe("Autocomplete hint (on, off, email, etc.)"),
+  onValueChange: z.any().optional().describe("Value change callback (value: string) => void"),
+  onChange: z.any().optional().describe("Native change event handler"),
+  onBlur: z.any().optional().describe("Blur callback"),
+  onFocus: z.any().optional().describe("Focus callback"),
+  className: z.string().optional().describe("Style override")
+}).describe("Text input field. Supports label, description, prefix/suffix icons, clearable, character counter.");
 var textAreaPropsSchema = z.object({
-  error: z.boolean().optional().describe("\uC5D0\uB7EC \uC0C1\uD0DC (aria-invalid \uC790\uB3D9)"),
-  showCount: z.boolean().optional().describe("\uAE00\uC790 \uC218 \uD45C\uC2DC (maxLength \uD544\uC694)"),
-  maxLength: z.number().optional().describe("\uCD5C\uB300 \uAE00\uC790 \uC218"),
-  placeholder: z.string().optional().describe("\uD50C\uB808\uC774\uC2A4\uD640\uB354"),
-  rows: z.number().optional().describe("\uD45C\uC2DC \uC904 \uC218"),
-  disabled: z.boolean().optional().describe("\uBE44\uD65C\uC131"),
-  onValueChange: z.any().optional().describe("\uAC12 \uBCC0\uACBD \uCF5C\uBC31 (value: string) => void"),
-  className: z.string().optional().describe("\uC2A4\uD0C0\uC77C \uC624\uBC84\uB77C\uC774\uB4DC")
-}).describe("\uC5EC\uB7EC \uC904 \uD14D\uC2A4\uD2B8 \uC785\uB825. \uAE00\uC790 \uC218 \uCE74\uC6B4\uD130 \uB0B4\uC7A5.");
+  error: z.boolean().optional().describe("Error state (auto aria-invalid)"),
+  showCount: z.boolean().optional().describe("Show character count (requires maxLength)"),
+  maxLength: z.number().optional().describe("Maximum character count"),
+  placeholder: z.string().optional().describe("Placeholder"),
+  rows: z.number().optional().describe("Visible row count"),
+  disabled: z.boolean().optional().describe("Disabled"),
+  readOnly: z.boolean().optional().describe("Read-only"),
+  value: z.string().optional().describe("Input value (controlled mode)"),
+  defaultValue: z.string().optional().describe("Initial value (uncontrolled mode)"),
+  name: z.string().optional().describe("Form field name"),
+  id: z.string().optional().describe("Element ID"),
+  autoFocus: z.boolean().optional().describe("Auto focus"),
+  onValueChange: z.any().optional().describe("Value change callback (value: string) => void"),
+  onChange: z.any().optional().describe("Native change event handler"),
+  onBlur: z.any().optional().describe("Blur callback"),
+  onFocus: z.any().optional().describe("Focus callback"),
+  className: z.string().optional().describe("Style override")
+}).describe("Multi-line text input. Built-in character counter.");
 var selectPropsSchema = z.object({
-  value: z.string().optional().describe("\uC120\uD0DD\uB41C \uAC12"),
-  placeholder: z.string().optional().describe("\uD50C\uB808\uC774\uC2A4\uD640\uB354"),
-  variant: z.enum(["default", "outline"]).default("default").describe("\uD2B8\uB9AC\uAC70 \uC2A4\uD0C0\uC77C"),
-  size: z.enum(["sm", "md", "lg", "full"]).default("full").describe("\uB108\uBE44"),
-  disabled: z.boolean().optional().describe("\uBE44\uD65C\uC131"),
-  onValueChange: z.any().optional().describe("\uAC12 \uBCC0\uACBD \uCF5C\uBC31 (value: string) => void"),
-  displayComponent: z.any().optional().describe("\uD2B8\uB9AC\uAC70\uC5D0 \uCEE4\uC2A4\uD140 \uD45C\uC2DC (ReactNode)"),
-  children: z.any().describe("SelectItem \uBAA9\uB85D (ReactNode, \uD544\uC218)"),
-  className: z.string().optional().describe("\uB798\uD37C \uC2A4\uD0C0\uC77C"),
-  triggerClassName: z.string().optional().describe("\uD2B8\uB9AC\uAC70 \uC2A4\uD0C0\uC77C \uC624\uBC84\uB77C\uC774\uB4DC")
-}).describe("\uB4DC\uB86D\uB2E4\uC6B4 \uC120\uD0DD. Radix Select \uAE30\uBC18. SelectItem\uACFC \uD568\uAED8 \uC0AC\uC6A9.");
+  value: z.string().optional().describe("Selected value"),
+  placeholder: z.string().optional().describe("Placeholder"),
+  variant: z.enum(["default", "outline"]).default("default").describe("Trigger style"),
+  size: z.enum(["sm", "md", "lg", "full"]).default("full").describe("Width"),
+  disabled: z.boolean().optional().describe("Disabled"),
+  onValueChange: z.any().optional().describe("Value change callback (value: string) => void"),
+  displayComponent: z.any().optional().describe("Custom display in trigger (ReactNode)"),
+  children: z.any().describe("SelectItem list (ReactNode, required)"),
+  className: z.string().optional().describe("Wrapper style"),
+  triggerClassName: z.string().optional().describe("Trigger style override")
+}).describe("Dropdown select. Based on Radix Select. Used with SelectItem.");
 var selectItemPropsSchema = z.object({
-  value: z.string().describe("\uD56D\uBAA9 \uAC12"),
-  children: z.any().describe("\uD56D\uBAA9 \uB0B4\uC6A9 (ReactNode, \uD544\uC218)"),
-  disabled: z.boolean().optional().describe("\uBE44\uD65C\uC131"),
-  className: z.string().optional().describe("\uC2A4\uD0C0\uC77C \uC624\uBC84\uB77C\uC774\uB4DC")
-}).describe("Select \uB0B4 \uAC1C\uBCC4 \uC635\uC158.");
+  value: z.string().describe("Item value"),
+  children: z.any().describe("Item content (ReactNode, required)"),
+  disabled: z.boolean().optional().describe("Disabled"),
+  className: z.string().optional().describe("Style override")
+}).describe("Individual option within Select.");
 var checkBoxPropsSchema = z.object({
-  size: z.enum(["sm", "md"]).default("md").describe("\uD06C\uAE30"),
-  shape: z.enum(["square", "round"]).default("square").describe("\uD615\uD0DC"),
-  checked: z.boolean().optional().describe("\uCCB4\uD06C \uC0C1\uD0DC"),
-  indeterminate: z.boolean().optional().describe('\uBD88\uD655\uC815 \uC0C1\uD0DC (aria-checked="mixed")'),
-  disabled: z.boolean().optional().describe("\uBE44\uD65C\uC131"),
-  readOnly: z.boolean().optional().describe("\uC77D\uAE30 \uC804\uC6A9. \uB124\uC774\uD2F0\uBE0C input readOnly\uC640 \uB3D9\uC77C\uD558\uAC8C \uCCB4\uD06C \uC0C1\uD0DC \uBCC0\uACBD \uBD88\uAC00"),
-  label: z.any().optional().describe("\uB77C\uBCA8 \uD14D\uC2A4\uD2B8 (ReactNode)"),
-  onCheckedChange: z.any().optional().describe("\uCCB4\uD06C \uC0C1\uD0DC \uBCC0\uACBD \uCF5C\uBC31 (checked: boolean) => void"),
-  className: z.string().optional().describe("\uC2A4\uD0C0\uC77C \uC624\uBC84\uB77C\uC774\uB4DC")
-}).describe("\uCCB4\uD06C\uBC15\uC2A4. \uB124\uC774\uD2F0\uBE0C input \uAE30\uBC18, square/round \uD615\uD0DC \uC9C0\uC6D0.");
+  size: z.enum(["sm", "md"]).default("md").describe("Size"),
+  shape: z.enum(["square", "round"]).default("square").describe("Shape"),
+  checked: z.boolean().optional().describe("Checked state"),
+  indeterminate: z.boolean().optional().describe('Indeterminate state (aria-checked="mixed")'),
+  disabled: z.boolean().optional().describe("Disabled"),
+  readOnly: z.boolean().optional().describe("Read-only"),
+  label: z.any().optional().describe("Label text (ReactNode)"),
+  children: z.any().optional().describe("Label alternative content (ReactNode)"),
+  name: z.string().optional().describe("Form field name"),
+  id: z.string().optional().describe("Element ID"),
+  value: z.string().optional().describe("Value for form submission"),
+  onCheckedChange: z.any().optional().describe("Checked state change callback (checked: boolean) => void"),
+  onChange: z.any().optional().describe("Native change event handler"),
+  className: z.string().optional().describe("Style override")
+}).describe("Checkbox. Native input-based, supports square/round shapes.");
 var radioGroupPropsSchema = z.object({
-  name: z.string().describe("form name (\uD544\uC218)"),
-  value: z.string().optional().describe("\uC120\uD0DD\uB41C \uAC12 (\uC81C\uC5B4)"),
-  defaultValue: z.string().optional().describe("\uCD08\uAE30\uAC12 (\uBE44\uC81C\uC5B4)"),
-  size: z.enum(["sm", "md"]).default("md").describe("\uD06C\uAE30"),
-  orientation: z.enum(["horizontal", "vertical"]).default("vertical").describe("\uBC30\uCE58 \uBC29\uD5A5"),
-  disabled: z.boolean().optional().describe("\uBE44\uD65C\uC131"),
-  "aria-label": z.string().optional().describe("\uC811\uADFC\uC131 \uB77C\uBCA8"),
-  onValueChange: z.any().optional().describe("\uAC12 \uBCC0\uACBD \uCF5C\uBC31 (value: string) => void"),
-  className: z.string().optional().describe("\uC2A4\uD0C0\uC77C \uC624\uBC84\uB77C\uC774\uB4DC")
-}).describe("\uB77C\uB514\uC624 \uADF8\uB8F9. RadioItem\uACFC \uD568\uAED8 \uC0AC\uC6A9.");
+  name: z.string().describe("Form name (required)"),
+  value: z.string().optional().describe("Selected value (controlled)"),
+  defaultValue: z.string().optional().describe("Initial value (uncontrolled)"),
+  size: z.enum(["sm", "md"]).default("md").describe("Size"),
+  orientation: z.enum(["horizontal", "vertical"]).default("vertical").describe("Layout direction"),
+  disabled: z.boolean().optional().describe("Disabled"),
+  children: z.any().describe("RadioItem list (ReactNode, required)"),
+  "aria-label": z.string().optional().describe("Accessibility label"),
+  "aria-labelledby": z.string().optional().describe("Accessibility label reference ID"),
+  onValueChange: z.any().optional().describe("Value change callback (value: string) => void"),
+  className: z.string().optional().describe("Style override")
+}).describe("Radio group. Used with RadioItem.");
 var radioItemPropsSchema = z.object({
-  value: z.string().describe("\uD56D\uBAA9 \uAC12 (\uD544\uC218)"),
-  size: z.enum(["sm", "md"]).optional().describe("\uD06C\uAE30 (\uADF8\uB8F9\uBCF4\uB2E4 \uC6B0\uC120)"),
-  label: z.any().optional().describe("\uB77C\uBCA8 \uD14D\uC2A4\uD2B8 (ReactNode)"),
-  disabled: z.boolean().optional().describe("\uBE44\uD65C\uC131")
-}).describe("RadioGroup \uB0B4 \uAC1C\uBCC4 \uC635\uC158.");
+  value: z.string().describe("Item value (required)"),
+  size: z.enum(["sm", "md"]).optional().describe("Size (overrides group)"),
+  label: z.any().optional().describe("Label text (ReactNode)"),
+  children: z.any().optional().describe("Label alternative content (ReactNode)"),
+  disabled: z.boolean().optional().describe("Disabled"),
+  className: z.string().optional().describe("Style override")
+}).describe("Individual option within RadioGroup.");
 var switchPropsSchema = z.object({
-  size: z.enum(["sm", "md"]).default("md").describe("\uD06C\uAE30"),
-  checked: z.boolean().optional().describe("on/off \uC0C1\uD0DC"),
-  disabled: z.boolean().optional().describe("\uBE44\uD65C\uC131"),
-  readOnly: z.boolean().optional().describe("\uC77D\uAE30 \uC804\uC6A9. \uB124\uC774\uD2F0\uBE0C input readOnly\uC640 \uB3D9\uC77C\uD558\uAC8C on/off \uC0C1\uD0DC \uBCC0\uACBD \uBD88\uAC00"),
-  onCheckedChange: z.any().optional().describe("\uD1A0\uAE00 \uC0C1\uD0DC \uBCC0\uACBD \uCF5C\uBC31 (checked: boolean) => void"),
-  className: z.string().optional().describe("\uC2A4\uD0C0\uC77C \uC624\uBC84\uB77C\uC774\uB4DC")
-}).describe('\uD1A0\uAE00 \uC2A4\uC704\uCE58. \uB124\uC774\uD2F0\uBE0C checkbox \uAE30\uBC18, role="switch".');
+  size: z.enum(["sm", "md"]).default("md").describe("Size"),
+  checked: z.boolean().optional().describe("On/off state"),
+  disabled: z.boolean().optional().describe("Disabled"),
+  readOnly: z.boolean().optional().describe("Read-only"),
+  name: z.string().optional().describe("Form field name"),
+  id: z.string().optional().describe("Element ID"),
+  onCheckedChange: z.any().optional().describe("Toggle state change callback (checked: boolean) => void"),
+  onChange: z.any().optional().describe("Native change event handler (ChangeEvent)"),
+  className: z.string().optional().describe("Style override")
+}).describe('Toggle switch. Native checkbox-based, role="switch".');
 var chipPropsSchema = z.object({
-  variant: z.enum(["default", "filled", "outline", "accent"]).default("default").describe("\uC2A4\uD0C0\uC77C"),
-  size: z.enum(["sm", "md", "lg"]).default("md").describe("\uD06C\uAE30"),
-  asChild: z.boolean().optional().describe("true\uBA74 \uC790\uC2DD \uC694\uC18C\uB85C \uB80C\uB354\uB9C1 (Slot \uD328\uD134)"),
-  disabled: z.boolean().optional().describe("\uBE44\uD65C\uC131 (aria-disabled \uC790\uB3D9)"),
-  onClose: z.any().optional().describe("\uB2EB\uAE30 \uBC84\uD2BC \uD074\uB9AD \uCF5C\uBC31 () => void"),
-  className: z.string().optional().describe("\uC2A4\uD0C0\uC77C \uC624\uBC84\uB77C\uC774\uB4DC")
-}).describe("\uCE69/\uD0DC\uADF8/\uBC43\uC9C0. onClose prop\uC73C\uB85C \uB2EB\uAE30 \uBC84\uD2BC \uD45C\uC2DC.");
+  variant: z.enum(["default", "filled", "outline", "accent"]).default("default").describe("Style"),
+  size: z.enum(["sm", "md", "lg"]).default("md").describe("Size"),
+  asChild: z.boolean().optional().describe("If true, renders as child element (Slot pattern)"),
+  disabled: z.boolean().optional().describe("Disabled (auto aria-disabled)"),
+  children: z.any().optional().describe("Chip content (ReactNode)"),
+  onClose: z.any().optional().describe("Close button click callback (e: MouseEvent) => void. Shows X button when provided"),
+  onClick: z.any().optional().describe("Click event handler"),
+  className: z.string().optional().describe("Style override")
+}).describe("Chip/tag/badge. Close button displayed via onClose prop.");
 var spinnerPropsSchema = z.object({
-  size: z.number().default(20).describe("px \uD06C\uAE30"),
-  "aria-label": z.string().default("Loading").describe("\uC811\uADFC\uC131 \uB77C\uBCA8"),
-  className: z.string().optional().describe("\uC0C9\uC0C1 \uB4F1 \uC624\uBC84\uB77C\uC774\uB4DC")
-}).describe('\uB85C\uB529 \uC778\uB514\uCF00\uC774\uD130. SVG \uAE30\uBC18. role="status" \uB0B4\uC7A5.');
+  size: z.number().default(20).describe("Size in px"),
+  color: z.string().optional().describe("Color (CSS color value, default currentColor)"),
+  "aria-label": z.string().default("Loading").describe("Accessibility label"),
+  style: z.any().optional().describe("Inline style (CSSProperties)"),
+  className: z.string().optional().describe("Color override etc.")
+}).describe('Loading indicator. SVG-based. Built-in role="status".');
 var skeletonPropsSchema = z.object({
-  as: z.enum(["div", "span"]).default("div").describe("\uB80C\uB354\uB9C1 \uD0DC\uADF8"),
-  circle: z.boolean().default(false).describe("\uC6D0\uD615 \uC2A4\uCF08\uB808\uD1A4 (rounded-full)"),
-  width: z.union([z.string(), z.number()]).optional().describe("\uB108\uBE44 (\uC608: '100px', '50%', 200)"),
-  height: z.union([z.string(), z.number()]).optional().describe("\uB192\uC774 (\uC608: '16px', 40)"),
-  children: z.any().optional().describe("\uB0B4\uBD80 \uCF58\uD150\uCE20 (\uB85C\uB529 \uC644\uB8CC \uC2DC \uD45C\uC2DC, \uC2E4\uC81C \uD06C\uAE30 \uC720\uC9C0\uC6A9)"),
-  className: z.string().optional().describe("\uC2A4\uD0C0\uC77C \uC624\uBC84\uB77C\uC774\uB4DC")
+  as: z.enum(["div", "span"]).default("div").describe("Rendered tag"),
+  circle: z.boolean().default(false).describe("Circle skeleton (rounded-full)"),
+  width: z.union([z.string(), z.number()]).optional().describe("Width (e.g. '100px', '50%', 200)"),
+  height: z.union([z.string(), z.number()]).optional().describe("Height (e.g. '16px', 40)"),
+  children: z.any().optional().describe("Inner content (shown when loaded, maintains actual size)"),
+  style: z.any().optional().describe("Inline style (CSSProperties)"),
+  className: z.string().optional().describe("Style override")
 }).describe(
-  "\uC2A4\uCF08\uB808\uD1A4 \uB85C\uB529 \uD50C\uB808\uC774\uC2A4\uD640\uB354. className\uC73C\uB85C \uD06C\uAE30/\uBAA8\uC591 \uC870\uC808. children\uC774 \uC788\uC73C\uBA74 \uD22C\uBA85\uD558\uAC8C \uAC10\uC2F8\uC11C \uC2E4\uC81C \uD06C\uAE30 \uC720\uC9C0."
+  "Skeleton loading placeholder. Size/shape via className. With children, wraps transparently to maintain actual size."
 );
 var dividerPropsSchema = z.object({
-  orientation: z.enum(["horizontal", "vertical"]).default("horizontal").describe("\uBC29\uD5A5"),
-  variant: z.enum(["solid", "dashed", "dotted"]).default("solid").describe("\uC120 \uC2A4\uD0C0\uC77C"),
-  color: z.string().optional().describe("\uCEE4\uC2A4\uD140 \uC0C9\uC0C1 (CSS \uAC12)"),
-  className: z.string().optional().describe("\uC2A4\uD0C0\uC77C \uC624\uBC84\uB77C\uC774\uB4DC")
-}).describe("\uAD6C\uBD84\uC120. \uC218\uD3C9/\uC218\uC9C1 \uBC29\uD5A5, \uC2E4\uC120/\uC810\uC120/\uD30C\uC120 \uC9C0\uC6D0.");
+  orientation: z.enum(["horizontal", "vertical"]).default("horizontal").describe("Direction"),
+  variant: z.enum(["solid", "dashed", "dotted"]).default("solid").describe("Line style"),
+  color: z.string().optional().describe("Custom color (CSS value)"),
+  style: z.any().optional().describe("Inline style (CSSProperties)"),
+  className: z.string().optional().describe("Style override")
+}).describe("Divider. Supports horizontal/vertical, solid/dashed/dotted.");
 var tooltipPropsSchema = z.object({
-  children: z.any().describe("\uD2B8\uB9AC\uAC70 \uC694\uC18C (ReactNode, \uD544\uC218)"),
-  content: z.any().describe("\uD234\uD301 \uB0B4\uC6A9 (ReactNode, \uD544\uC218)"),
-  variant: z.enum(["dark", "light"]).default("dark").describe("\uC2A4\uD0C0\uC77C"),
-  side: z.enum(["top", "right", "bottom", "left"]).default("top").describe("\uC704\uCE58"),
-  align: z.enum(["start", "center", "end"]).default("center").describe("\uC815\uB82C"),
-  delayDuration: z.number().default(200).describe("\uD45C\uC2DC \uC9C0\uC5F0 (ms)"),
-  disabled: z.boolean().default(false).describe("\uBE44\uD65C\uC131"),
-  className: z.string().optional().describe("Content \uC2A4\uD0C0\uC77C"),
-  triggerClassName: z.string().optional().describe("Trigger \uC2A4\uD0C0\uC77C")
-}).describe("\uD234\uD301. Radix Tooltip \uAE30\uBC18. Provider \uB0B4\uC7A5.");
+  children: z.any().describe("Trigger element (ReactNode, required)"),
+  content: z.any().describe("Tooltip content (ReactNode, required)"),
+  variant: z.enum(["dark", "light"]).default("dark").describe("Style"),
+  side: z.enum(["top", "right", "bottom", "left"]).default("top").describe("Position"),
+  align: z.enum(["start", "center", "end"]).default("center").describe("Alignment"),
+  delayDuration: z.number().default(200).describe("Show delay (ms)"),
+  disabled: z.boolean().default(false).describe("Disabled"),
+  className: z.string().optional().describe("Content style"),
+  triggerClassName: z.string().optional().describe("Trigger style")
+}).describe("Tooltip. Based on Radix Tooltip. Built-in Provider.");
 var popoverPropsSchema = z.object({
-  trigger: z.any().describe("\uD2B8\uB9AC\uAC70 \uC694\uC18C (ReactNode, \uD544\uC218)"),
-  side: z.enum(["top", "right", "bottom", "left"]).default("bottom").describe("\uC704\uCE58"),
-  align: z.enum(["start", "center", "end"]).default("center").describe("\uC815\uB82C"),
-  sideOffset: z.number().default(4).describe("\uC704\uCE58 \uC624\uD504\uC14B (px)"),
-  alignOffset: z.number().optional().describe("\uC815\uB82C \uC624\uD504\uC14B (px)"),
-  open: z.boolean().optional().describe("\uC81C\uC5B4 \uBAA8\uB4DC"),
-  onOpenChange: z.any().optional().describe("\uC5F4\uB9BC/\uB2EB\uD798 \uC0C1\uD0DC \uBCC0\uACBD \uCF5C\uBC31 (open: boolean) => void"),
-  onClickTrigger: z.any().optional().describe("\uD2B8\uB9AC\uAC70 \uC694\uC18C \uD074\uB9AD \uC2DC \uD638\uCD9C\uB418\uB294 \uCF5C\uBC31. PopoverPrimitive.Trigger\uC758 onClick\uC5D0 \uC804\uB2EC\uB428."),
-  children: z.any().optional().describe("\uD31D\uC624\uBC84 \uBCF8\uBB38 (ReactNode)"),
-  className: z.string().optional().describe("Content \uC2A4\uD0C0\uC77C"),
-  arrowClassName: z.string().optional().describe("Arrow \uC2A4\uD0C0\uC77C")
-}).describe("\uD31D\uC624\uBC84. Radix Popover \uAE30\uBC18.");
+  trigger: z.any().describe("Trigger element (ReactNode, required)"),
+  side: z.enum(["top", "right", "bottom", "left"]).default("bottom").describe("Position"),
+  align: z.enum(["start", "center", "end"]).default("center").describe("Alignment"),
+  sideOffset: z.number().default(4).describe("Position offset (px)"),
+  alignOffset: z.number().optional().describe("Alignment offset (px)"),
+  open: z.boolean().optional().describe("Controlled mode"),
+  onOpenChange: z.any().optional().describe("Open/close state change callback (open: boolean) => void"),
+  onClickTrigger: z.any().optional().describe("Callback on trigger element click. Passed to PopoverPrimitive.Trigger onClick."),
+  children: z.any().optional().describe("Popover body (ReactNode)"),
+  className: z.string().optional().describe("Content style"),
+  arrowClassName: z.string().optional().describe("Arrow style")
+}).describe("Popover. Based on Radix Popover.");
 var accordionItemData = z.object({
-  id: z.string().describe("\uACE0\uC720 ID"),
-  trigger: z.any().describe("\uD2B8\uB9AC\uAC70 \uB0B4\uC6A9 (ReactNode)"),
-  content: z.any().describe("\uD3BC\uCE68 \uB0B4\uC6A9 (ReactNode)"),
-  disabled: z.boolean().optional().describe("\uBE44\uD65C\uC131"),
+  id: z.string().describe("Unique ID"),
+  trigger: z.any().describe("Trigger content (ReactNode)"),
+  content: z.any().describe("Expandable content (ReactNode)"),
+  disabled: z.boolean().optional().describe("Disabled"),
   className: z.string().optional(),
   triggerClassName: z.string().optional(),
   contentClassName: z.string().optional()
 });
 var accordionPropsSchema = z.object({
-  items: z.array(accordionItemData).describe("\uC544\uCF54\uB514\uC5B8 \uD56D\uBAA9 \uBC30\uC5F4 (\uD544\uC218)"),
-  type: z.enum(["single", "multiple"]).default("single").describe("\uB2E8\uC77C/\uB2E4\uC911 \uC5F4\uAE30"),
-  collapsible: z.boolean().default(true).describe("\uC804\uBD80 \uC811\uAE30 \uAC00\uB2A5"),
-  value: z.union([z.string(), z.array(z.string())]).optional().describe("\uC81C\uC5B4 \uBAA8\uB4DC"),
-  defaultValue: z.union([z.string(), z.array(z.string())]).optional().describe("\uBE44\uC81C\uC5B4 \uCD08\uAE30\uAC12"),
-  onValueChange: z.any().optional().describe("\uC5F4\uB9B0 \uD56D\uBAA9 \uBCC0\uACBD \uCF5C\uBC31 (value: string | string[]) => void"),
-  className: z.string().optional().describe("Root \uC2A4\uD0C0\uC77C")
-}).describe("\uC544\uCF54\uB514\uC5B8. items \uBC30\uC5F4 \uBC29\uC2DD\uACFC \uCEF4\uD3EC\uC800\uBE14 \uBC29\uC2DD \uBAA8\uB450 \uC9C0\uC6D0.");
+  items: z.array(accordionItemData).describe("Accordion item array (required)"),
+  type: z.enum(["single", "multiple"]).default("single").describe("Single/multiple open mode"),
+  collapsible: z.boolean().default(true).describe("Allow collapsing all"),
+  value: z.union([z.string(), z.array(z.string())]).optional().describe("Controlled mode"),
+  defaultValue: z.union([z.string(), z.array(z.string())]).optional().describe("Uncontrolled initial value"),
+  onValueChange: z.any().optional().describe("Open item change callback (value: string | string[]) => void"),
+  className: z.string().optional().describe("Root style")
+}).describe("Accordion. Supports both items array and composable patterns.");
 var drawerDirection = z.enum(["bottom", "top", "left", "right"]).default("bottom");
 var drawerPropsSchema = z.object({
-  direction: drawerDirection.describe("\uBC29\uD5A5"),
-  children: z.any().optional().describe("Drawer \uD558\uC704 \uCEF4\uD3EC\uB10C\uD2B8 (ReactNode)")
-}).describe("\uB4DC\uB85C\uC5B4/\uBC14\uD140\uC2DC\uD2B8. Vaul \uAE30\uBC18. \uD569\uC131 \uCEF4\uD3EC\uB10C\uD2B8 \uD328\uD134.");
+  direction: drawerDirection.describe("Direction"),
+  open: z.boolean().optional().describe("Open state (controlled mode)"),
+  onOpenChange: z.any().optional().describe("Open state change callback (open: boolean) => void"),
+  dismissible: z.boolean().optional().describe("Allow close via swipe/outside click (default true)"),
+  modal: z.boolean().optional().describe("Modal mode (default true). If false, background is interactive"),
+  shouldScaleBackground: z.boolean().optional().describe("Background scale effect (default false)"),
+  children: z.any().describe("Drawer sub-components (ReactNode, required)")
+}).describe("Drawer/bottom sheet. Based on Vaul. Compound component pattern.");
 var drawerContentPropsSchema = z.object({
-  direction: drawerDirection.optional().describe("\uBC29\uD5A5 (Context \uC6B0\uC120)"),
-  blur: z.enum(["none", "sm", "md"]).default("none").describe("\uC624\uBC84\uB808\uC774 \uBE14\uB7EC"),
-  showHandle: z.boolean().default(true).describe("\uD578\uB4E4 \uBC14 \uD45C\uC2DC"),
-  children: z.any().optional().describe("\uCEE8\uD150\uCE20 \uC601\uC5ED (ReactNode)"),
-  overlayClassName: z.string().optional().describe("\uC624\uBC84\uB808\uC774 \uC2A4\uD0C0\uC77C"),
-  className: z.string().optional().describe("\uD328\uB110 \uC2A4\uD0C0\uC77C")
-}).describe("Drawer.Content \uC601\uC5ED.");
+  direction: drawerDirection.optional().describe("Direction (Context takes priority)"),
+  blur: z.enum(["none", "sm", "md"]).default("none").describe("Overlay blur"),
+  showHandle: z.boolean().default(true).describe("Show handle bar"),
+  children: z.any().optional().describe("Content area (ReactNode)"),
+  overlayClassName: z.string().optional().describe("Overlay style"),
+  className: z.string().optional().describe("Panel style")
+}).describe("Drawer.Content area.");
+var drawerTriggerPropsSchema = z.object({
+  asChild: z.boolean().optional().describe("Render as child element"),
+  children: z.any().describe("Trigger element (ReactNode, required)"),
+  className: z.string().optional().describe("Style override")
+}).describe("Drawer open trigger.");
+var drawerClosePropsSchema = z.object({
+  asChild: z.boolean().optional().describe("Render as child element"),
+  children: z.any().describe("Close element (ReactNode, required)"),
+  className: z.string().optional().describe("Style override")
+}).describe("Drawer close button.");
+var drawerTitlePropsSchema = z.object({
+  children: z.any().describe("Title text (ReactNode, required)"),
+  className: z.string().optional().describe("Style override")
+}).describe("Drawer title (required for accessibility).");
+var drawerDescriptionPropsSchema = z.object({
+  children: z.any().describe("Description text (ReactNode, required)"),
+  className: z.string().optional().describe("Style override")
+}).describe("Drawer description.");
 var tabItem = z.object({
-  key: z.string().describe("\uD0ED \uACE0\uC720 \uD0A4"),
-  label: z.any().describe("\uD0ED \uB77C\uBCA8 (ReactNode)"),
-  children: z.any().optional().describe("\uD0ED \uD328\uB110 \uB0B4\uC6A9 (ReactNode)"),
-  disabled: z.boolean().optional().describe("\uBE44\uD65C\uC131")
+  key: z.string().describe("Tab unique key"),
+  label: z.any().describe("Tab label (ReactNode)"),
+  children: z.any().optional().describe("Tab panel content (ReactNode)"),
+  disabled: z.boolean().optional().describe("Disabled")
 });
 var tabPropsSchema = z.object({
-  items: z.array(tabItem).describe("\uD0ED \uD56D\uBAA9 \uBC30\uC5F4 (\uD544\uC218)"),
-  activeKey: z.string().optional().describe("\uC81C\uC5B4 \uBAA8\uB4DC \uD65C\uC131 \uD0A4"),
-  defaultActiveKey: z.string().optional().describe("\uBE44\uC81C\uC5B4 \uCD08\uAE30 \uD0A4"),
-  variant: z.enum(["line", "pill"]).default("line").describe("\uC2A4\uD0C0\uC77C"),
-  size: z.enum(["sm", "md"]).default("md").describe("\uD06C\uAE30"),
-  destroyInactive: z.boolean().default(false).describe("\uBE44\uD65C\uC131 \uD328\uB110 \uC5B8\uB9C8\uC6B4\uD2B8"),
-  onTabChange: z.any().optional().describe("\uD0ED \uBCC0\uACBD \uCF5C\uBC31 (key: string) => void"),
-  className: z.string().optional().describe("\uB8E8\uD2B8 \uC2A4\uD0C0\uC77C"),
-  tabListClassName: z.string().optional().describe("\uD0ED \uB9AC\uC2A4\uD2B8 \uC2A4\uD0C0\uC77C"),
-  tabPanelClassName: z.string().optional().describe("\uD0ED \uD328\uB110 \uC2A4\uD0C0\uC77C")
-}).describe("\uD0ED \uB124\uBE44\uAC8C\uC774\uC158. line/pill \uBCC0\uD615.");
+  items: z.array(tabItem).describe("Tab item array (required)"),
+  activeKey: z.string().optional().describe("Controlled mode active key"),
+  defaultActiveKey: z.string().optional().describe("Uncontrolled initial key"),
+  variant: z.enum(["line", "pill"]).default("line").describe("Style"),
+  size: z.enum(["sm", "md"]).default("md").describe("Size"),
+  destroyInactive: z.boolean().default(false).describe("Unmount inactive panels"),
+  onTabChange: z.any().optional().describe("Tab change callback (key: string) => void"),
+  className: z.string().optional().describe("Root style"),
+  tabListClassName: z.string().optional().describe("Tab list style"),
+  tabPanelClassName: z.string().optional().describe("Tab panel style")
+}).describe("Tab navigation. line/pill variants.");
 var carouselPropsSchema = z.object({
-  opts: z.record(z.any()).optional().describe("Embla \uC635\uC158 (loop, align \uB4F1)"),
-  plugins: z.array(z.any()).optional().describe("Embla \uD50C\uB7EC\uADF8\uC778"),
-  onApiChange: z.any().optional().describe("Embla API \uBCC0\uACBD \uCF5C\uBC31 (api: CarouselApi) => void"),
-  children: z.any().optional().describe("\uCE90\uB7EC\uC140 \uC2AC\uB77C\uC774\uB4DC \uBC0F \uC11C\uBE0C \uCEF4\uD3EC\uB10C\uD2B8 (ReactNode)"),
-  className: z.string().optional().describe("\uC2A4\uD0C0\uC77C \uC624\uBC84\uB77C\uC774\uB4DC")
+  opts: z.record(z.any()).optional().describe("Embla options (loop, align, etc.)"),
+  plugins: z.array(z.any()).optional().describe("Embla plugins"),
+  onApiChange: z.any().optional().describe("Embla API change callback (api: CarouselApi) => void"),
+  children: z.any().optional().describe("Carousel slides and sub-components (ReactNode)"),
+  className: z.string().optional().describe("Style override")
 }).describe(
-  "\uCE90\uB7EC\uC140. Embla Carousel \uAE30\uBC18. CarouselSlide, CarouselPrev, CarouselNext, CarouselDots \uC11C\uBE0C \uCEF4\uD3EC\uB10C\uD2B8."
+  "Carousel. Based on Embla Carousel. Sub-components: CarouselSlide, CarouselPrev, CarouselNext, CarouselDots."
 );
 var carouselSlidePropsSchema = z.object({
-  className: z.string().optional().describe("\uC2AC\uB77C\uC774\uB4DC \uC2A4\uD0C0\uC77C (basis-1/3 \uB4F1\uC73C\uB85C \uBCF5\uC218 \uB178\uCD9C)"),
-  children: z.any().describe("\uC2AC\uB77C\uC774\uB4DC \uB0B4\uC6A9 (ReactNode, \uD544\uC218)")
-}).describe("\uCE90\uB7EC\uC140 \uC2AC\uB77C\uC774\uB4DC. Carousel \uB0B4\uBD80\uC5D0\uC11C \uC0AC\uC6A9.");
+  className: z.string().optional().describe("Slide style (use basis-1/3 etc. for multi-slide view)"),
+  children: z.any().describe("Slide content (ReactNode, required)")
+}).describe("Carousel slide. Used inside Carousel.");
 var carouselButtonPropsSchema = z.object({
-  className: z.string().optional().describe("\uBC84\uD2BC \uC2A4\uD0C0\uC77C \uC624\uBC84\uB77C\uC774\uB4DC"),
-  children: z.any().optional().describe("\uCEE4\uC2A4\uD140 \uC544\uC774\uCF58 (ReactNode, \uAE30\uBCF8: chevron)")
-}).describe("CarouselPrev / CarouselNext. \uC774\uC804/\uB2E4\uC74C \uB0B4\uBE44\uAC8C\uC774\uC158 \uBC84\uD2BC.");
+  className: z.string().optional().describe("Button style override"),
+  children: z.any().optional().describe("Custom icon (ReactNode, default: chevron)")
+}).describe("CarouselPrev / CarouselNext. Previous/next navigation buttons.");
 var carouselDotsPropsSchema = z.object({
-  className: z.string().optional().describe("\uB3C4\uD2B8 \uCEE8\uD14C\uC774\uB108 \uC2A4\uD0C0\uC77C")
-}).describe("CarouselDots. \uC2AC\uB77C\uC774\uB4DC \uC778\uB514\uCF00\uC774\uD130 \uB3C4\uD2B8.");
+  className: z.string().optional().describe("Dot container style")
+}).describe("CarouselDots. Slide indicator dots.");
 var paginationPropsSchema = z.object({
-  currentPage: z.number().describe("\uD604\uC7AC \uD398\uC774\uC9C0 (1\uBD80\uD130, \uD544\uC218)"),
-  totalPages: z.number().describe("\uC804\uCCB4 \uD398\uC774\uC9C0 \uC218 (\uD544\uC218)"),
-  siblingCount: z.number().default(1).describe("\uD604\uC7AC \uD398\uC774\uC9C0 \uC591\uC606 \uD45C\uC2DC \uAC1C\uC218"),
-  showEdges: z.boolean().optional().describe("\uCCAB/\uB05D \uD398\uC774\uC9C0 \uD56D\uC0C1 \uD45C\uC2DC"),
-  size: z.enum(["sm", "md"]).default("md").describe("\uD06C\uAE30"),
-  onPageChange: z.any().describe("\uD398\uC774\uC9C0 \uBCC0\uACBD \uCF5C\uBC31 (page: number) => void, \uD544\uC218"),
-  className: z.string().optional().describe("<nav> \uC2A4\uD0C0\uC77C")
-}).describe("\uD398\uC774\uC9C0\uB124\uC774\uC158. \uC774\uC804/\uB2E4\uC74C + \uBC88\uD638 \uBC84\uD2BC.");
+  currentPage: z.number().describe("Current page (1-based, required)"),
+  totalPages: z.number().describe("Total page count (required)"),
+  siblingCount: z.number().default(1).describe("Number of pages shown on each side of current"),
+  showEdges: z.boolean().optional().describe("Always show first/last page"),
+  size: z.enum(["sm", "md"]).default("md").describe("Size"),
+  onPageChange: z.any().describe("Page change callback (page: number) => void, required"),
+  className: z.string().optional().describe("<nav> style")
+}).describe("Pagination. Previous/next + page number buttons.");
 var avatarPropsSchema = z.object({
-  src: z.string().optional().describe("\uC774\uBBF8\uC9C0 URL"),
-  alt: z.string().optional().describe("\uB300\uCCB4 \uD14D\uC2A4\uD2B8"),
-  fallback: z.any().optional().describe("\uC774\uBBF8\uC9C0 \uB85C\uB4DC \uC2E4\uD328 \uC2DC \uD45C\uC2DC (ReactNode)"),
-  size: z.enum(["xs", "sm", "md", "lg", "xl"]).default("md").describe("\uD06C\uAE30"),
-  shape: z.enum(["circle", "square"]).default("circle").describe("\uD615\uD0DC"),
-  children: z.any().optional().describe("\uCEE4\uC2A4\uD140 \uC774\uBBF8\uC9C0 \uC694\uC18C (\uC608: Next.js Image)"),
-  onImageError: z.any().optional().describe("\uC774\uBBF8\uC9C0 \uB85C\uB4DC \uC2E4\uD328 \uCF5C\uBC31 () => void"),
-  className: z.string().optional().describe("\uC2A4\uD0C0\uC77C \uC624\uBC84\uB77C\uC774\uB4DC")
-}).describe("\uC544\uBC14\uD0C0. \uC774\uBBF8\uC9C0, \uD3F4\uBC31 \uD14D\uC2A4\uD2B8, children \uC9C0\uC6D0.");
+  src: z.string().optional().describe("Image URL"),
+  alt: z.string().optional().describe("Alt text"),
+  fallback: z.any().optional().describe("Displayed on image load failure (ReactNode)"),
+  size: z.enum(["xs", "sm", "md", "lg", "xl"]).default("md").describe("Size"),
+  shape: z.enum(["circle", "square"]).default("circle").describe("Shape"),
+  children: z.any().optional().describe("Custom image element (e.g. Next.js Image)"),
+  onImageError: z.any().optional().describe("Image load error callback () => void"),
+  className: z.string().optional().describe("Style override")
+}).describe("Avatar. Supports image, fallback text, and children.");
 var counterPropsSchema = z.object({
-  endValue: z.number().describe("\uBAA9\uD45C \uAC12 (\uD544\uC218)"),
-  startValue: z.number().default(0).describe("\uC2DC\uC791 \uAC12"),
-  duration: z.number().default(1500).describe("\uC560\uB2C8\uBA54\uC774\uC158 \uC2DC\uAC04 (ms)"),
-  delay: z.number().default(0).describe("\uC2DC\uC791 \uC9C0\uC5F0 (ms)"),
-  separator: z.boolean().default(true).describe("\uCC9C \uB2E8\uC704 \uAD6C\uBD84"),
-  digits: z.number().default(0).describe("\uC18C\uC218 \uC790\uB9BF\uC218"),
-  triggerOnView: z.boolean().default(false).describe("\uBDF0\uD3EC\uD2B8 \uC9C4\uC785 \uC2DC \uC2DC\uC791"),
-  onEnd: z.any().optional().describe("\uCE74\uC6B4\uD2B8 \uC644\uB8CC \uCF5C\uBC31 () => void"),
-  className: z.string().optional().describe("\uC2A4\uD0C0\uC77C \uC624\uBC84\uB77C\uC774\uB4DC")
-}).describe("\uC22B\uC790 \uCE74\uC6B4\uD2B8 \uC560\uB2C8\uBA54\uC774\uC158.");
+  endValue: z.number().describe("Target value (required)"),
+  startValue: z.number().default(0).describe("Start value"),
+  duration: z.number().default(1500).describe("Animation duration (ms)"),
+  delay: z.number().default(0).describe("Start delay (ms)"),
+  separator: z.boolean().default(true).describe("Thousands separator"),
+  digits: z.number().default(0).describe("Decimal places"),
+  triggerOnView: z.boolean().default(false).describe("Start on viewport entry"),
+  onEnd: z.any().optional().describe("Count complete callback () => void"),
+  style: z.any().optional().describe("Inline style (CSSProperties)"),
+  className: z.string().optional().describe("Style override")
+}).describe("Number count animation.");
 var countdownPropsSchema = z.object({
-  endTimestamp: z.number().describe("\uC885\uB8CC \uC2DC\uAC01 (Unix ms, \uD544\uC218)"),
-  separator: z.any().default(":").describe("\uAD6C\uBD84\uC790 (ReactNode)"),
-  showDays: z.boolean().default(true).describe("\uC77C \uB2E8\uC704 \uD45C\uC2DC"),
+  endTimestamp: z.number().describe("End time (Unix ms, required)"),
+  separator: z.any().default(":").describe("Separator (ReactNode)"),
+  showDays: z.boolean().default(true).describe("Show days unit"),
   labels: z.object({
     days: z.string().optional(),
     hours: z.string().optional(),
     minutes: z.string().optional(),
     seconds: z.string().optional()
-  }).optional().describe("\uB2E8\uC704 \uB77C\uBCA8"),
-  render: z.any().optional().describe("\uCEE4\uC2A4\uD140 \uB80C\uB354 \uD568\uC218"),
-  onEnd: z.any().optional().describe("\uCE74\uC6B4\uD2B8\uB2E4\uC6B4 \uC885\uB8CC \uCF5C\uBC31 () => void"),
-  className: z.string().optional().describe("\uC2A4\uD0C0\uC77C \uC624\uBC84\uB77C\uC774\uB4DC")
-}).describe("\uCE74\uC6B4\uD2B8\uB2E4\uC6B4 \uD0C0\uC774\uBA38.");
+  }).optional().describe("Unit labels"),
+  render: z.any().optional().describe("Custom render function"),
+  onEnd: z.any().optional().describe("Countdown end callback () => void"),
+  className: z.string().optional().describe("Style override")
+}).describe("Countdown timer.");
 var marqueePropsSchema = z.object({
-  direction: z.enum(["left", "right", "up", "down"]).default("left").describe("\uBC29\uD5A5"),
-  speed: z.number().default(40).describe("\uC560\uB2C8\uBA54\uC774\uC158 \uC18D\uB3C4 (\uCD08)"),
-  pauseOnHover: z.boolean().default(false).describe("\uD638\uBC84 \uC2DC \uC77C\uC2DC\uC815\uC9C0"),
-  gap: z.number().default(16).describe("\uC544\uC774\uD15C \uAC04\uACA9 (px)"),
-  children: z.any().describe("\uBC18\uBCF5 \uD45C\uC2DC\uD560 \uCF58\uD150\uCE20 (ReactNode, \uD544\uC218)"),
-  className: z.string().optional().describe("\uC2A4\uD0C0\uC77C \uC624\uBC84\uB77C\uC774\uB4DC")
-}).describe("\uB9C8\uD034 (\uD750\uB974\uB294 \uD14D\uC2A4\uD2B8/\uC694\uC18C).");
+  direction: z.enum(["left", "right", "up", "down"]).default("left").describe("Direction"),
+  speed: z.number().default(40).describe("Animation speed (seconds)"),
+  pauseOnHover: z.boolean().default(false).describe("Pause on hover"),
+  gap: z.number().default(16).describe("Item gap (px)"),
+  children: z.any().describe("Content to repeat (ReactNode, required)"),
+  style: z.any().optional().describe("Inline style (CSSProperties)"),
+  className: z.string().optional().describe("Style override")
+}).describe("Marquee (scrolling text/elements).");
 var virtualListPropsSchema = z.object({
-  items: z.array(z.any()).describe("\uB370\uC774\uD130 \uBC30\uC5F4 (\uD544\uC218)"),
-  estimateSize: z.union([z.number(), z.any()]).describe("\uC608\uC0C1 \uC544\uC774\uD15C \uB192\uC774 (number \uB610\uB294 \uD568\uC218, \uD544\uC218)"),
-  renderItem: z.any().describe("\uC544\uC774\uD15C \uB80C\uB354\uB7EC (\uD544\uC218)"),
-  overscan: z.number().default(5).describe("\uC624\uBC84\uC2A4\uCE94 \uC218"),
-  gap: z.number().default(0).describe("\uC544\uC774\uD15C \uAC04\uACA9 (px)"),
-  className: z.string().optional().describe("\uC2A4\uD06C\uB864 \uCEE8\uD14C\uC774\uB108 \uC2A4\uD0C0\uC77C"),
-  endReachedThreshold: z.number().default(200).describe("\uB05D \uAC10\uC9C0 \uC784\uACC4\uAC12 (px)"),
-  onEndReached: z.any().optional().describe("\uB05D \uB3C4\uB2EC \uCF5C\uBC31 () => void")
-}).describe("\uAC00\uC0C1 \uC2A4\uD06C\uB864 \uB9AC\uC2A4\uD2B8. @tanstack/react-virtual \uAE30\uBC18.");
+  items: z.array(z.any()).describe("Data array (required)"),
+  estimateSize: z.union([z.number(), z.any()]).describe("Estimated item height (number or (index) => number, required)"),
+  renderItem: z.any().describe("Item renderer (item, index, virtualItem) => ReactNode (required)"),
+  overscan: z.number().default(5).describe("Overscan count"),
+  gap: z.number().default(0).describe("Item gap (px)"),
+  className: z.string().optional().describe("Scroll container style"),
+  style: z.any().optional().describe("Inline style (CSSProperties)"),
+  endReachedThreshold: z.number().default(200).describe("End detection threshold (px)"),
+  onEndReached: z.any().optional().describe("End reached callback () => void")
+}).describe("Virtual scroll list. Based on @tanstack/react-virtual.");
 var virtualGridPropsSchema = z.object({
-  items: z.array(z.any()).describe("\uB370\uC774\uD130 \uBC30\uC5F4 (\uD544\uC218)"),
-  estimateSize: z.union([z.number(), z.any()]).describe("\uC608\uC0C1 \uC544\uC774\uD15C \uB192\uC774 (\uD544\uC218)"),
-  columns: z.number().describe("\uC5F4 \uC218 (\uD544\uC218)"),
-  renderItem: z.any().describe("\uC544\uC774\uD15C \uB80C\uB354\uB7EC (\uD544\uC218)"),
-  overscan: z.number().default(3).describe("\uC624\uBC84\uC2A4\uCE94 \uC218"),
-  gap: z.number().default(0).describe("\uC544\uC774\uD15C \uAC04\uACA9 (px)"),
-  endReachedThreshold: z.number().default(200).describe("\uB05D \uAC10\uC9C0 \uC784\uACC4\uAC12 (px)"),
-  onEndReached: z.any().optional().describe("\uB05D \uB3C4\uB2EC \uCF5C\uBC31 () => void"),
-  className: z.string().optional().describe("\uC2A4\uD06C\uB864 \uCEE8\uD14C\uC774\uB108 \uC2A4\uD0C0\uC77C")
-}).describe("\uAC00\uC0C1 \uC2A4\uD06C\uB864 \uADF8\uB9AC\uB4DC. @tanstack/react-virtual \uAE30\uBC18.");
+  items: z.array(z.any()).describe("Data array (required)"),
+  columns: z.number().describe("Column count (required)"),
+  estimateSize: z.union([z.number(), z.any()]).describe("Estimated item height (required)"),
+  renderItem: z.any().describe("Item renderer (item, index) => ReactNode (required)"),
+  overscan: z.number().default(3).describe("Overscan count"),
+  gap: z.number().default(0).describe("Item gap (px)"),
+  className: z.string().optional().describe("Scroll container style"),
+  style: z.any().optional().describe("Inline style (CSSProperties)"),
+  endReachedThreshold: z.number().default(200).describe("End detection threshold (px)"),
+  onEndReached: z.any().optional().describe("End reached callback () => void")
+}).describe("Virtual scroll grid. Based on @tanstack/react-virtual.");
 var infiniteScrollPropsSchema = z.object({
-  list: z.array(z.any()).nullable().describe("\uD604\uC7AC \uB370\uC774\uD130 \uBC30\uC5F4 (\uD544\uC218)"),
-  totalCount: z.number().optional().describe("\uC804\uCCB4 \uAC1C\uC218 (hasMore\uC640 \uBC30\uD0C0\uC801 \uC0AC\uC6A9)"),
-  hasMore: z.boolean().optional().describe("\uB354 \uC788\uB294\uC9C0 (totalCount\uC640 \uBC30\uD0C0\uC801 \uC0AC\uC6A9)"),
-  tag: z.string().default("div").describe("children \uB798\uD37C \uD0DC\uADF8"),
-  rootMargin: z.number().default(100).describe("\uAC10\uC9C0 \uB9C8\uC9C4 (px)"),
-  loading: z.boolean().optional().describe("\uB85C\uB529 \uC0C1\uD0DC"),
-  loadingElement: z.any().optional().describe("\uCEE4\uC2A4\uD140 \uB85C\uB529 \uC694\uC18C"),
-  handleLoadMore: z.any().describe("\uCD94\uAC00 \uB85C\uB529 \uCF5C\uBC31 () => void, \uD544\uC218"),
-  scrollTarget: z.any().optional().describe("\uC2A4\uD06C\uB864 \uB300\uC0C1 \uC694\uC18C (HTMLElement | Document | MutableRefObject)"),
-  children: z.any().describe("\uB9AC\uC2A4\uD2B8 \uC544\uC774\uD15C \uB80C\uB354\uB9C1 (ReactNode, \uD544\uC218)"),
-  className: z.string().optional().describe("\uC2A4\uD0C0\uC77C \uC624\uBC84\uB77C\uC774\uB4DC")
-}).describe("\uBB34\uD55C \uC2A4\uD06C\uB864. IntersectionObserver \uAE30\uBC18.");
+  list: z.array(z.any()).nullable().describe("Current data array (required)"),
+  totalCount: z.number().optional().describe("Total count (mutually exclusive with hasMore)"),
+  hasMore: z.boolean().optional().describe("Has more items (mutually exclusive with totalCount)"),
+  tag: z.string().default("div").describe("Children wrapper tag"),
+  rootMargin: z.number().default(100).describe("Detection margin (px)"),
+  loading: z.boolean().optional().describe("Loading state"),
+  loadingElement: z.any().optional().describe("Custom loading element"),
+  handleLoadMore: z.any().describe("Load more callback () => void, required"),
+  scrollTarget: z.any().optional().describe("Scroll target element (HTMLElement | Document | MutableRefObject)"),
+  children: z.any().describe("List item rendering (ReactNode, required)"),
+  className: z.string().optional().describe("Style override")
+}).describe("Infinite scroll. Based on IntersectionObserver.");
 var ellipsisPropsSchema = z.object({
-  content: z.any().default("").describe("\uBCF8\uBB38 (ReactNode)"),
-  lineClamp: z.number().default(2).describe("\uC904 \uC218 \uC81C\uD55C"),
-  triggerMore: z.any().default("more").describe("\uB354\uBCF4\uAE30 \uD14D\uC2A4\uD2B8 (ReactNode)"),
-  triggerLess: z.any().default("less").describe("\uC811\uAE30 \uD14D\uC2A4\uD2B8 (ReactNode)"),
-  defaultShortened: z.boolean().default(true).describe("\uCD08\uAE30 \uC811\uD798 \uC0C1\uD0DC"),
-  observingEnvs: z.array(z.boolean()).optional().describe("\uC678\uBD80 \uC870\uAC74 \uBCC0\uACBD \uC2DC \uB9AC\uC0AC\uC774\uC988 \uC7AC\uCE21\uC815"),
-  onShowMoreLessClick: z.any().optional().describe("\uB354\uBCF4\uAE30/\uC811\uAE30 \uD074\uB9AD \uCF5C\uBC31 () => void"),
-  className: z.string().optional().describe("\uC2A4\uD0C0\uC77C \uC624\uBC84\uB77C\uC774\uB4DC")
-}).describe("\uD14D\uC2A4\uD2B8 \uB9D0\uC904\uC784. \uB354\uBCF4\uAE30/\uC811\uAE30 \uD1A0\uAE00 \uB0B4\uC7A5.");
+  content: z.any().default("").describe("Body text (ReactNode)"),
+  lineClamp: z.number().default(2).describe("Line clamp limit"),
+  triggerMore: z.any().default("more").describe("Show more text (ReactNode)"),
+  triggerLess: z.any().default("less").describe("Show less text (ReactNode)"),
+  defaultShortened: z.boolean().default(true).describe("Initial collapsed state"),
+  observingEnvs: z.array(z.boolean()).optional().describe("Re-measure on external condition change"),
+  onShowMoreLessClick: z.any().optional().describe("Show more/less click callback () => void"),
+  className: z.string().optional().describe("Style override")
+}).describe("Text ellipsis. Built-in show more/less toggle.");
 var numberInputPropsSchema = z.object({
-  value: z.union([z.number(), z.string()]).optional().describe("\uD604\uC7AC \uAC12"),
-  size: z.enum(["sm", "md", "lg", "xl"]).default("md").describe("\uD06C\uAE30"),
-  error: z.boolean().optional().describe("\uC5D0\uB7EC \uC0C1\uD0DC"),
-  min: z.number().optional().describe("\uCD5C\uC18C\uAC12"),
-  max: z.number().optional().describe("\uCD5C\uB300\uAC12"),
-  step: z.number().default(1).describe("\uC99D\uAC10 \uB2E8\uC704"),
-  digit: z.number().default(0).describe("\uC18C\uC218 \uC790\uB9BF\uC218"),
-  hideButtons: z.boolean().default(false).describe("\uAE30\uBCF8 \uC2A4\uD540 \uBC84\uD2BC \uC228\uAE40. numberInputBind\uB85C \uC678\uBD80 \uBC84\uD2BC\uC5D0 \uC774\uBCA4\uD2B8 \uBD80\uCC29 \uC2DC \uC0AC\uC6A9"),
-  disabled: z.boolean().optional().describe("\uBE44\uD65C\uC131"),
-  readOnly: z.boolean().optional().describe("\uC77D\uAE30 \uC804\uC6A9. \uC785\uB825\xB7\uC2A4\uD540 \uBC84\uD2BC\uC73C\uB85C \uAC12 \uBCC0\uACBD \uBD88\uAC00(\uC2A4\uD540 \uBC84\uD2BC\uC740 \uC228\uAE40)"),
-  placeholder: z.string().optional().describe("\uD50C\uB808\uC774\uC2A4\uD640\uB354"),
-  onValueChange: z.any().optional().describe("\uAC12 \uBCC0\uACBD \uCF5C\uBC31 (value: number | undefined) => void"),
-  className: z.string().optional().describe("\uC2A4\uD0C0\uC77C \uC624\uBC84\uB77C\uC774\uB4DC")
+  value: z.union([z.number(), z.string()]).optional().describe("Current value"),
+  size: z.enum(["sm", "md", "lg", "xl"]).default("md").describe("Size"),
+  error: z.boolean().optional().describe("Error state"),
+  min: z.number().optional().describe("Minimum value"),
+  max: z.number().optional().describe("Maximum value"),
+  step: z.number().default(1).describe("Step increment"),
+  digit: z.number().default(0).describe("Decimal places"),
+  hideButtons: z.boolean().default(false).describe("Hide default spin buttons. Use with numberInputBind for external button event binding"),
+  disabled: z.boolean().optional().describe("Disabled"),
+  readOnly: z.boolean().optional().describe("Read-only (includes hiding spin buttons)"),
+  placeholder: z.string().optional().describe("Placeholder"),
+  name: z.string().optional().describe("Form field name"),
+  id: z.string().optional().describe("Element ID"),
+  autoFocus: z.boolean().optional().describe("Auto focus"),
+  onValueChange: z.any().optional().describe("Value change callback (value: number | undefined) => void"),
+  onBlur: z.any().optional().describe("Blur callback"),
+  onFocus: z.any().optional().describe("Focus callback"),
+  className: z.string().optional().describe("Style override")
 }).describe(
-  "\uC22B\uC790 \uC785\uB825. \uAFB9 \uB204\uB974\uBA74 \uAC00\uC18D \uC99D\uAC10. ref\uB85C increment/decrement \uBA54\uC11C\uB4DC \uB178\uCD9C. numberInputBind(ref, direction) \uD568\uC218\uB85C \uC678\uBD80 \uBC84\uD2BC\uC5D0 \uB3D9\uC77C\uD55C \uAC00\uC18D \uC774\uBCA4\uD2B8 \uBC14\uC778\uB529 \uAC00\uB2A5."
+  "Number input. Accelerated increment on long press. Exposes increment/decrement methods via ref. numberInputBind(ref, direction) binds same acceleration to external buttons."
 );
 var dataListPropsSchema = z.object({
-  list: z.array(z.any()).nullable().describe("\uB80C\uB354\uB9C1\uD560 \uB370\uC774\uD130 \uBC30\uC5F4. null\uC774\uBA74 \uB85C\uB529 \uC0C1\uD0DC (\uD544\uC218)"),
-  noDataMessage: z.any().optional().describe("\uBE48 \uBC30\uC5F4\uC77C \uB54C \uD45C\uC2DC\uD560 \uBA54\uC2DC\uC9C0 (string | ReactElement)"),
-  errorFallback: z.any().optional().describe("\uC5D0\uB7EC \uBC1C\uC0DD \uC2DC \uD45C\uC2DC\uD560 fallback (ReactNode)"),
-  loadingElement: z.any().optional().describe("\uB85C\uB529 \uC911 \uD45C\uC2DC\uD560 \uCEE4\uC2A4\uD140 \uC694\uC18C (\uAE30\uBCF8: Spinner)"),
-  skeletonElement: z.any().optional().describe("\uB85C\uB529 \uC911 \uD45C\uC2DC\uD560 \uC2A4\uCF08\uB808\uD1A4 \uC694\uC18C (ReactElement)"),
-  skeletonCount: z.number().default(3).describe("\uC2A4\uCF08\uB808\uD1A4 \uBC18\uBCF5 \uAC1C\uC218"),
-  loading: z.boolean().default(false).describe("\uAC15\uC81C \uB85C\uB529 \uC0C1\uD0DC"),
-  children: z.any().describe("\uAC01 \uC544\uC774\uD15C \uB80C\uB354 \uD568\uC218: ({ item, index }) => ReactNode (\uD544\uC218)"),
-  className: z.string().optional().describe("\uB8E8\uD2B8 \uC694\uC18C \uC2A4\uD0C0\uC77C")
+  list: z.array(z.any()).nullable().describe("Data array to render. null = loading state (required)"),
+  noDataMessage: z.any().optional().describe("Message for empty array (string | ReactElement)"),
+  errorFallback: z.any().optional().describe("Fallback on error (ReactNode)"),
+  loadingElement: z.any().optional().describe("Custom loading element (default: Spinner)"),
+  skeletonElement: z.any().optional().describe("Skeleton element during loading (ReactElement)"),
+  skeletonCount: z.number().default(3).describe("Skeleton repeat count"),
+  loading: z.boolean().default(false).describe("Force loading state"),
+  children: z.any().describe("Item render function: ({ item, index }) => ReactNode (required)"),
+  className: z.string().optional().describe("Root element style")
 }).describe(
-  "\uB370\uC774\uD130 \uB9AC\uC2A4\uD2B8. list \uC0C1\uD0DC\uC5D0 \uB530\uB77C \uB85C\uB529/\uC2A4\uCF08\uB808\uD1A4/\uBE48 \uC0C1\uD0DC/\uB370\uC774\uD130\uB97C \uC790\uB3D9 \uCC98\uB9AC. ErrorBoundary \uB0B4\uC7A5."
+  "Data list. Automatically handles loading/skeleton/empty/data states based on list. Built-in ErrorBoundary."
 );
 var animationOptionsSchema = z.object({
-  name: z.string().optional().describe("\uC560\uB2C8\uBA54\uC774\uC158 \uC774\uB984"),
-  mobile: z.string().optional().describe("\uBAA8\uBC14\uC77C\uC6A9 \uC560\uB2C8\uBA54\uC774\uC158 \uC774\uB984"),
-  delay: z.number().optional().describe("\uC9C0\uC5F0 (ms)"),
-  duration: z.number().optional().describe("\uC9C0\uC18D \uC2DC\uAC04 (ms)"),
-  timingFunc: z.string().optional().describe("\uD0C0\uC774\uBC0D \uD568\uC218"),
-  leaveTimingFunc: z.string().optional().describe("\uD1F4\uC7A5 \uD0C0\uC774\uBC0D \uD568\uC218")
-}).describe("\uBAA8\uB2EC \uC560\uB2C8\uBA54\uC774\uC158 \uC635\uC158");
+  name: z.string().optional().describe("Animation name"),
+  mobile: z.string().optional().describe("Mobile animation name"),
+  delay: z.number().optional().describe("Delay (ms)"),
+  duration: z.number().optional().describe("Duration (ms)"),
+  timingFunc: z.string().optional().describe("Timing function"),
+  leaveTimingFunc: z.string().optional().describe("Exit timing function")
+}).describe("Modal animation options");
 var modalTemplatePropsSchema = z.object({
-  title: z.any().optional().describe("\uD5E4\uB354 \uC81C\uBAA9 (ReactNode)"),
-  desc: z.any().optional().describe("\uD5E4\uB354 \uC124\uBA85 (ReactNode)"),
+  title: z.any().optional().describe("Header title (ReactNode)"),
+  desc: z.any().optional().describe("Header description (ReactNode)"),
   layout: z.enum([
     "default",
     "bottom-sheet",
@@ -363,95 +437,142 @@ var modalTemplatePropsSchema = z.object({
     "full-page",
     "full-page-reverse",
     "draggable"
-  ]).default("default").describe("\uB808\uC774\uC544\uC6C3"),
-  showDim: z.boolean().default(true).describe("\uB524 \uBC30\uACBD \uD45C\uC2DC"),
-  dimClose: z.boolean().default(true).describe("\uB524 \uD074\uB9AD \uC2DC \uB2EB\uAE30"),
-  hideHeader: z.boolean().default(false).describe("\uD5E4\uB354 \uC228\uAE40"),
-  hideFooter: z.boolean().default(true).describe("\uD478\uD130 \uC228\uAE40"),
-  footer: z.any().optional().describe("\uCEE4\uC2A4\uD140 \uD478\uD130 (ReactElement)"),
-  animation: animationOptionsSchema.optional().describe("\uBAA8\uB2EC \uC560\uB2C8\uBA54\uC774\uC158 (ModalTemplatePropsType)"),
-  enableDrag: z.boolean().default(true).describe("\uB4DC\uB798\uADF8 \uD65C\uC131\uD654 (\uBC14\uD140\uC2DC\uD2B8\xB7\uB4DC\uB798\uADF8 \uAC00\uB2A5 \uB808\uC774\uC544\uC6C3)"),
-  dragPersistKey: z.string().optional().describe("\uB4DC\uB798\uADF8 \uC704\uCE58 \uC800\uC7A5 \uD0A4"),
-  children: z.any().describe("\uBAA8\uB2EC \uBCF8\uBB38 (ReactNode, \uD544\uC218)"),
-  className: z.string().optional().describe("\uB8E8\uD2B8 \uB798\uD37C \uC2A4\uD0C0\uC77C"),
-  innerClassName: z.string().optional().describe("\uBAA8\uB2EC \uBCF8\uCCB4 \uC2A4\uD0C0\uC77C"),
-  bodyClassName: z.string().optional().describe("\uBC14\uB514 \uC601\uC5ED \uC2A4\uD0C0\uC77C"),
-  footerClassName: z.string().optional().describe("\uD478\uD130 \uC601\uC5ED \uC2A4\uD0C0\uC77C"),
-  dimClassName: z.string().optional().describe("\uB524 \uBC30\uACBD \uC2A4\uD0C0\uC77C"),
-  headerClassName: z.string().optional().describe("\uD5E4\uB354 \uC601\uC5ED \uC2A4\uD0C0\uC77C")
+  ]).default("default").describe("Layout"),
+  showDim: z.boolean().default(true).describe("Show dim overlay"),
+  dimClose: z.boolean().default(true).describe("Close on dim click"),
+  hideHeader: z.boolean().default(false).describe("Hide header"),
+  hideFooter: z.boolean().default(true).describe("Hide footer"),
+  footer: z.any().optional().describe("Custom footer (ReactElement)"),
+  animation: animationOptionsSchema.optional().describe("Modal animation"),
+  enableDrag: z.boolean().default(true).describe("Enable drag (bottom-sheet/draggable layouts)"),
+  dragPersistKey: z.string().optional().describe("Drag position persistence key"),
+  close: z.any().describe("Modal close function (isAnimation?: boolean) => void (auto-injected)"),
+  children: z.any().describe("Modal body (ReactNode, required)"),
+  className: z.string().optional().describe("Root wrapper style"),
+  innerClassName: z.string().optional().describe("Modal body style"),
+  bodyClassName: z.string().optional().describe("Body area style"),
+  footerClassName: z.string().optional().describe("Footer area style"),
+  dimClassName: z.string().optional().describe("Dim overlay style"),
+  headerClassName: z.string().optional().describe("Header area style")
 }).describe(
-  "\uBAA8\uB2EC \uD15C\uD50C\uB9BF. \uBAA8\uB4E0 \uBAA8\uB2EC \uCEF4\uD3EC\uB10C\uD2B8\uB294 \uBC18\uB4DC\uC2DC ModalTemplate\uC73C\uB85C \uAC10\uC2F8\uC57C \uD55C\uB2E4."
+  "Modal template. All modal components must be wrapped with ModalTemplate."
 );
 var modalCallSchema = z.object({
-  component: z.any().describe("\uBAA8\uB2EC \uCEF4\uD3EC\uB10C\uD2B8 (\uD544\uC218)"),
-  props: z.record(z.any()).optional().describe("\uCEF4\uD3EC\uB10C\uD2B8\uC5D0 \uC804\uB2EC\uD560 props")
+  component: z.any().describe("Modal component (required). Automatically receives close/resolve as props"),
+  props: z.record(z.any()).optional().describe("Props to pass to component"),
+  id: z.string().optional().describe("Modal ID (used for duplicate check)"),
+  layout: z.enum([
+    "default",
+    "bottom-sheet",
+    "slide-left",
+    "slide-right",
+    "full-page",
+    "full-page-reverse",
+    "draggable"
+  ]).optional().describe("Layout"),
+  animation: animationOptionsSchema.optional().describe("Modal animation"),
+  scrollEnable: z.boolean().optional().describe("Allow background scroll"),
+  isToggle: z.boolean().optional().describe("Toggle mode (close on re-call of same modal)"),
+  isAlone: z.boolean().optional().describe("Alone mode (close all existing modals before opening)"),
+  duplicateCheck: z.boolean().optional().describe("Prevent duplicate opening of same component"),
+  disableEscapeKeyPress: z.boolean().optional().describe("Disable close via ESC key"),
+  componentName: z.string().optional().describe("Modal identifier name (used for duplicate check, modal search)"),
+  onOpen: z.any().optional().describe("Callback when modal opens"),
+  onClose: z.any().optional().describe("Callback when modal closes")
 }).describe(
-  "modal() \uD568\uC218 \uD638\uCD9C \uD615\uD0DC. component\uB294 close/resolve\uB97C \uC790\uB3D9\uC73C\uB85C props\uB85C \uBC1B\uB294\uB2E4."
+  "modal() function call options. component automatically receives close/resolve as props."
 );
 var errorBoundaryPropsSchema = z.object({
-  children: z.any().describe("\uAC10\uC2F8\uC9C8 \uC790\uC2DD \uC694\uC18C (ReactNode, \uD544\uC218)"),
-  fallback: z.any().optional().describe("\uC5D0\uB7EC \uBC1C\uC0DD \uC2DC \uB300\uCCB4 UI (ReactNode)"),
-  onError: z.any().optional().describe("\uC5D0\uB7EC \uBC1C\uC0DD \uCF5C\uBC31 (error: Error, errorInfo: ErrorInfo) => void")
-}).describe("\uC5D0\uB7EC \uACBD\uACC4. \uD558\uC704 \uCEF4\uD3EC\uB10C\uD2B8 \uB80C\uB354\uB9C1 \uC5D0\uB7EC\uB97C \uC7A1\uC544 fallback UI \uD45C\uC2DC.");
+  children: z.any().describe("Child elements to wrap (ReactNode, required)"),
+  fallback: z.any().optional().describe("Fallback UI on error (ReactNode)"),
+  onError: z.any().optional().describe("Error callback (error: Error, errorInfo: ErrorInfo) => void")
+}).describe("Error boundary. Catches child component render errors and displays fallback UI.");
 var clientOnlyPropsSchema = z.object({
-  children: z.any().describe("\uD074\uB77C\uC774\uC5B8\uD2B8\uC5D0\uC11C\uB9CC \uB80C\uB354\uB9C1\uD560 \uC694\uC18C (ReactNode, \uD544\uC218)"),
-  fallback: z.any().optional().describe("SSR \uC911 \uD45C\uC2DC\uD560 \uB300\uCCB4 UI (ReactNode, \uAE30\uBCF8: null)")
-}).describe("\uD074\uB77C\uC774\uC5B8\uD2B8 \uC804\uC6A9 \uB80C\uB354\uB9C1. SSR \uD658\uACBD\uC5D0\uC11C hydration mismatch \uBC29\uC9C0.");
+  children: z.any().describe("Element to render only on client (ReactNode, required)"),
+  fallback: z.any().optional().describe("Fallback UI during SSR (ReactNode, default: null)")
+}).describe("Client-only rendering. Prevents hydration mismatch in SSR environments.");
 var themeProviderPropsSchema = z.object({
-  children: z.any().describe("\uC571 \uB8E8\uD2B8 \uC694\uC18C (ReactNode, \uD544\uC218)"),
-  defaultTheme: z.string().optional().describe('\uAE30\uBCF8 \uD14C\uB9C8 (\uC608: "dark", "light")'),
-  storageKey: z.string().optional().describe('localStorage \uC800\uC7A5 \uD0A4 (\uAE30\uBCF8: "theme")'),
-  themes: z.array(z.string()).optional().describe('\uC0AC\uC6A9 \uAC00\uB2A5\uD55C \uD14C\uB9C8 \uBAA9\uB85D (\uAE30\uBCF8: ["light", "dark"])'),
-  attribute: z.union([z.string(), z.array(z.string())]).optional().describe('\uD14C\uB9C8 \uC801\uC6A9 HTML \uC18D\uC131 (\uAE30\uBCF8: "data-theme")'),
-  enableSystem: z.boolean().optional().describe("\uC2DC\uC2A4\uD15C \uD14C\uB9C8 \uAC10\uC9C0 \uD65C\uC131\uD654"),
-  disableTransitionOnChange: z.boolean().optional().describe("\uD14C\uB9C8 \uC804\uD658 \uC2DC \uD2B8\uB79C\uC9C0\uC158 \uBE44\uD65C\uC131\uD654"),
-  forcedTheme: z.string().optional().describe("\uAC15\uC81C \uD14C\uB9C8 (\uC0AC\uC6A9\uC790 \uBCC0\uACBD \uBD88\uAC00)"),
-  enableColorScheme: z.boolean().optional().describe("color-scheme CSS \uC18D\uC131 \uC790\uB3D9 \uC124\uC815"),
+  children: z.any().describe("App root element (ReactNode, required)"),
+  defaultTheme: z.string().optional().describe('Default theme (e.g. "dark", "light")'),
+  storageKey: z.string().optional().describe('localStorage storage key (default: "theme")'),
+  themes: z.array(z.string()).optional().describe('Available theme list (default: ["light", "dark"])'),
+  attribute: z.union([z.string(), z.array(z.string())]).optional().describe('Theme HTML attribute (default: "data-theme")'),
+  enableSystem: z.boolean().optional().describe("Enable system theme detection"),
+  disableTransitionOnChange: z.boolean().optional().describe("Disable transitions on theme change"),
+  forcedTheme: z.string().optional().describe("Forced theme (user cannot change)"),
+  enableColorScheme: z.boolean().optional().describe("Auto-set color-scheme CSS property"),
   nonce: z.string().optional().describe("CSP nonce")
 }).describe(
-  "\uD14C\uB9C8 \uC81C\uACF5\uC790. next-themes \uAE30\uBC18. useTheme() \uD6C5\uC73C\uB85C \uD14C\uB9C8 \uC0C1\uD0DC \uC811\uADFC."
+  "Theme provider. Based on next-themes. Access theme state via useTheme() hook."
 );
 var tablePropsSchema = z.object({
-  list: z.array(z.any()).nullable().describe("\uB370\uC774\uD130 \uBC30\uC5F4. null/undefined\uC774\uBA74 \uB85C\uB529 \uC0C1\uD0DC (\uD544\uC218)"),
-  children: z.any().describe("\uD589 \uB80C\uB354 \uD568\uC218 ({ item, index }) => ReactNode (\uD544\uC218)"),
-  hideThead: z.boolean().optional().describe("\uD14C\uC774\uBE14 \uD5E4\uB354 \uC228\uAE40"),
-  loading: z.boolean().optional().describe("\uB85C\uB529 \uC0C1\uD0DC \uAC15\uC81C"),
-  loadingType: z.enum(["loading", "skeleton"]).default("skeleton").describe("\uB85C\uB529 \uD45C\uC2DC \uBC29\uC2DD"),
-  loadingElement: z.any().optional().describe("\uCEE4\uC2A4\uD140 \uB85C\uB529 \uC694\uC18C (ReactElement)"),
-  skeletonCount: z.number().default(10).describe("\uC2A4\uCF08\uB808\uD1A4 \uD589 \uC218"),
-  noDataMsg: z.any().optional().describe("\uB370\uC774\uD130 \uC5C6\uC744 \uB54C \uBA54\uC2DC\uC9C0 (ReactElement | string)"),
-  notification: z.any().optional().describe("\uD14C\uC774\uBE14 \uC0C1\uB2E8 \uC54C\uB9BC \uC601\uC5ED (ReactNode)"),
-  sortUpElement: z.any().optional().describe("\uC624\uB984\uCC28\uC21C \uC815\uB82C \uC544\uC774\uCF58 (ReactElement)"),
-  sortDownElement: z.any().optional().describe("\uB0B4\uB9BC\uCC28\uC21C \uC815\uB82C \uC544\uC774\uCF58 (ReactElement)"),
-  className: z.string().optional().describe("\uD14C\uC774\uBE14 \uB798\uD37C \uC2A4\uD0C0\uC77C"),
-  theadClassName: z.string().optional().describe("\uD5E4\uB354 \uD589 \uC2A4\uD0C0\uC77C")
+  list: z.array(z.any()).nullable().describe("Data array. null/undefined = loading state (required)"),
+  children: z.any().describe("Row render function ({ item, index }) => ReactNode (required)"),
+  hideThead: z.boolean().optional().describe("Hide table header"),
+  loading: z.boolean().optional().describe("Force loading state"),
+  loadingType: z.enum(["loading", "skeleton"]).default("skeleton").describe("Loading display type"),
+  loadingElement: z.any().optional().describe("Custom loading element (ReactElement)"),
+  skeletonCount: z.number().default(10).describe("Skeleton row count"),
+  noDataMsg: z.any().optional().describe("No data message (ReactElement | string)"),
+  notification: z.any().optional().describe("Table top notification area (ReactNode)"),
+  sortUpElement: z.any().optional().describe("Ascending sort icon (ReactElement)"),
+  sortDownElement: z.any().optional().describe("Descending sort icon (ReactElement)"),
+  className: z.string().optional().describe("Table wrapper style"),
+  theadClassName: z.string().optional().describe("Header row style")
 }).describe(
-  "\uD14C\uC774\uBE14. TdColumn\uC73C\uB85C \uCEEC\uB7FC \uC815\uC758, TableRow\uB85C \uD589 \uB798\uD551. \uC815\uB82C/\uC2A4\uCF08\uB808\uD1A4 \uB85C\uB529 \uB0B4\uC7A5."
+  "Table. Column definitions via TdColumn, row wrapping via TableRow. Built-in sorting/skeleton loading."
 );
 var tableRowPropsSchema = z.object({
-  variant: z.enum(["default", "accent"]).default("default").describe("\uD589 \uC2A4\uD0C0\uC77C"),
-  className: z.string().optional().describe("\uC2A4\uD0C0\uC77C \uC624\uBC84\uB77C\uC774\uB4DC"),
-  children: z.any().describe("TdColumn \uBAA9\uB85D (ReactNode, \uD544\uC218)"),
-  onClick: z.any().optional().describe("\uD589 \uD074\uB9AD \uCF5C\uBC31 (e: MouseEvent) => void")
-}).describe("\uD14C\uC774\uBE14 \uD589. Table \uB0B4\uBD80\uC5D0\uC11C \uC0AC\uC6A9.");
+  variant: z.enum(["default", "accent"]).default("default").describe("Row style"),
+  className: z.string().optional().describe("Style override"),
+  children: z.any().describe("TdColumn list (ReactNode, required)"),
+  onClick: z.any().optional().describe("Row click callback (e: MouseEvent) => void")
+}).describe("Table row. Used inside Table.");
 var tdColumnPropsSchema = z.object({
-  label: z.any().optional().describe("\uD5E4\uB354 \uB77C\uBCA8 (ReactElement | string)"),
-  fieldId: z.string().nullable().describe("\uCEEC\uB7FC \uC2DD\uBCC4\uC790 (\uC815\uB82C \uD0A4, \uD544\uC218)"),
-  size: z.union([z.number(), z.string()]).optional().describe("\uCEEC\uB7FC \uB108\uBE44 (number \u2192 px, string \u2192 CSS\uAC12)"),
-  align: z.enum(["left", "center", "right"]).default("left").describe("\uD14D\uC2A4\uD2B8 \uC815\uB82C"),
-  textOverflow: z.enum(["auto", "truncate", "wrap", "break-all"]).default("truncate").describe("\uD14D\uC2A4\uD2B8 \uB118\uCE68 \uCC98\uB9AC"),
-  highlightKey: z.string().nullable().optional().describe("\uD638\uBC84 \uD558\uC774\uB77C\uC774\uD2B8 \uADF8\uB8F9 \uD0A4"),
-  colSpan: z.number().optional().describe("\uC5F4 \uBCD1\uD569"),
-  rowSpan: z.number().optional().describe("\uD589 \uBCD1\uD569"),
-  thColSpan: z.number().optional().describe("\uD5E4\uB354 colSpan (<th>)"),
-  thRowSpan: z.number().optional().describe("\uD5E4\uB354 rowSpan (<th>)"),
-  enableSorting: z.boolean().optional().describe("\uC815\uB82C \uD65C\uC131\uD654"),
-  order: z.enum(["desc", "asc", ""]).optional().describe("\uD604\uC7AC \uC815\uB82C \uBC29\uD5A5"),
-  sortValue: z.union([z.string(), z.number()]).optional().describe("\uC815\uB82C \uAE30\uC900 \uAC12"),
-  handleClickSort: z.any().optional().describe("\uC815\uB82C \uD074\uB9AD \uCF5C\uBC31 ({ index, fieldId, order }) => void"),
-  children: z.any().describe("\uC140 \uB0B4\uC6A9 (ReactNode, \uD544\uC218)"),
-  className: z.string().optional().describe("\uC2A4\uD0C0\uC77C \uC624\uBC84\uB77C\uC774\uB4DC")
-}).describe("\uD14C\uC774\uBE14 \uC140/\uCEEC\uB7FC \uC815\uC758. TableRow \uB0B4\uBD80\uC5D0\uC11C \uC0AC\uC6A9.");
+  label: z.any().optional().describe("Header label (ReactElement | string)"),
+  fieldId: z.string().nullable().describe("Column identifier (sort key, required)"),
+  size: z.union([z.number(), z.string()]).optional().describe("Column width (number \u2192 px, string \u2192 CSS value)"),
+  align: z.enum(["left", "center", "right"]).default("left").describe("Text alignment"),
+  textOverflow: z.enum(["auto", "truncate", "wrap", "break-all"]).default("truncate").describe("Text overflow handling"),
+  highlightKey: z.string().nullable().optional().describe("Hover highlight group key"),
+  colSpan: z.number().optional().describe("Column span"),
+  rowSpan: z.number().optional().describe("Row span"),
+  thColSpan: z.number().optional().describe("Header colSpan (<th>)"),
+  thRowSpan: z.number().optional().describe("Header rowSpan (<th>)"),
+  enableSorting: z.boolean().optional().describe("Enable sorting"),
+  order: z.enum(["desc", "asc", ""]).optional().describe("Current sort direction"),
+  sortValue: z.union([z.string(), z.number()]).optional().describe("Sort criterion value"),
+  handleClickSort: z.any().optional().describe("Sort click callback ({ index, fieldId, order }) => void"),
+  children: z.any().describe("Cell content (ReactNode, required)"),
+  className: z.string().optional().describe("Style override")
+}).describe("Table cell/column definition. Used inside TableRow.");
+var toastOptionsSchema = z.object({
+  description: z.any().optional().describe("Toast subtitle (ReactNode)"),
+  duration: z.number().optional().describe("Auto-dismiss duration (ms). Default 4000"),
+  icon: z.any().optional().describe("Custom icon (ReactNode)"),
+  action: z.any().optional().describe("Action button. { label: ReactNode, onClick: () => void }"),
+  cancel: z.any().optional().describe("Cancel button. { label: ReactNode, onClick: () => void }"),
+  closeButton: z.boolean().optional().describe("Show close (X) button"),
+  dismissible: z.boolean().optional().describe("Allow dismiss via swipe/click"),
+  richColors: z.boolean().optional().describe("Apply strong colors for success/error/warning/info"),
+  invert: z.boolean().optional().describe("Invert colors (dark\u2194light)"),
+  position: z.enum([
+    "top-left",
+    "top-center",
+    "top-right",
+    "bottom-left",
+    "bottom-center",
+    "bottom-right"
+  ]).optional().describe("Individual position for this toast"),
+  onDismiss: z.any().optional().describe("Dismiss callback (toast: ToastT) => void"),
+  onAutoClose: z.any().optional().describe("Auto-close callback (toast: ToastT) => void"),
+  className: z.string().optional().describe("Toast custom class"),
+  style: z.any().optional().describe("Toast inline style (CSSProperties)"),
+  unstyled: z.boolean().optional().describe("Remove default styles (for custom styling)"),
+  id: z.union([z.string(), z.number()]).optional().describe("Toast ID (for deduplication or updates)")
+}).describe(
+  "toast() call options. Used as toast(message, options). Fully customizable via toast.custom(jsx)."
+);
 var toasterPropsSchema = z.object({
   position: z.enum([
     "top-left",
@@ -460,10 +581,19 @@ var toasterPropsSchema = z.object({
     "bottom-left",
     "bottom-center",
     "bottom-right"
-  ]).default("top-center").describe("\uD1A0\uC2A4\uD2B8 \uC704\uCE58"),
-  unstyled: z.boolean().default(false).describe("\uAE30\uBCF8 \uC2A4\uD0C0\uC77C \uC81C\uAC70 (\uCEE4\uC2A4\uD140 \uC2A4\uD0C0\uC77C\uB9C1 \uC2DC)")
+  ]).default("top-center").describe("Default toast position"),
+  unstyled: z.boolean().default(false).describe("Remove default styles (for custom styling)"),
+  theme: z.enum(["light", "dark", "system"]).optional().describe("Theme setting"),
+  richColors: z.boolean().optional().describe("Apply strong colors for success/error/warning/info"),
+  expand: z.boolean().optional().describe("Always show toasts in expanded state"),
+  duration: z.number().optional().describe("Global auto-dismiss duration (ms). Default 4000"),
+  visibleToasts: z.number().optional().describe("Maximum visible toasts at once"),
+  closeButton: z.boolean().optional().describe("Show close button on all toasts"),
+  gap: z.number().optional().describe("Gap between toasts (px)"),
+  offset: z.any().optional().describe("Offset from screen edge. string | number | { top, right, bottom, left }"),
+  dir: z.enum(["ltr", "rtl", "auto"]).optional().describe("Text direction")
 }).describe(
-  "Toaster \uC124\uC815. \uC571 \uB8E8\uD2B8\uC5D0 \uD55C \uBC88 \uBC30\uCE58. toast() \uD568\uC218\uB85C \uC54C\uB9BC \uD45C\uC2DC. sonner \uAE30\uBC18."
+  "Toaster config. Place once at app root. Display notifications via toast(). Based on sonner."
 );
 
-export { accordionPropsSchema, avatarPropsSchema, buttonPropsSchema, carouselButtonPropsSchema, carouselDotsPropsSchema, carouselPropsSchema, carouselSlidePropsSchema, checkBoxPropsSchema, chipPropsSchema, clientOnlyPropsSchema, countdownPropsSchema, counterPropsSchema, dataListPropsSchema, dividerPropsSchema, drawerContentPropsSchema, drawerPropsSchema, ellipsisPropsSchema, errorBoundaryPropsSchema, infiniteScrollPropsSchema, marqueePropsSchema, modalCallSchema, modalTemplatePropsSchema, numberInputPropsSchema, paginationPropsSchema, popoverPropsSchema, radioGroupPropsSchema, radioItemPropsSchema, selectItemPropsSchema, selectPropsSchema, skeletonPropsSchema, spinnerPropsSchema, switchPropsSchema, tabPropsSchema, tablePropsSchema, tableRowPropsSchema, tdColumnPropsSchema, textAreaPropsSchema, textInputPropsSchema, themeProviderPropsSchema, toasterPropsSchema, tooltipPropsSchema, virtualGridPropsSchema, virtualListPropsSchema };
+export { accordionPropsSchema, avatarPropsSchema, buttonPropsSchema, carouselButtonPropsSchema, carouselDotsPropsSchema, carouselPropsSchema, carouselSlidePropsSchema, checkBoxPropsSchema, chipPropsSchema, clientOnlyPropsSchema, countdownPropsSchema, counterPropsSchema, dataListPropsSchema, dividerPropsSchema, drawerClosePropsSchema, drawerContentPropsSchema, drawerDescriptionPropsSchema, drawerPropsSchema, drawerTitlePropsSchema, drawerTriggerPropsSchema, ellipsisPropsSchema, errorBoundaryPropsSchema, infiniteScrollPropsSchema, marqueePropsSchema, modalCallSchema, modalTemplatePropsSchema, numberInputPropsSchema, paginationPropsSchema, popoverPropsSchema, radioGroupPropsSchema, radioItemPropsSchema, selectItemPropsSchema, selectPropsSchema, skeletonPropsSchema, spinnerPropsSchema, switchPropsSchema, tabPropsSchema, tablePropsSchema, tableRowPropsSchema, tdColumnPropsSchema, textAreaPropsSchema, textInputPropsSchema, themeProviderPropsSchema, toastOptionsSchema, toasterPropsSchema, tooltipPropsSchema, virtualGridPropsSchema, virtualListPropsSchema };