ruler-components 0.1.0

package/components/ui/feature-card.tsx

@@ -0,0 +1,38 @@
+import type { LucideIcon } from "lucide-react";
+import { cn } from "@/lib/cn";
+
+export function FeatureCard({
+  icon: Icon,
+  title,
+  description,
+  variant = "plain",
+}: {
+  icon: LucideIcon;
+  title: string;
+  description: string;
+  variant?: "plain" | "bordered";
+}) {
+  return (
+    <div
+      className={cn(
+        variant === "bordered" &&
+          "rounded-xl border border-zinc-200 p-5 dark:border-zinc-800",
+      )}
+    >
+      <div
+        className={cn(
+          "mb-4 flex h-11 w-11 items-center justify-center rounded-2xl border",
+          variant === "bordered"
+            ? "border-zinc-200 bg-zinc-50 text-zinc-900 dark:border-white/10 dark:bg-white/[0.06] dark:text-zinc-100"
+            : "border-zinc-800 bg-zinc-900 text-white dark:border-zinc-200 dark:bg-white dark:text-zinc-900",
+        )}
+      >
+        <Icon className="h-5 w-5" />
+      </div>
+      <h3 className="text-base font-semibold text-zinc-900 dark:text-zinc-50">
+        {title}
+      </h3>
+      <p className="mt-1 text-sm text-zinc-500 dark:text-zinc-400">{description}</p>
+    </div>
+  );
+}

package/components/ui/input.tsx

@@ -0,0 +1,44 @@
+import * as React from "react";
+import { cva, type VariantProps } from "class-variance-authority";
+import { cn } from "@/lib/cn";
+
+const inputVariants = cva(
+  "flex w-full rounded-xl border bg-white px-3.5 text-sm text-zinc-900 outline-none transition-all duration-150 placeholder:text-zinc-400 disabled:cursor-not-allowed disabled:opacity-50 dark:bg-zinc-900 dark:text-zinc-100 dark:placeholder:text-zinc-500",
+  {
+    variants: {
+      size: {
+        sm: "h-8 text-xs",
+        md: "h-10 text-sm",
+        lg: "h-11 text-base",
+      },
+      state: {
+        default:
+          "border-zinc-200 hover:border-zinc-300 focus:border-zinc-900 focus:ring-2 focus:ring-zinc-900/10 dark:border-zinc-800 dark:hover:border-zinc-700 dark:focus:border-zinc-400 dark:focus:ring-zinc-400/15",
+        error:
+          "border-red-400 focus:border-red-500 focus:ring-2 focus:ring-red-500/15 dark:border-red-500/60 dark:focus:border-red-400",
+      },
+    },
+    defaultVariants: {
+      size: "md",
+      state: "default",
+    },
+  },
+);
+
+export interface InputProps
+  extends Omit<React.InputHTMLAttributes<HTMLInputElement>, "size">,
+    VariantProps<typeof inputVariants> {}
+
+const Input = React.forwardRef<HTMLInputElement, InputProps>(
+  ({ className, size, state, type = "text", ...props }, ref) => (
+    <input
+      ref={ref}
+      type={type}
+      className={cn(inputVariants({ size, state }), className)}
+      {...props}
+    />
+  ),
+);
+Input.displayName = "Input";
+
+export { Input, inputVariants };

package/components/ui/label.tsx

