From 1a10dccc8de78268e2e4df5578625ecfa31d83eb Mon Sep 17 00:00:00 2001
From: Danijel Martinek <danijel@fraqtal.xyz>
Date: Mon, 6 Apr 2026 14:57:08 +0200
Subject: [PATCH] feat(ui): add Button, Input, Label atoms and FormField
 molecule with stories

---
 .../ui/src/atoms/button/button.stories.tsx    | 38 +++++++++++++++++
 packages/ui/src/atoms/button/button.tsx       | 41 +++++++++++++++++++
 packages/ui/src/atoms/button/index.ts         |  1 +
 packages/ui/src/atoms/index.ts                |  4 +-
 packages/ui/src/atoms/input/index.ts          |  1 +
 packages/ui/src/atoms/input/input.stories.tsx | 19 +++++++++
 packages/ui/src/atoms/input/input.tsx         | 21 ++++++++++
 packages/ui/src/atoms/label/index.ts          |  1 +
 packages/ui/src/atoms/label/label.tsx         | 20 +++++++++
 .../form-field/form-field.stories.tsx         | 31 ++++++++++++++
 .../src/molecules/form-field/form-field.tsx   | 31 ++++++++++++++
 packages/ui/src/molecules/form-field/index.ts |  1 +
 packages/ui/src/molecules/index.ts            |  2 +-
 13 files changed, 209 insertions(+), 2 deletions(-)
 create mode 100644 packages/ui/src/atoms/button/button.stories.tsx
 create mode 100644 packages/ui/src/atoms/button/button.tsx
 create mode 100644 packages/ui/src/atoms/button/index.ts
 create mode 100644 packages/ui/src/atoms/input/index.ts
 create mode 100644 packages/ui/src/atoms/input/input.stories.tsx
 create mode 100644 packages/ui/src/atoms/input/input.tsx
 create mode 100644 packages/ui/src/atoms/label/index.ts
 create mode 100644 packages/ui/src/atoms/label/label.tsx
 create mode 100644 packages/ui/src/molecules/form-field/form-field.stories.tsx
 create mode 100644 packages/ui/src/molecules/form-field/form-field.tsx
 create mode 100644 packages/ui/src/molecules/form-field/index.ts

