@yomologic/react-ui 0.2.7 → 0.4.0

package/README.md

@@ -1,71 +1,74 @@
 # @yomologic/react-ui
 
-A modern, lightweight React UI component library built with TypeScript and designed for flexibility and ease of use.
+A modern, lightweight React UI component library built with TypeScript and Tailwind CSS.
+
+> **📚 [View Full Documentation & Live Examples →](https://react-ui.yomologic.com/)**
 
 ## Features
 
-- 🎨 **Modern Design** - Clean, professional components
+- 🎨 **Themeable** - Built-in dark theme with CSS variables
+- 🎯 **TypeScript** - Complete type safety
 - 📦 **Tree-shakeable** - Import only what you need
-- 🎯 **TypeScript** - Full type safety
-- ⚡ **Zero Dependencies** - Minimal bundle size (except lucide-react for icons)
-- 🎭 **Customizable** - Easy to style and extend
-- ♿ **Accessible** - Built with accessibility in mind
+- ⚡ **Framework-agnostic** - Works with Next.js, Remix, Vite, etc.
+- ♿ **Accessible** - ARIA compliant
+- 📱 **Responsive** - Mobile-first design
 
 ## Installation
 
 ```bash
-# Using yarn
-yarn add @yomologic/react-ui
-
-# Using npm
 npm install @yomologic/react-ui
+# or
+yarn add @yomologic/react-ui
 ```
 
-## Usage
+## Quick Start
 
 ```tsx
-import { Button, Input, Card } from "@yomologic/react-ui";
+import "@yomologic/react-ui/dist/base.css";
+import "@yomologic/react-ui/dist/styles.css";
+import { Button, Card, Input } from "@yomologic/react-ui";
 
 function App() {
-  return (
-    <Card padding="lg">
-      <Input label="Email" type="email" placeholder="you@example.com" />
-      <Button variant="primary" size="md">
-        Submit
-      </Button>
-    </Card>
-  );
+    return (
+        <Card padding="lg">
+            <Input label="Email" type="email" />
+            <Button variant="primary">Submit</Button>
+        </Card>
+    );
 }
 ```
 
-## Components
-
-### UI Components
+## Theming
 
-- **Button** - Interactive buttons with variants (primary, secondary, outline, ghost, danger)
-- **Input** - Text inputs with labels, icons, and validation states
-- **Card** - Flexible container with variants and padding options
-- **Badge** - Status indicators and labels
-- **Checkbox** - Single checkboxes and checkbox groups
-- **RadioGroup** - Radio button groups for single selections
-- **Dropdown** - Select dropdowns with search and custom options
-- **Spinner** - Loading indicators
-- **CodeSnippet** - Syntax-highlighted code display
+Override CSS variables to customize the built-in dark theme:
 
-### Feedback Components
+```css
+/* custom-theme.css */
+:root {
+    --color-primary: #3b82f6;
+    --color-primary-hover: #2563eb;
+    --color-background: #ffffff;
+    --color-foreground: #111827;
+    --color-muted: #f3f4f6;
+    --color-border: #e5e7eb;
+    /* ...more variables */
+}
+```
 
-- **Alert** - Contextual feedback messages (info, success, warning, error)
+Import your custom theme **after** the base styles:
 
-### Layout Components
+```tsx
+import "@yomologic/react-ui/dist/base.css";
+import "@yomologic/react-ui/dist/styles.css";
+import "./custom-theme.css"; // Your overrides
+```
 
-- **Container** - Responsive page container
-- **SectionLayout** - Layout wrapper for sections
-- **Drawer** - Navigation drawer/sidebar
-- **SidebarNav** - (Deprecated, use Drawer instead)
+## Documentation
 
-### Shared Components
+**Full documentation, live examples, and interactive demos:**  
+👉 **[react-ui.yomologic.com](https://react-ui.yomologic.com/)**
 
-- **EmptyState** - Empty state placeholders
+Browse all components, see code examples, and experiment with variants in our interactive showcase.
 
 ## Development
 
@@ -83,6 +86,10 @@ yarn dev
 yarn type-check
 ```
 
+## Contributing
+
+This is a private component library for Yomologic projects. For internal development documentation, see the implementation guides in the repository.
+
 ## License
 
 MIT

package/dist/base.css

@@ -0,0 +1,294 @@
+/* Custom CSS Variables - Dark Theme Defaults */
+:root {
+  /* Colors - Default to dark theme */
+  --color-primary: #19bfb7;
+  --color-primary-hover: #16a39d;
+  --color-primary-active: #138883;
+  --color-secondary: #8b9ba8;
+  --color-secondary-hover: #a3b4c2;
+  --color-success: #4ec9b0;
+  --color-error: #e07088;
+  --color-warning: #d4a574;
+  --color-info: #4d9de0;
+  --color-background: #0f1419;
+  --color-foreground: #e3e8ed;
+  --color-muted: #1a2028;
+  --color-muted-foreground: #8b9ba8;
+  --color-placeholder: #5a6b7a;
+  --color-border: #2d3843;
+
+  /* Semantic color variants for dark theme */
+  --color-info-foreground: #0f1419;
+  --color-info-muted: #1a3a52;
+  --color-info-muted-foreground: #4d9de0;
+  --color-info-border: #4d9de0;
+  
+  --color-success-foreground: #0f1419;
+  --color-success-muted: #1a3d2e;
+  --color-success-muted-foreground: #4ec9b0;
+  --color-success-border: #4ec9b0;
+  
+  --color-warning-foreground: #0f1419;
+  --color-warning-muted: #3d311a;
+  --color-warning-muted-foreground: #d4a574;
+  --color-warning-border: #d4a574;
+  
+  --color-error-foreground: #0f1419;
+  --color-error-muted: #3d1a25;
+  --color-error-muted-foreground: #e07088;
+  --color-error-border: #e07088;
+
+  /* Spacing */
+  --spacing-xs: 0.25rem;
+  --spacing-sm: 0.5rem;
+  --spacing-md: 1rem;
+  --spacing-lg: 1.5rem;
+  --spacing-xl: 2rem;
+  --spacing-2xl: 2.5rem;
+
+  /* Border Radius */
+  --radius-none: 0;
+  --radius-sm: 0.25rem;
+  --radius-md: 0.5rem;
+  --radius-lg: 0.75rem;
+  --radius-xl: 1rem;
+  --radius-full: 9999px;
+
+  /* Typography */
+  --text-xs: 0.75rem;
+  --text-sm: 0.875rem;
+  --text-base: 1rem;
+  --text-lg: 1.125rem;
+  --text-xl: 1.25rem;
+  --text-2xl: 1.5rem;
+  --text-3xl: 1.875rem;
+  
+  --font-normal: 400;
+  --font-medium: 500;
+  --font-semibold: 600;
+  --font-bold: 700;
+
+  /* Component: Button */
+  --button-padding-xs-x: 0.5rem;
+  --button-padding-xs-y: 0.375rem;
+  --button-padding-sm-x: 0.75rem;
+  --button-padding-sm-y: 0.5rem;
+  --button-padding-md-x: 1rem;
+  --button-padding-md-y: 0.625rem;
+  --button-padding-lg-x: 1.5rem;
+  --button-padding-lg-y: 0.75rem;
+  --button-padding-xl-x: 2rem;
+  --button-padding-xl-y: 1rem;
+  --button-font-size-xs: 0.75rem;
+  --button-font-size-sm: 0.875rem;
+  --button-font-size-md: 1rem;
+  --button-font-size-lg: 1.125rem;
+  --button-font-size-xl: 1.25rem;
+  --button-radius: 0.5rem;
+  --button-font-weight: 500;
+  --button-border-width: 2px;
+  --button-primary-text: #0f1419;
+  --button-secondary-text: #e3e8ed;
+  --button-ghost-hover-bg: rgba(99, 102, 241, 0.08);
+  --button-ghost-active-bg: rgba(99, 102, 241, 0.16);
+  --button-outline-hover-bg: rgba(59, 130, 246, 0.12);
+  --button-outline-active-bg: rgba(59, 130, 246, 0.24);
+  --button-ghost-active-bg: rgba(0, 0, 0, 0.1);
+  --button-outline-hover-bg: rgba(59, 130, 246, 0.1);
+  --button-outline-active-bg: rgba(59, 130, 246, 0.2);
+
+  /* Component: Card */
+  --card-padding-none: 0;
+  --card-padding-sm: 1rem;
+  --card-padding-md: 1.5rem;
+  --card-padding-lg: 2rem;
+  --card-radius: 0.75rem;
+  --card-border-width: 1px;
+  --card-shadow-flat: 0 1px 2px 0 rgb(0 0 0 / 0.05);
+  --card-shadow-elevated: 0 10px 15px -3px rgb(0 0 0 / 0.1), 0 4px 6px -4px rgb(0 0 0 / 0.1);
+
+  /* Component: Input */
+  --input-padding-x: 0.75rem;
+  --input-padding-y: 0.5rem;
+  --input-border-radius: 0.5rem;
+  --input-border-width: 1px;
+  --input-font-size: 1rem;
+
+  /* Component: Container */
+  --container-padding-x: 1rem;
+  --container-max-width-sm: 640px;
+  --container-max-width-md: 768px;
+  --container-max-width-lg: 1024px;
+  --container-max-width-xl: 1280px;
+  --container-max-width-2xl: 1536px;
+
+  /* Z-Index Scale - Organized by layer
+   * Base: 0-9 (normal content, code blocks, relative elements)
+   * Sticky/Fixed: 10-99 (sticky headers, fixed footers)
+   * Overlays: 100-999 (dropdowns, popovers, drawers)
+   * Modals: 1000-1999 (dialogs, modals, tooltips)
+   * Notifications: 2000+ (toasts, alerts, snackbars)
+   */
+  
+  /* Base Layer (0-9) */
+  --z-index-base: 0;
+  --z-index-code-button: 1;
+  
+  /* Sticky/Fixed Layer (10-99) */
+  --z-index-sticky: 10;
+  --z-index-nav: 50;
+  --z-index-nav-mobile-overlay: 60;
+  --z-index-nav-mobile-menu: 70;
+  
+  /* Overlay Layer (100-999) */
+  --z-index-drawer-overlay: 100;
+  --z-index-drawer-panel: 110;
+  --z-index-drawer-header: 120;
+  --z-index-drawer-button: 121;
+  --z-index-dropdown: 200;
+  --z-index-popover: 300;
+  --z-index-overlay: 400;
+  
+  /* Modal Layer (1000-1999) */
+  --z-index-modal-backdrop: 1000;
+  --z-index-modal: 1100;
+  --z-index-tooltip: 1200;
+  
+  /* Notification Layer (2000+) */
+  --z-index-snackbar: 2000;
+  --z-index-toast: 2100;
+
+  /* Component: Nav */
+  --nav-height: 3.5rem;
+  --nav-gap: 0.5rem;
+  --nav-border-radius: 0.5rem;
+  
+  /* Nav Item Padding */
+  --nav-item-padding-xs-x: 0.5rem;
+  --nav-item-padding-xs-y: 0.25rem;
+  --nav-item-padding-sm-x: 0.75rem;
+  --nav-item-padding-sm-y: 0.5rem;
+  --nav-item-padding-md-x: 1rem;
+  --nav-item-padding-md-y: 0.625rem;
+  --nav-item-padding-lg-x: 1.5rem;
+  --nav-item-padding-lg-y: 0.75rem;
+  --nav-item-padding-xl-x: 2rem;
+  --nav-item-padding-xl-y: 1rem;
+  
+  /* Nav Font Sizes */
+  --nav-font-size-xs: 0.75rem;
+  --nav-font-size-sm: 0.875rem;
+  --nav-font-size-md: 1rem;
+  --nav-font-size-lg: 1.125rem;
+  --nav-font-size-xl: 1.25rem;
+
+  /* Component: Checkbox */
+  --checkbox-size-xs: 1rem;
+  --checkbox-size-sm: 1.25rem;
+  --checkbox-size-md: 1.5rem;
+  --checkbox-size-lg: 1.75rem;
+  --checkbox-size-xl: 2rem;
+  --checkbox-label-font-size-xs: 0.75rem;
+  --checkbox-label-font-size-sm: 0.875rem;
+  --checkbox-label-font-size-md: 1rem;
+  --checkbox-label-font-size-lg: 1.125rem;
+  --checkbox-label-font-size-xl: 1.25rem;
+  --checkbox-label-spacing-xs: 0.5rem;
+  --checkbox-label-spacing-sm: 0.625rem;
+  --checkbox-label-spacing-md: 0.75rem;
+  --checkbox-label-spacing-lg: 0.875rem;
+  --checkbox-label-spacing-xl: 1rem;
+  --checkbox-radius: 0.25rem;
+  --checkbox-border-color: #9ca3af;
+  --checkbox-checked-color: #2563eb;
+  --checkbox-label-color: #4b5563;
+  --checkbox-hover-bg: rgba(37, 99, 235, 0.1);
+  --checkbox-hover-size: 2rem;
+  --checkbox-disabled-opacity: 0.5;
+
+  /* Component: Radio */
+  --radio-size-xs: 1rem;
+  --radio-size-sm: 1.25rem;
+  --radio-size-md: 1.5rem;
+  --radio-size-lg: 1.75rem;
+  --radio-size-xl: 2rem;
+  --radio-label-font-size-xs: 0.75rem;
+  --radio-label-font-size-sm: 0.875rem;
+  --radio-label-font-size-md: 1rem;
+  --radio-label-font-size-lg: 1.125rem;
+  --radio-label-font-size-xl: 1.25rem;
+  --radio-label-spacing-xs: 0.5rem;
+  --radio-label-spacing-sm: 0.625rem;
+  --radio-label-spacing-md: 0.75rem;
+  --radio-label-spacing-lg: 0.875rem;
+  --radio-label-spacing-xl: 1rem;
+  --radio-border-color: #9ca3af;
+  --radio-checked-color: #2563eb;
+  --radio-label-color: #4b5563;
+  --radio-hover-bg: rgba(37, 99, 235, 0.1);
+  --radio-hover-size: 2rem;
+  --radio-disabled-opacity: 0.5;
+
+  /* Form Controls: Shared spacing between control and label */
+  --form-control-label-gap: 0.5rem; /* 8px / gap-2 */
+
+  /* Component: Drawer */
+  --drawer-section-padding-y: 1rem;
+  --drawer-title-margin-bottom: 0.5rem;
+  --drawer-item-spacing: 0.25rem;
+  --drawer-item-padding-x: 1rem;
+  --drawer-item-padding-y: 0.625rem;
+  --drawer-font-size: 0.875rem;
+  --drawer-border-radius: 0.5rem;
+
+  /* Component: Dropdown */
+  --dropdown-radius: 0.5rem;
+  
+  /* Dropdown Trigger Padding */
+  --dropdown-padding-xs-x: 0.5rem;
+  --dropdown-padding-xs-y: 0.375rem;
+  --dropdown-padding-sm-x: 0.75rem;
+  --dropdown-padding-sm-y: 0.5rem;
+  --dropdown-padding-md-x: 0.75rem;
+  --dropdown-padding-md-y: 0.625rem;
+  --dropdown-padding-lg-x: 1rem;
+  --dropdown-padding-lg-y: 0.75rem;
+  --dropdown-padding-xl-x: 1.25rem;
+  --dropdown-padding-xl-y: 0.875rem;
+  
+  /* Dropdown Font Sizes */
+  --dropdown-font-size-xs: 0.75rem;
+  --dropdown-font-size-sm: 0.875rem;
+  --dropdown-font-size-md: 1rem;
+  --dropdown-font-size-lg: 1.125rem;
+  --dropdown-font-size-xl: 1.25rem;
+  
+  /* Dropdown Icon Sizes */
+  --dropdown-icon-size-xs: 0.875rem;
+  --dropdown-icon-size-sm: 1rem;
+  --dropdown-icon-size-md: 1.25rem;
+  --dropdown-icon-size-lg: 1.5rem;
+  --dropdown-icon-size-xl: 1.75rem;
+  
+  /* Dropdown Option Padding */
+  --dropdown-option-padding-xs-x: 0.5rem;
+  --dropdown-option-padding-xs-y: 0.375rem;
+  --dropdown-option-padding-sm-x: 0.75rem;
+  --dropdown-option-padding-sm-y: 0.5rem;
+  --dropdown-option-padding-md-x: 0.75rem;
+  --dropdown-option-padding-md-y: 0.625rem;
+  --dropdown-option-padding-lg-x: 1rem;
+  --dropdown-option-padding-lg-y: 0.75rem;
+  --dropdown-option-padding-xl-x: 1.25rem;
+  --dropdown-option-padding-xl-y: 0.875rem;
+  
+  /* Dropdown Option Font Sizes */
+  --dropdown-option-font-size-xs: 0.75rem;
+  --dropdown-option-font-size-sm: 0.875rem;
+  --dropdown-option-font-size-md: 1rem;
+  --dropdown-option-font-size-lg: 1.125rem;
+  --dropdown-option-font-size-xl: 1.25rem;
+
+  /* Component: Rating */
+  --star-size: 1.5rem;
+}