@@ -0,0 +1,110 @@
+import * as React from "react";
+import { cva, type VariantProps } from "class-variance-authority";
+import { cn } from "@/lib/cn";
+
+const labelVariants = cva(
+  "inline-flex items-center gap-1 font-medium leading-none peer-disabled:cursor-not-allowed peer-disabled:opacity-50",
+  {
+    variants: {
+      variant: {
+        default: "text-zinc-800 dark:text-zinc-100",
+        muted: "text-zinc-500 dark:text-zinc-400",
+      },
+      size: {
+        sm: "text-xs",
+        md: "text-sm",
+        lg: "text-[15px]",
+      },
+    },
+    defaultVariants: {
+      variant: "default",
+      size: "md",
+    },
+  },
+);
+
+export interface LabelProps
+  extends React.LabelHTMLAttributes<HTMLLabelElement>,
+    VariantProps<typeof labelVariants> {
+  required?: boolean;
+  optional?: boolean;
+  hint?: string;
+  error?: string;
+}
+
+const Label = React.forwardRef<HTMLLabelElement, LabelProps>(
+  ({ className, variant, size, required, optional, hint, error, children, ...props }, ref) => {
+    return (
+      <div className="flex w-full flex-col gap-1.5">
+        <div className="flex items-center justify-between gap-2">
+          <label
+            ref={ref}
+            className={cn(labelVariants({ variant, size }), className)}
+            {...props}
+          >
+            {children}
+            {required && (
+              <span className="text-red-500" aria-label="required">
+                *
+              </span>
+            )}
+          </label>
+          {optional && (
+            <span className="text-xs text-zinc-400 dark:text-zinc-500">Optional</span>
+          )}
+        </div>
+        {hint && !error && (
+          <p className="text-xs leading-relaxed text-zinc-500 dark:text-zinc-400">{hint}</p>
+        )}
+        {error && (
+          <p className="text-xs leading-relaxed text-red-500 dark:text-red-400" role="alert">
+            {error}
+          </p>
+        )}
+      </div>
+    );
+  },
+);
+Label.displayName = "Label";
+
+export interface FieldProps extends React.HTMLAttributes<HTMLDivElement> {
+  label: string;
+  htmlFor: string;
+  required?: boolean;
+  optional?: boolean;
+  hint?: string;
+  error?: string;
+  labelSize?: "sm" | "md" | "lg";
+  children: React.ReactNode;
+}
+
+function Field({
+  className,
+  label,
+  htmlFor,
+  required,
+  optional,
+  hint,
+  error,
+  labelSize = "md",
+  children,
+  ...props
+}: FieldProps) {
+  return (
+    <div className={cn("flex w-full flex-col gap-2", className)} {...props}>
+      <Label
+        htmlFor={htmlFor}
+        required={required}
+        optional={optional}
+        hint={hint}
+        error={error}
+        size={labelSize}
+      >
+        {label}
+      </Label>
+      {children}
+    </div>
+  );
+}
+
+export { Label, Field, labelVariants };

package/components/ui/loaders.tsx