diff --git a/packages/ui/src/atoms/button/button.stories.tsx b/packages/ui/src/atoms/button/button.stories.tsx
new file mode 100644
index 0000000..958f932
--- /dev/null
+++ b/packages/ui/src/atoms/button/button.stories.tsx
@@ -0,0 +1,38 @@
+import type { Meta, StoryObj } from "@storybook/react";
+import { Button } from "./button.js";
+
+const meta = {
+  title: "Atoms/Button",
+  component: Button,
+  tags: ["autodocs"],
+  argTypes: {
+    variant: {
+      control: "select",
+      options: ["default", "secondary", "destructive", "outline", "ghost"],
+    },
+    size: { control: "select", options: ["sm", "default", "lg"] },
+  },
+} satisfies Meta<typeof Button>;
+export default meta;
+
+type Story = StoryObj<typeof meta>;
+
+export const Default: Story = {
+  args: { children: "Button", variant: "default" },
+};
+
+export const Secondary: Story = {
+  args: { children: "Secondary", variant: "secondary" },
+};
+
+export const Destructive: Story = {
+  args: { children: "Destructive", variant: "destructive" },
+};
+
+export const Outline: Story = {
+  args: { children: "Outline", variant: "outline" },
+};
+
+export const Ghost: Story = {
+  args: { children: "Ghost", variant: "ghost" },
+};
diff --git a/packages/ui/src/atoms/button/button.tsx b/packages/ui/src/atoms/button/button.tsx
new file mode 100644
index 0000000..bef3ba3
--- /dev/null
+++ b/packages/ui/src/atoms/button/button.tsx
@@ -0,0 +1,41 @@
+import { forwardRef, type ButtonHTMLAttributes } from "react";
+import { cn } from "../../lib/utils.js";
+
+export interface ButtonProps extends ButtonHTMLAttributes<HTMLButtonElement> {
+  variant?: "default" | "secondary" | "destructive" | "outline" | "ghost";
+  size?: "sm" | "default" | "lg";
+}
+
+const variantStyles: Record<NonNullable<ButtonProps["variant"]>, string> = {
+  default: "bg-primary text-primary-foreground hover:bg-primary/90",
+  secondary: "bg-secondary text-secondary-foreground hover:bg-secondary/80",
+  destructive:
+    "bg-destructive text-destructive-foreground hover:bg-destructive/90",
+  outline:
+    "border border-input bg-background hover:bg-accent hover:text-accent-foreground",
+  ghost: "hover:bg-accent hover:text-accent-foreground",
+};
+
+const sizeStyles: Record<NonNullable<ButtonProps["size"]>, string> = {
+  sm: "h-9 px-3 text-sm",
+  default: "h-10 px-4 py-2",
+  lg: "h-11 px-8 text-lg",
+};
+
+export const Button = forwardRef<HTMLButtonElement, ButtonProps>(
+  ({ className, variant = "default", size = "default", ...props }, ref) => {
+    return (
+      <button
+        className={cn(
+          "inline-flex items-center justify-center rounded-md font-medium transition-colors focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring disabled:pointer-events-none disabled:opacity-50",
+          variantStyles[variant],
+          sizeStyles[size],
+          className
+        )}
+        ref={ref}
+        {...props}
+      />
+    );
+  }
+);
+Button.displayName = "Button";
diff --git a/packages/ui/src/atoms/button/index.ts b/packages/ui/src/atoms/button/index.ts
new file mode 100644
index 0000000..83169c3
--- /dev/null
+++ b/packages/ui/src/atoms/button/index.ts
@@ -0,0 +1 @@
+export { Button, type ButtonProps } from "./button.js";
diff --git a/packages/ui/src/atoms/index.ts b/packages/ui/src/atoms/index.ts
index cb0ff5c..1e6d696 100644
--- a/packages/ui/src/atoms/index.ts
+++ b/packages/ui/src/atoms/index.ts
@@ -1 +1,3 @@
-export {};
+export { Button, type ButtonProps } from "./button/index.js";
+export { Input, type InputProps } from "./input/index.js";
+export { Label, type LabelProps } from "./label/index.js";
diff --git a/packages/ui/src/atoms/input/index.ts b/packages/ui/src/atoms/input/index.ts
new file mode 100644
index 0000000..eeb75cf
--- /dev/null
+++ b/packages/ui/src/atoms/input/index.ts
@@ -0,0 +1 @@
+export { Input, type InputProps } from "./input.js";
diff --git a/packages/ui/src/atoms/input/input.stories.tsx b/packages/ui/src/atoms/input/input.stories.tsx
new file mode 100644
index 0000000..41a2e68
--- /dev/null
+++ b/packages/ui/src/atoms/input/input.stories.tsx
@@ -0,0 +1,19 @@
+import type { Meta, StoryObj } from "@storybook/react";
+import { Input } from "./input.js";
+
+const meta = {
+  title: "Atoms/Input",
+  component: Input,
+  tags: ["autodocs"],
+} satisfies Meta<typeof Input>;
+export default meta;
+
+type Story = StoryObj<typeof meta>;
+
+export const Default: Story = {
+  args: { placeholder: "Enter text..." },
+};
+
+export const Disabled: Story = {
+  args: { placeholder: "Disabled", disabled: true },
+};
diff --git a/packages/ui/src/atoms/input/input.tsx b/packages/ui/src/atoms/input/input.tsx
new file mode 100644
index 0000000..e58f3a6
--- /dev/null
+++ b/packages/ui/src/atoms/input/input.tsx
@@ -0,0 +1,21 @@
+import { forwardRef, type InputHTMLAttributes } from "react";
+import { cn } from "../../lib/utils.js";
+
+export interface InputProps extends InputHTMLAttributes<HTMLInputElement> {}
+
+export const Input = forwardRef<HTMLInputElement, InputProps>(
+  ({ className, type, ...props }, ref) => {
+    return (
+      <input
+        type={type}
+        className={cn(
+          "flex h-10 w-full rounded-md border border-input bg-background px-3 py-2 text-sm ring-offset-background file:border-0 file:bg-transparent file:text-sm file:font-medium placeholder:text-muted-foreground focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring focus-visible:ring-offset-2 disabled:cursor-not-allowed disabled:opacity-50",
+          className
+        )}
+        ref={ref}
+        {...props}
+      />
+    );
+  }
+);
+Input.displayName = "Input";
diff --git a/packages/ui/src/atoms/label/index.ts b/packages/ui/src/atoms/label/index.ts
new file mode 100644
index 0000000..016fabe
--- /dev/null
+++ b/packages/ui/src/atoms/label/index.ts
@@ -0,0 +1 @@
+export { Label, type LabelProps } from "./label.js";
diff --git a/packages/ui/src/atoms/label/label.tsx b/packages/ui/src/atoms/label/label.tsx
new file mode 100644
index 0000000..f499781
--- /dev/null
+++ b/packages/ui/src/atoms/label/label.tsx
@@ -0,0 +1,20 @@
+import { forwardRef, type LabelHTMLAttributes } from "react";
+import { cn } from "../../lib/utils.js";
+
+export interface LabelProps extends LabelHTMLAttributes<HTMLLabelElement> {}
+
+export const Label = forwardRef<HTMLLabelElement, LabelProps>(
+  ({ className, ...props }, ref) => {
+    return (
+      <label
+        className={cn(
+          "text-sm font-medium leading-none peer-disabled:cursor-not-allowed peer-disabled:opacity-70",
+          className
+        )}
+        ref={ref}
+        {...props}
+      />
+    );
+  }
+);
+Label.displayName = "Label";
diff --git a/packages/ui/src/molecules/form-field/form-field.stories.tsx b/packages/ui/src/molecules/form-field/form-field.stories.tsx
new file mode 100644
index 0000000..4e81d16
--- /dev/null
+++ b/packages/ui/src/molecules/form-field/form-field.stories.tsx
@@ -0,0 +1,31 @@
+import type { Meta, StoryObj } from "@storybook/react";
+import { FormField } from "./form-field.js";
+
+const meta = {
+  title: "Molecules/FormField",
+  component: FormField,
+  tags: ["autodocs"],
+} satisfies Meta<typeof FormField>;
+export default meta;
+
+type Story = StoryObj<typeof meta>;
+
+export const Default: Story = {
+  args: { label: "Email", placeholder: "you@example.com", type: "email" },
+};
+
+export const WithDescription: Story = {
+  args: {
+    label: "Username",
+    placeholder: "johndoe",
+    description: "Must be 3-31 characters",
+  },
+};
+
+export const WithError: Story = {
+  args: {
+    label: "Password",
+    type: "password",
+    error: "Password must be at least 6 characters",
+  },
+};
diff --git a/packages/ui/src/molecules/form-field/form-field.tsx b/packages/ui/src/molecules/form-field/form-field.tsx
new file mode 100644
index 0000000..6f51c21
--- /dev/null
+++ b/packages/ui/src/molecules/form-field/form-field.tsx
@@ -0,0 +1,31 @@
+import { Label } from "../../atoms/label/index.js";
+import { Input, type InputProps } from "../../atoms/input/index.js";
+import { cn } from "../../lib/utils.js";
+
+export interface FormFieldProps extends InputProps {
+  label: string;
+  error?: string;
+  description?: string;
+}
+
+export function FormField({
+  label,
+  error,
+  description,
+  className,
+  id,
+  ...inputProps
+}: FormFieldProps) {
+  const fieldId = id ?? label.toLowerCase().replace(/\s+/g, "-");
+
+  return (
+    <div className={cn("space-y-2", className)}>
+      <Label htmlFor={fieldId}>{label}</Label>
+      <Input id={fieldId} {...inputProps} />
+      {description && (
+        <p className="text-sm text-muted-foreground">{description}</p>
+      )}
+      {error && <p className="text-sm text-destructive">{error}</p>}
+    </div>
+  );
+}
diff --git a/packages/ui/src/molecules/form-field/index.ts b/packages/ui/src/molecules/form-field/index.ts
new file mode 100644
index 0000000..ad9b6a6
--- /dev/null
+++ b/packages/ui/src/molecules/form-field/index.ts
@@ -0,0 +1 @@
+export { FormField, type FormFieldProps } from "./form-field.js";
diff --git a/packages/ui/src/molecules/index.ts b/packages/ui/src/molecules/index.ts
index cb0ff5c..6107d6a 100644
--- a/packages/ui/src/molecules/index.ts
+++ b/packages/ui/src/molecules/index.ts
@@ -1 +1 @@
-export {};
+export { FormField, type FormFieldProps } from "./form-field/index.js";