@yomologic/react-ui 0.2.7 → 0.3.1

package/README.md

@@ -4,12 +4,13 @@ A modern, lightweight React UI component library built with TypeScript and desig
 
 ## Features
 
-- 🎨 **Modern Design** - Clean, professional components
+- 🎨 **Modern Design** - Clean, professional components inspired by Tailwind UI
 - 📦 **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
+- ⚡ **Lightweight** - Minimal dependencies
+- 🎭 **Themeable** - CSS variables for easy customization
 - ♿ **Accessible** - Built with accessibility in mind
+- 📱 **Responsive** - Mobile-first design patterns
 
 ## Installation
 
@@ -27,14 +28,14 @@ npm install @yomologic/react-ui
 import { Button, Input, Card } 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" placeholder="you@example.com" />
+            <Button variant="primary" size="md">
+                Submit
+            </Button>
+        </Card>
+    );
 }
 ```
 
@@ -50,7 +51,9 @@ function App() {
 - **RadioGroup** - Radio button groups for single selections
 - **Dropdown** - Select dropdowns with search and custom options
 - **Spinner** - Loading indicators
-- **CodeSnippet** - Syntax-highlighted code display
+- **CodeSnippet** - Syntax-highlighted code display with copy button
+- **Dialog** - Modal dialogs with header, content, and footer sections
+- **Divider** - Visual separators for content sections
 
 ### Feedback Components
 
@@ -58,14 +61,37 @@ function App() {
 
 ### Layout Components
 
-- **Container** - Responsive page container
-- **SectionLayout** - Layout wrapper for sections
-- **Drawer** - Navigation drawer/sidebar
-- **SidebarNav** - (Deprecated, use Drawer instead)
+- **Container** - Responsive page container with max-width constraints
+- **SectionLayout** - Layout wrapper for documentation sections
+- **Nav** - Navigation bar with mobile menu support (dropdown or drawer)
+- **Drawer** - Slide-out drawer/sidebar for navigation
 
-### Shared Components
+## Theming
 
-- **EmptyState** - Empty state placeholders
+The library uses CSS variables for theming, allowing easy customization:
+
+```css
+:root {
+    --color-primary: #3b82f6;
+    --color-secondary: #6b7280;
+    --color-success: #10b981;
+    --color-error: #ef4444;
+    --color-warning: #f59e0b;
+    /* ... more variables */
+}
+```
+
+### Z-Index System
+
+Components follow a structured z-index system to prevent stacking conflicts:
+
+- **Base Layer (0-9)**: Normal content, code buttons
+- **Sticky/Fixed (10-99)**: Navigation, sticky headers
+- **Overlay (100-999)**: Dropdowns, popovers, drawers
+- **Modal (1000-1999)**: Dialogs, tooltips
+- **Notification (2000+)**: Toasts, snackbars
+
+All z-index values are defined as CSS variables (e.g., `--z-index-nav`, `--z-index-modal`) for consistency.
 
 ## Development
 
@@ -83,6 +109,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;
+}