@@ -0,0 +1,139 @@
+"use client";
+
+import React from "react";
+import { Sparkles } from "lucide-react";
+import { cn } from "@/lib/cn";
+
+const LoaderStyles = () => (
+  <style dangerouslySetInnerHTML={{ __html: `
+    @keyframes shimmer { 100% { transform: translateX(100%); } }
+    @keyframes progressLoad { 0% { transform: scaleX(0); } 50% { transform: scaleX(0.5); } 100% { transform: scaleX(1); } }
+    @keyframes morphShape { 0%, 100% { border-radius: 8px; transform: rotate(0deg); } 50% { border-radius: 50%; transform: rotate(180deg); } }
+    @keyframes blurReveal { 0% { filter: blur(10px); opacity: 0; transform: translateY(10px); } 100% { filter: blur(0); opacity: 1; transform: translateY(0); } }
+    @keyframes spinDots { 0%, 100% { opacity: 0.2; } 50% { opacity: 1; } }
+    @keyframes squareMove { 0%, 100% { transform: scale(1); opacity: 1; } 50% { transform: scale(0.6); opacity: 0.4; } }
+    @keyframes loadBarMove { 0% { left: -100%; } 100% { left: 100%; } }
+  `}} />
+);
+
+export const SkeletonShimmer = ({ className }: { className?: string }) => (
+  <div className={cn("relative overflow-hidden rounded-md bg-zinc-100 dark:bg-zinc-800", className)}>
+    <LoaderStyles />
+    <div className="absolute inset-0 -translate-x-full bg-gradient-to-r from-transparent via-white/40 to-transparent dark:via-white/5" style={{ animation: 'shimmer 2s infinite' }} />
+  </div>
+);
+
+// --- Circular Spinners ---
+
+export const ProgressRing = () => (
+  <svg className="h-10 w-10 animate-spin text-zinc-900 dark:text-white" viewBox="0 0 32 32">
+    <circle className="opacity-10" cx="16" cy="16" r="14" stroke="currentColor" strokeWidth="3" fill="none" />
+    <path className="opacity-100" fill="none" stroke="currentColor" strokeWidth="3" strokeLinecap="round" d="M16 2 A14 14 0 0 1 30 16" />
+  </svg>
+);
+
+export const SpinnerGradient = () => (
+  <div className="h-10 w-10 rounded-full border-4 border-zinc-100 dark:border-zinc-800 border-t-zinc-900 dark:border-t-white animate-spin" />
+);
+
+export const SpinnerDots = () => (
+  <div className="relative h-10 w-10">
+    {[...Array(8)].map((_, i) => (
+      <div key={i} className="absolute top-0 left-0 w-full h-full" style={{ transform: `rotate(${i * 45}deg)` }}>
+        <div className="h-2 w-2 rounded-full bg-zinc-900 dark:bg-white" style={{ animation: 'spinDots 1s linear infinite', animationDelay: `${i * 0.12}s` }} />
+      </div>
+    ))}
+  </div>
+);
+
+export const HalfCircles = () => (
+  <div className="relative h-10 w-10 border-4 border-transparent border-t-zinc-900 dark:border-t-white rounded-full animate-spin">
+    <div className="absolute inset-0 border-4 border-transparent border-b-zinc-400 rounded-full opacity-50" />
+  </div>
+);
+
+// --- Geometric & Modern ---
+
+export const SquaresLoader = () => (
+  <div className="flex gap-1.5">
+    <div className="h-4 w-4 bg-zinc-900 dark:bg-white" style={{ animation: 'squareMove 1s ease-in-out infinite' }} />
+    <div className="h-4 w-4 bg-zinc-300 dark:bg-zinc-700" style={{ animation: 'squareMove 1s ease-in-out infinite', animationDelay: '0.2s' }} />
+  </div>
+);
+
+export const LoadBar = () => (
+  <div className="relative h-4 w-12 overflow-hidden rounded-full bg-zinc-100 dark:bg-zinc-800">
+    <div className="absolute top-0 h-full w-6 rounded-full bg-zinc-900 dark:bg-white" style={{ animation: 'loadBarMove 1.5s linear infinite' }} />
+  </div>
+);
+
+export const PulseLoader = () => (
+  <div className="relative h-10 w-10 flex items-center justify-center">
+    <div className="absolute h-full w-full animate-ping rounded-full bg-zinc-900/20 dark:bg-white/20" />
+    <div className="h-4 w-4 rounded-full bg-zinc-900 dark:bg-white" />
+  </div>
+);
+
+// --- Indicators ---
+
+export const DotWave = () => (
+  <div className="flex gap-1.5">
+    {[0, 1, 2].map((i) => (
+      <div key={i} className="h-2 w-2 animate-bounce rounded-full bg-zinc-900 dark:bg-white" style={{ animationDelay: `${i * 0.15}s` }} />
+    ))}
+  </div>
+);
+
+export const ThreeDots = () => (
+  <div className="flex gap-1">
+    {[0, 1, 2].map((i) => (
+      <div key={i} className="h-1.5 w-1.5 rounded-full bg-zinc-400 animate-pulse" style={{ animationDelay: `${i * 0.2}s` }} />
+    ))}
+  </div>
+);
+
+export const TypingIndicator = () => (
+  <div className="flex items-center gap-1.5 px-4 py-2 bg-zinc-100 dark:bg-zinc-800 rounded-2xl w-fit">
+    {[0, 1, 2].map((i) => (
+      <div key={i} className="h-1.5 w-1.5 animate-pulse rounded-full bg-zinc-400" style={{ animationDelay: `${i * 0.2}s` }} />
+    ))}
+  </div>
+);
+
+export const ProgressBar = () => (
+  <div className="h-1.5 w-full max-w-[200px] overflow-hidden rounded-full bg-zinc-100 dark:bg-zinc-800">
+    <LoaderStyles />
+    <div className="h-full w-full origin-left bg-zinc-900 dark:bg-white" style={{ animation: 'progressLoad 1.5s ease-in-out infinite' }} />
+  </div>
+);
+
+// --- Premium ---
+
+export const MorphingLoader = () => (
+  <div className="h-10 w-10 bg-zinc-900 dark:bg-white" style={{ animation: 'morphShape 3s linear infinite' }} />
+);
+
+export const OrbitLoader = () => (
+  <div className="relative flex h-12 w-12 items-center justify-center">
+    <div className="h-2 w-2 rounded-full bg-zinc-900 dark:bg-white" />
+    <div className="absolute h-full w-full animate-spin">
+      <div className="h-2 w-2 rounded-full bg-zinc-400" />
+    </div>
+  </div>
+);
+
+export const BlurReveal = ({ children }: { children: React.ReactNode }) => (
+  <div style={{ animation: 'blurReveal 1s ease-out forwards' }}>
+    {children}
+  </div>
+);
+
+export const AILoader = ({ text = "Thinking..." }: { text?: string }) => (
+  <div className="flex flex-col items-center gap-4">
+    <div className="relative flex h-12 w-12 items-center justify-center">
+      <div className="absolute h-full w-full animate-spin rounded-full border-2 border-zinc-200 border-t-zinc-900 dark:border-zinc-800 dark:border-t-white" />
+      <Sparkles className="h-5 w-5 animate-pulse text-zinc-900 dark:text-white" />
+    </div>
+    <span className="text-[10px] font-bold uppercase tracking-widest text-zinc-400 animate-pulse">{text}</span>
+  </div>
+);

