@hanzo/ui 5.0.3 → 5.1.0

package/README.md

@@ -1,29 +1,10 @@
-# @hanzo/ui v5
+# @hanzo/ui
 
-[![npm version](https://img.shields.io/npm/v/@hanzo/ui.svg)](https://www.npmjs.com/package/@hanzo/ui)
-[![npm downloads](https://img.shields.io/npm/dm/@hanzo/ui.svg)](https://www.npmjs.com/package/@hanzo/ui)
-[![Bundle Size](https://img.shields.io/bundlephobia/minzip/@hanzo/ui)](https://bundlephobia.com/package/@hanzo/ui)
-[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
-[![TypeScript](https://img.shields.io/badge/TypeScript-Ready-blue.svg)](https://www.typescriptlang.org/)
+A comprehensive UI component library for Hanzo applications, built with React and TypeScript.
 
-Modern React component library built on shadcn/ui v4 with Hanzo branding, featuring 50+ accessible components, 35+ hooks, and comprehensive TypeScript support.
+## Version 4.5.6
 
-## ✨ Features
-
-- 🎨 **Multi-Brand Theming** - Built-in support for Hanzo, Lux, and Zoo brands
-- 📦 **50+ Components** - Comprehensive UI components based on shadcn/ui v4
-- 🪝 **35+ Custom Hooks** - Powerful React hooks for common patterns
-- 🛠️ **25+ Utilities** - Helper functions and utilities
-- 🌙 **Dark Mode** - Native dark mode with system preference detection
-- ♿ **Accessible** - WCAG 2.1 AA compliant components
-- 📱 **Responsive** - Mobile-first responsive design
-- 🎯 **Tree Shakeable** - Import only what you need
-- 💅 **Tailwind CSS** - Utility-first styling with Tailwind v3.4+
-- 🎭 **OKLCH Colors** - Modern color system with OKLCH color space
-- 🤖 **AI Components** - Chat interfaces and AI-specific components
-- 📋 **Copy/Paste** - Components can be copied directly into your project
-
-## 📦 Installation
+## Installation
 
 ```bash
 npm install @hanzo/ui
@@ -33,190 +14,216 @@ pnpm add @hanzo/ui
 yarn add @hanzo/ui
 ```
 
-## 🚀 Quick Start
-
-### 1. Configure Tailwind CSS
-
-Add the Hanzo UI preset to your `tailwind.config.js`:
-
-```js
-// tailwind.config.js
-import hanzoPreset from '@hanzo/ui/tailwind-preset'
-
-export default {
-  presets: [hanzoPreset],
-  content: [
-    './src/**/*.{js,ts,jsx,tsx,mdx}',
-    './node_modules/@hanzo/ui/dist/**/*.{js,mjs}'
-  ],
-  // ... your config
-}
-```
-
-### 2. Import Components
-
-```tsx
-// Import utilities
-import { cn } from '@hanzo/ui'
-
-// Import components
-import { Button, Card, Dialog } from '@hanzo/ui/components'
-
-// Or import individually
-import { Button } from '@hanzo/ui/components/button'
-import { Card } from '@hanzo/ui/components/card'
-
-// Import AI components
-import { ChatInterface } from '@hanzo/ui/ai'
-
-// Import block patterns
-import { AuthForm } from '@hanzo/ui/blocks'
-```
-
-### 3. Use Components
-
-```tsx
-export function App() {
-  return (
-    <Card className="p-6">
-      <h1>Welcome to Hanzo UI</h1>
-      <Button variant="default" size="lg">
-        Get Started
-      </Button>
-    </Card>
-  )
-}
-```
-
-## 📚 Component Categories
-
-### Core Components
-- **Layout**: Container, Grid, Stack, Spacer
-- **Typography**: Heading, Text, Label
-- **Buttons**: Button, IconButton, ButtonGroup
-- **Forms**: Input, Textarea, Select, Checkbox, Radio, Switch
-- **Feedback**: Alert, Toast, Progress, Skeleton
-- **Overlay**: Dialog, Sheet, Popover, Tooltip
-- **Navigation**: Tabs, Breadcrumb, Pagination
-- **Data Display**: Table, DataTable, Card, Badge
-- **Media**: Avatar, Image, Video
-
-### AI Components
-- Chat Interface
-- Message Components
-- Code Block with Syntax Highlighting
-- Streaming Support
-- Tool Use Display
-
-### Block Patterns
-- Authentication Forms
-- Dashboard Layouts
-- Marketing Sections
-- E-commerce Patterns
-- Landing Pages
-
-## 🎨 Theming
-
-### Using CSS Variables
-
-Hanzo UI uses CSS variables for theming. You can customize the theme by overriding these variables:
-
-```css
-@layer base {
-  :root {
-    --hanzo-background: 0 0% 100%;
-    --hanzo-foreground: 0 0% 3.9%;
-    --hanzo-primary: 0 0% 9%;
-    --hanzo-primary-foreground: 0 0% 98%;
-    /* ... more variables */
-  }
-
-  .dark {
-    --hanzo-background: 0 0% 3.9%;
-    --hanzo-foreground: 0 0% 98%;
-    /* ... dark mode variables */
-  }
-}
-```
-
-### Multiple Brands
-
-Switch between brand themes:
+## Components
+
+### Primitives
+
+Core UI components based on Radix UI primitives:
+
+- **Accordion** - Collapsible content panels
+- **Alert** - Informative alert messages
+- **AlertDialog** - Modal dialogs for important alerts
+- **Avatar** - User avatar display
+- **Badge** - Status and label badges
+- **Breadcrumb** - Navigation breadcrumbs
+- **Button** - Interactive buttons with variants
+- **Calendar** - Date picker calendar
+- **Card** - Container cards for content
+- **Carousel** - Image/content carousel
+- **Checkbox** - Checkbox input
+- **Collapsible** - Collapsible content sections
+- **Combobox** - Searchable select dropdown
+- **Command** - Command palette component
+- **ContextMenu** - Right-click context menus
+- **Dialog** - Modal dialogs
+- **Drawer** - Slide-out drawer panels
+- **DropdownMenu** - Dropdown menu component
+- **Form** - Form components with validation
+- **HoverCard** - Hover-triggered info cards
+- **Input** - Text input field
+- **InputOTP** - One-time password input
+- **Label** - Form labels
+- **NavigationMenu** - Navigation menu bar
+- **Popover** - Popover overlays
+- **Progress** - Progress indicators
+- **RadioGroup** - Radio button groups
+- **ResizablePanel** - Resizable panel layouts
+- **ScrollArea** - Custom scrollable areas
+- **SearchInput** - Search input with icon
+- **Select** - Select dropdown
+- **Separator** - Visual separator line
+- **Sheet** - Side sheet panels
+- **Skeleton** - Loading skeleton screens
+- **Slider** - Range slider input
+- **Switch** - Toggle switch
+- **Table** - Data tables
+- **Tabs** - Tabbed interfaces
+- **TextArea** - Multi-line text input
+- **TextField** - Enhanced text input
+- **Toast** - Toast notifications (via Sonner)
+- **Toggle** - Toggle buttons
+- **ToggleGroup** - Grouped toggle buttons
+- **Tooltip** - Hover tooltips
+- **VideoPlayer** - Video playback component
+
+### Assets
+
+Icon components and visual assets:
+
+#### AI Provider Icons
+- **AnthropicIcon** - Anthropic AI logo
+- **OpenAIIcon** - OpenAI logo
+- **GeminiIcon** - Google Gemini logo
+- **DeepSeekIcon** - DeepSeek logo
+- **MistralIcon** - Mistral AI logo
+- **MetaIcon** - Meta AI logo
+- **GroqIcon** - Groq logo
+- **OllamaIcon** - Ollama logo
+- **HanzoIcon** - Hanzo AI logo
+- **TogetherAI** - Together AI logo
+- **ExoIcon** - Exo logo
+- **GrokIcon** - Grok logo
+- **LmStudioIcon** - LM Studio logo
+- **OpenRouterIcon** - OpenRouter logo
+- **PerplexityIcon** - Perplexity logo
+- **QwenIcon** - Qwen logo
+- **AyaCohereIcon** - Aya/Cohere logo
+
+#### Feature Icons
+- **AIAgentIcon** - AI agent indicator
+- **AisIcon** - AI services icon
+- **ReactJsIcon** - React.js logo
+- **ReasoningIcon** - AI reasoning indicator
+- **ToolsIcon** - Tools/utilities icon
+- **TracingIcon** - Tracing/monitoring icon
+- **ScheduledTasksIcon** - Scheduled tasks icon
+- **SendIcon** - Send/submit icon
+
+#### File Type Icons
+- **FileTypeIcon** - Dynamic file type icon based on extension
+- **DirectoryTypeIcon** - Folder/directory icon
+
+### Utilities
+
+Helper functions and hooks:
+
+- **cn()** - Class name utility (clsx + tailwind-merge)
+- **markdown()** - Markdown to JSX converter
+- **formatText()** - Text formatting utilities
+- **useDebounce()** - Debounce hook
+- **useMap()** - Map state management hook
+- **formatDateToLocaleStringWithTime()** - Date formatting
+- **getFileExt()** - File extension extraction
+- **hexToRgb()** - Color conversion utilities
+
+### Custom Components
+
+Additional enhanced components:
+
+- **ChatInput** - Chat message input
+- **ChatInputArea** - Multi-line chat input
+- **ChatSettingsIcon** - Chat settings icon
+- **CopyToClipboardIcon** - Copy to clipboard button
+- **DotsLoader** - Loading dots animation
+- **FileList** - File list display
+- **FileUploader** - File upload component
+- **JsonForm** - JSON-based dynamic forms
+- **MarkdownText** - Markdown renderer
+- **PrettyJsonPrint** - Formatted JSON display
+
+## Styling
+
+The library uses Tailwind CSS for styling. Make sure your application includes Tailwind CSS configuration.
+
+## Dependencies
+
+Key peer dependencies:
+- React 18.3.1+
+- React DOM 18.3.1+
+- @hookform/resolvers ^3.3.2
+- react-hook-form 7.51.4
+- lucide-react 0.456.0
+- next-themes ^0.2.1
+- embla-carousel ^8.1.6
+
+## Usage Examples
+
+### Basic Button
 
 ```tsx
-import { ThemeProvider } from '@hanzo/ui/components/theme-provider'
+import { Button } from '@hanzo/ui';
 
 function App() {
   return (
-    <ThemeProvider defaultTheme="hanzo" storageKey="ui-theme">
-      {/* Your app */}
-    </ThemeProvider>
-  )
+    <Button variant="primary" onClick={() => console.log('clicked')}>
+      Click me
+    </Button>
+  );
 }
 ```
 
-## 🔧 Advanced Usage
-
-### Custom Styling with cn()
-
-The `cn()` utility combines clsx and tailwind-merge:
+### Alert Dialog
 
 ```tsx
-import { cn } from '@hanzo/ui'
-
-function CustomButton({ className, ...props }) {
+import {
+  AlertDialog,
+  AlertDialogTrigger,
+  AlertDialogContent,
+  AlertDialogHeader,
+  AlertDialogTitle,
+  AlertDialogDescription,
+  AlertDialogFooter,
+  AlertDialogAction,
+  AlertDialogCancel
+} from '@hanzo/ui';
+
+function ConfirmDialog() {
   return (
-    <button
-      className={cn(
-        'px-4 py-2 rounded-lg bg-primary text-primary-foreground',
-        'hover:bg-primary/90 transition-colors',
-        className
-      )}
-      {...props}
-    />
-  )
+    <AlertDialog>
+      <AlertDialogTrigger>
+        <Button>Open Dialog</Button>
+      </AlertDialogTrigger>
+      <AlertDialogContent>
+        <AlertDialogHeader>
+          <AlertDialogTitle>Are you sure?</AlertDialogTitle>
+          <AlertDialogDescription>
+            This action cannot be undone.
+          </AlertDialogDescription>
+        </AlertDialogHeader>
+        <AlertDialogFooter>
+          <AlertDialogCancel>Cancel</AlertDialogCancel>
+          <AlertDialogAction>Continue</AlertDialogAction>
+        </AlertDialogFooter>
+      </AlertDialogContent>
+    </AlertDialog>
+  );
 }
 ```
 
-### TypeScript Support
-
-All components are fully typed:
+### AI Provider Icons
 
 ```tsx
-import type { ButtonProps } from '@hanzo/ui/components/button'
+import { OpenAIIcon, AnthropicIcon, GeminiIcon } from '@hanzo/ui/assets';
 
-interface CustomButtonProps extends ButtonProps {
-  customProp?: string
-}
-
-export function CustomButton({ customProp, ...props }: CustomButtonProps) {
-  return <Button {...props} />
+function AIProviders() {
+  return (
+    <div className="flex gap-4">
+      <OpenAIIcon className="h-6 w-6" />
+      <AnthropicIcon className="h-6 w-6" />
+      <GeminiIcon className="h-6 w-6" />
+    </div>
+  );
 }
 ```
 
-## 📖 Documentation
-
-- [Full Documentation](https://ui.hanzo.ai)
-- [Component Examples](https://ui.hanzo.ai/components)
-- [Migration Guide](https://ui.hanzo.ai/docs/migration)
-- [Storybook](https://ui.hanzo.ai/storybook)
-
-## 🤝 Contributing
-
-Contributions are welcome! Please read our [Contributing Guide](https://github.com/hanzoai/ui/blob/main/CONTRIBUTING.md) for details.
-
-## 📄 License
+## License
 
-MIT © [Hanzo AI](https://hanzo.ai)
+BSD-3-Clause
 
-## 🔗 Links
+## Author
 
-- [GitHub Repository](https://github.com/hanzoai/ui)
-- [NPM Package](https://www.npmjs.com/package/@hanzo/ui)
-- [Documentation](https://ui.hanzo.ai)
-- [Storybook](https://ui.hanzo.ai/storybook)
-- [Discord Community](https://discord.gg/hanzo)
+Hanzo AI, Inc.
 
----
+## Repository
 
-Built with ❤️ by [Hanzo AI](https://hanzo.ai)
+https://github.com/hanzoai/react-sdk

package/bin/cli.js

@@ -0,0 +1,100 @@
+#!/usr/bin/env node
+
+/**
+ * Main CLI entry point for @hanzo/ui
+ * Supports various commands including registry:mcp
+ */
+
+const { program } = require("commander");
+
+// Define the version from the package.json
+let version = "4.5.0";
+try {
+  const packageJson = require("../package.json");
+  version = packageJson.version || version;
+} catch (error) {
+  // Use default version if package.json can't be loaded
+}
+
+// Set up the program
+program
+  .name("@hanzo/ui")
+  .description("Hanzo UI Component Library CLI")
+  .version(version);
+  
+// Add the MCP command (main command)
+program
+  .command("mcp")
+  .description("Start the Hanzo UI MCP server for AI assistants")
+  .option(
+    "-r, --registry <url>", 
+    "URL to the registry.json file",
+    process.env.REGISTRY_URL || "https://ui.hanzo.ai/registry/registry.json"
+  )
+  .option(
+    "-p, --port <port>",
+    "Port to listen on (for HTTP mode)",
+    "3333"
+  )
+  .option(
+    "--http",
+    "Run in HTTP mode instead of stdio mode",
+    false
+  )
+  .action(async (options) => {
+    // Delegate to the dedicated MCP binary
+    require("./mcp.js");
+  });
+
+// Add the registry:mcp command (alias for compatibility)
+program
+  .command("registry:mcp")
+  .description("Starts the registry MCP server (alias for 'mcp')")
+  .option(
+    "-r, --registry <url>", 
+    "URL to the registry.json file",
+    process.env.REGISTRY_URL
+  )
+  .option(
+    "-p, --port <port>",
+    "Port to listen on (for HTTP mode)",
+    "3333"
+  )
+  .option(
+    "--http",
+    "Run in HTTP mode instead of stdio mode",
+    false
+  )
+  .action(async (options) => {
+    try {
+      // Set environment variables based on options
+      if (options.registry) {
+        process.env.REGISTRY_URL = options.registry;
+      }
+      
+      // Set port if running in HTTP mode
+      if (options.http) {
+        process.env.MCP_HTTP_MODE = "true";
+        process.env.MCP_PORT = options.port;
+      }
+
+      // Show info about the server
+      console.error("Starting Hanzo UI MCP server...");
+      console.error(`Registry URL: ${process.env.REGISTRY_URL || "[Using default registry]"}`);
+      
+      if (options.http) {
+        console.error(`Running in HTTP mode on port ${options.port}`);
+      } else {
+        console.error("Running in stdio mode");
+      }
+      
+      // Load and run the MCP server script
+      require("./registry-mcp.js");
+    } catch (error) {
+      console.error("Error starting MCP server:", error);
+      process.exit(1);
+    }
+  });
+
+// Parse command line arguments
+program.parse();

package/bin/create-registry.js

@@ -0,0 +1,108 @@
+#!/usr/bin/env node
+
+/**
+ * Simple registry builder for @hanzo/ui
+ * Creates the necessary structure for the MCP registry
+ */
+
+const fs = require('fs');
+const path = require('path');
+
+// Configuration
+const REGISTRY_DIR = path.resolve(__dirname, '../registry');
+const PUBLIC_DIR = path.resolve(__dirname, '../public');
+const OUTPUT_FILE = path.resolve(__dirname, '../registry.json');
+const REGISTRY_STYLES = ['default', 'new-york']; 
+
+// Registry schema
+const registrySchema = {
+  "$schema": "https://ui.hanzo.com/schema/registry.json",
+  "name": "hanzo",
+  "homepage": "https://ui.hanzo.ai",
+  "items": []
+};
+
+// Create the basic registry structure
+function createRegistry() {
+  console.log('Creating registry structure...');
+  
+  const items = [];
+  
+  // Ensure registry directory exists
+  if (!fs.existsSync(REGISTRY_DIR)) {
+    fs.mkdirSync(REGISTRY_DIR, { recursive: true });
+  }
+  
+  // Create style directories and add them to registry items
+  for (const style of REGISTRY_STYLES) {
+    const styleDir = path.join(REGISTRY_DIR, style);
+    if (!fs.existsSync(styleDir)) {
+      fs.mkdirSync(styleDir, { recursive: true });
+      
+      // Create ui and block directories
+      fs.mkdirSync(path.join(styleDir, 'ui'), { recursive: true });
+      fs.mkdirSync(path.join(styleDir, 'block'), { recursive: true });
+    }
+    
+    // Add style to registry
+    items.push({
+      name: style,
+      type: 'registry:style',
+      description: `The ${style} style for Hanzo UI components.`,
+      files: []
+    });
+  }
+  
+  // Add primitive components as empty placeholders
+  const primitives = [
+    'accordion', 'alert', 'avatar', 'badge', 'button', 'card', 
+    'checkbox', 'dialog', 'input', 'label', 'popover', 'select', 
+    'table', 'tabs', 'toast'
+  ];
+  
+  for (const component of primitives) {
+    items.push({
+      name: component,
+      type: 'registry:component',
+      description: `A ${component} component for your UI.`,
+      files: [
+        {
+          path: `default/ui/${component}/${component}.tsx`,
+          type: 'registry:component'
+        }
+      ]
+    });
+  }
+  
+  // Update registry.json
+  registrySchema.items = items;
+  
+  // Create output directory if it doesn't exist
+  const outputDir = path.dirname(OUTPUT_FILE);
+  if (!fs.existsSync(outputDir)) {
+    fs.mkdirSync(outputDir, { recursive: true });
+  }
+  
+  // Write registry.json
+  fs.writeFileSync(OUTPUT_FILE, JSON.stringify(registrySchema, null, 2), 'utf8');
+  console.log(`Registry updated with ${items.length} items.`);
+  
+  // Create public/r directory if it doesn't exist
+  const publicRDir = path.join(PUBLIC_DIR, 'r');
+  if (!fs.existsSync(publicRDir)) {
+    fs.mkdirSync(publicRDir, { recursive: true });
+  }
+  
+  // Generate individual component JSON files
+  console.log('Generating individual component JSON files...');
+  for (const item of items) {
+    const componentFile = path.join(publicRDir, `${item.name}.json`);
+    fs.writeFileSync(componentFile, JSON.stringify(item, null, 2), 'utf8');
+  }
+  
+  console.log(`Generated ${items.length} component JSON files.`);
+  console.log('Registry creation complete!');
+}
+
+// Run the registry creation
+createRegistry();