package/components/ui/menu.tsx

@@ -0,0 +1,118 @@
+import * as React from "react";
+import { Check } from "lucide-react";
+import { cva, type VariantProps } from "class-variance-authority";
+import { cn } from "@/lib/cn";
+
+const menuVariants = cva(
+  "w-56 rounded-lg p-1 outline-none",
+  {
+    variants: {
+      variant: {
+        default:
+          "border border-zinc-200 bg-white shadow-xl dark:border-zinc-800 dark:bg-zinc-950",
+        ghost: "bg-transparent",
+      },
+    },
+    defaultVariants: { variant: "default" },
+  },
+);
+
+export interface MenuProps
+  extends React.HTMLAttributes<HTMLDivElement>,
+    VariantProps<typeof menuVariants> {}
+
+const Menu = React.forwardRef<HTMLDivElement, MenuProps>(
+  ({ className, variant, ...props }, ref) => (
+    <div
+      ref={ref}
+      role="menu"
+      className={cn(menuVariants({ variant }), className)}
+      {...props}
+    />
+  ),
+);
+Menu.displayName = "Menu";
+
+const menuItemVariants = cva(
+  [
+    "flex w-full cursor-pointer items-center gap-2 rounded-md px-3 py-2 text-left text-sm outline-none transition-colors",
+    "focus-visible:bg-zinc-100 dark:focus-visible:bg-zinc-900",
+    "disabled:pointer-events-none disabled:opacity-40",
+  ],
+  {
+    variants: {
+      variant: {
+        default:
+          "text-zinc-700 hover:bg-zinc-100 dark:text-zinc-300 dark:hover:bg-zinc-900",
+        destructive:
+          "text-red-600 hover:bg-red-50 dark:text-red-400 dark:hover:bg-red-950/30",
+      },
+    },
+    defaultVariants: { variant: "default" },
+  },
+);
+
+export interface MenuItemProps
+  extends Omit<React.ButtonHTMLAttributes<HTMLButtonElement>, "children">,
+    VariantProps<typeof menuItemVariants> {
+  label: string;
+  icon?: React.ElementType;
+  shortcut?: string;
+  selected?: boolean;
+}
+
+const MenuItem = React.forwardRef<HTMLButtonElement, MenuItemProps>(
+  (
+    { className, variant, label, icon: Icon, shortcut, selected, disabled, ...props },
+    ref,
+  ) => (
+    <button
+      ref={ref}
+      type="button"
+      role="menuitem"
+      disabled={disabled}
+      className={cn(menuItemVariants({ variant }), className)}
+      {...props}
+    >
+      {Icon && <Icon className="h-4 w-4 shrink-0 opacity-70" />}
+      <span className="flex-1 truncate">{label}</span>
+      {shortcut && (
+        <span className="shrink-0 text-xs tracking-wide text-zinc-400 dark:text-zinc-500">
+          {shortcut}
+        </span>
+      )}
+      {selected && <Check className="h-3.5 w-3.5 shrink-0 text-zinc-900 dark:text-white" />}
+    </button>
+  ),
+);
+MenuItem.displayName = "MenuItem";
+
+const MenuLabel = React.forwardRef<
+  HTMLDivElement,
+  React.HTMLAttributes<HTMLDivElement>
+>(({ className, ...props }, ref) => (
+  <div
+    ref={ref}
+    className={cn(
+      "px-3 py-2 text-[11px] font-bold uppercase tracking-wider text-zinc-400 dark:text-zinc-500",
+      className,
+    )}
+    {...props}
+  />
+));
+MenuLabel.displayName = "MenuLabel";
+
+const MenuDivider = React.forwardRef<
+  HTMLDivElement,
+  React.HTMLAttributes<HTMLDivElement>
+>(({ className, ...props }, ref) => (
+  <div
+    ref={ref}
+    role="separator"
+    className={cn("my-1 h-px bg-zinc-100 dark:bg-zinc-800", className)}
+    {...props}
+  />
+));
+MenuDivider.displayName = "MenuDivider";
+
+export { Menu, MenuItem, MenuLabel, MenuDivider, menuVariants, menuItemVariants };