@e-burgos/tucu-ui 1.1.1 → 2.0.0

package/ImageSection-KRwcaC7i.js

@@ -0,0 +1,80 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("react/jsx-runtime"),a=require("./index-CjRk4ezu.js");require("lucide-react");require("react-router-dom");require("react");require("react-dom");const i=()=>{const l=[{key:"prop",label:"Prop",render:s=>e.jsx("code",{className:"text-xs text-brand",children:String(s)})},{key:"type",label:"Type",render:s=>e.jsx("code",{className:"text-xs",children:String(s)})},{key:"default",label:"Default",render:s=>{const r=String(s);return r==="required"?e.jsx("span",{className:"text-xs text-red-500",children:"required"}):e.jsx("code",{className:"text-xs",children:r})}},{key:"description",label:"Description"}],t=[{prop:"src",type:"string",default:"required",description:"Image source URL"},{prop:"alt",type:"string",default:"required",description:"Alt text for accessibility"},{prop:"width",type:"number | string",default:"-",description:"Image width in pixels or percentage"},{prop:"height",type:"number | string",default:"-",description:"Image height in pixels or percentage"},{prop:"objectFit",type:"'cover' | 'contain' | 'fill' | 'none' | 'scale-down'",default:"'cover'",description:"How the image should fit its container"},{prop:"loading",type:"'lazy' | 'eager'",default:"'lazy'",description:"Browser native lazy loading"},{prop:"priority",type:"'high' | 'low' | 'auto'",default:"'auto'",description:"Fetch priority hint for browser"},{prop:"placeholder",type:"'blur' | 'empty'",default:"'empty'",description:"Placeholder type while loading"},{prop:"blurDataURL",type:"string",default:"-",description:"Base64 or URL for blur placeholder"},{prop:"fallbackSrc",type:"string",default:"placeholder image",description:"Image to show on error"},{prop:"aspectRatio",type:"string",default:"-",description:'CSS aspect-ratio (e.g., "16/9", "4/3")'},{prop:"fill",type:"boolean",default:"false",description:"Fill parent container (position: absolute)"},{prop:"onLoad",type:"() => void",default:"-",description:"Callback when image loads"},{prop:"onError",type:"() => void",default:"-",description:"Callback when image fails to load"},{prop:"className",type:"string",default:"-",description:"CSS classes for image element"},{prop:"containerClassName",type:"string",default:"-",description:"CSS classes for wrapper container"}];return e.jsxs(e.Fragment,{children:[e.jsxs("div",{className:"text-center space-y-4",children:[e.jsx(a.Typography,{tag:"h2",className:"text-3xl md:text-4xl font-bold",children:"Image"}),e.jsx(a.Typography,{tag:"p",className:"text-xl text-gray-600 dark:text-gray-400 max-w-2xl mx-auto",children:"A powerful image component inspired by Next.js Image, featuring lazy loading, blur placeholders, error handling, and automatic optimization."})]}),e.jsx(a.CardContainer,{className:"overflow-hidden",children:e.jsx(a.CardTitle,{title:"Basic Usage",className:"mt-2 mb-2",children:e.jsx("div",{className:"w-full p-4 sm:p-6",children:e.jsxs("div",{className:"grid grid-cols-1 md:grid-cols-2 gap-6",children:[e.jsxs("div",{children:[e.jsx(a.Typography,{tag:"h5",className:"mb-3",children:"Standard Image"}),e.jsx(a.Typography,{tag:"p",className:"text-sm text-gray-600 dark:text-gray-400 mb-3",children:"Basic usage with width and height."}),e.jsx(a.Image,{src:"https://images.unsplash.com/photo-1682687220742-aba13b6e50ba?w=400&h=300&fit=crop",alt:"Mountain landscape",width:400,height:300,className:"rounded-lg"})]}),e.jsxs("div",{children:[e.jsx(a.Typography,{tag:"h5",className:"mb-3",children:"With Lazy Loading"}),e.jsx(a.Typography,{tag:"p",className:"text-sm text-gray-600 dark:text-gray-400 mb-3",children:"Automatic lazy loading with smooth fade-in."}),e.jsx(a.Image,{src:"https://images.unsplash.com/photo-1506905925346-21bda4d32df4?w=400&h=300&fit=crop",alt:"Mountain peaks",width:400,height:300,loading:"lazy",className:"rounded-lg"})]})]})})})}),e.jsx(a.CardContainer,{className:"overflow-hidden",children:e.jsx(a.CardTitle,{title:"Object Fit Modes",className:"mt-2 mb-2",children:e.jsx("div",{className:"w-full p-4 sm:p-6",children:e.jsxs("div",{className:"grid grid-cols-1 md:grid-cols-3 gap-6",children:[e.jsxs("div",{children:[e.jsx(a.Typography,{tag:"h5",className:"mb-3",children:"Cover (Default)"}),e.jsx(a.Typography,{tag:"p",className:"text-sm text-gray-600 dark:text-gray-400 mb-3",children:"Fills container, may crop image."}),e.jsx(a.Image,{src:"https://images.unsplash.com/photo-1469474968028-56623f02e42e?w=300&h=200&fit=crop",alt:"Nature landscape cover",width:300,height:200,objectFit:"cover",className:"rounded-lg border-2 border-gray-200 dark:border-gray-700"})]}),e.jsxs("div",{children:[e.jsx(a.Typography,{tag:"h5",className:"mb-3",children:"Contain"}),e.jsx(a.Typography,{tag:"p",className:"text-sm text-gray-600 dark:text-gray-400 mb-3",children:"Fits entirely, may have empty space."}),e.jsx(a.Image,{src:"https://images.unsplash.com/photo-1469474968028-56623f02e42e?w=300&h=200&fit=crop",alt:"Nature landscape contain",width:300,height:200,objectFit:"contain",containerClassName:"bg-gray-100 dark:bg-gray-800",className:"rounded-lg"})]}),e.jsxs("div",{children:[e.jsx(a.Typography,{tag:"h5",className:"mb-3",children:"Fill"}),e.jsx(a.Typography,{tag:"p",className:"text-sm text-gray-600 dark:text-gray-400 mb-3",children:"Stretches to fill container."}),e.jsx(a.Image,{src:"https://images.unsplash.com/photo-1469474968028-56623f02e42e?w=300&h=200&fit=crop",alt:"Nature landscape fill",width:300,height:200,objectFit:"fill",className:"rounded-lg border-2 border-gray-200 dark:border-gray-700"})]})]})})})}),e.jsx(a.CardContainer,{className:"overflow-hidden",children:e.jsx(a.CardTitle,{title:"Aspect Ratios",className:"mt-2 mb-2",children:e.jsx("div",{className:"w-full p-4 sm:p-6",children:e.jsxs("div",{className:"grid grid-cols-1 md:grid-cols-3 gap-6",children:[e.jsxs("div",{children:[e.jsx(a.Typography,{tag:"h5",className:"mb-3",children:"16:9 (Video)"}),e.jsx(a.Image,{src:"https://images.unsplash.com/photo-1501594907352-04cda38ebc29?w=400&h=300&fit=crop",alt:"Beach sunset 16:9",aspectRatio:"16/9",fill:!0,containerClassName:"w-full rounded-lg"})]}),e.jsxs("div",{children:[e.jsx(a.Typography,{tag:"h5",className:"mb-3",children:"4:3 (Classic)"}),e.jsx(a.Image,{src:"https://images.unsplash.com/photo-1472214103451-9374bd1c798e?w=400&h=300&fit=crop",alt:"Forest path 4:3",aspectRatio:"4/3",fill:!0,containerClassName:"w-full rounded-lg"})]}),e.jsxs("div",{children:[e.jsx(a.Typography,{tag:"h5",className:"mb-3",children:"1:1 (Square)"}),e.jsx(a.Image,{src:"https://images.unsplash.com/photo-1511884642898-4c92249e20b6?w=300&h=300&fit=crop",alt:"City skyline 1:1",aspectRatio:"1/1",fill:!0,containerClassName:"w-full rounded-lg"})]})]})})})}),e.jsx(a.CardContainer,{className:"overflow-hidden",children:e.jsx(a.CardTitle,{title:"Placeholder Types",className:"mt-2 mb-2",children:e.jsx("div",{className:"w-full p-4 sm:p-6",children:e.jsxs("div",{className:"grid grid-cols-1 md:grid-cols-2 gap-6",children:[e.jsxs("div",{children:[e.jsx(a.Typography,{tag:"h5",className:"mb-3",children:"Blur Placeholder"}),e.jsx(a.Typography,{tag:"p",className:"text-sm text-gray-600 dark:text-gray-400 mb-3",children:"Shows animated blur effect while loading."}),e.jsx(a.Image,{src:"https://images.unsplash.com/photo-1682687220742-aba13b6e50ba?w=400&h=300&fit=crop",alt:"Mountain with blur placeholder",width:400,height:300,placeholder:"blur",className:"rounded-lg"})]}),e.jsxs("div",{children:[e.jsx(a.Typography,{tag:"h5",className:"mb-3",children:"Empty Placeholder"}),e.jsx(a.Typography,{tag:"p",className:"text-sm text-gray-600 dark:text-gray-400 mb-3",children:"Shows spinner while loading."}),e.jsx(a.Image,{src:"https://images.unsplash.com/photo-1506905925346-21bda4d32df4?w=400&h=300&fit=crop",alt:"Mountains with empty placeholder",width:400,height:300,placeholder:"empty",className:"rounded-lg"})]})]})})})}),e.jsx(a.CardContainer,{className:"overflow-hidden",children:e.jsx(a.CardTitle,{title:"Error Handling",className:"mt-2 mb-2",children:e.jsx("div",{className:"w-full p-4 sm:p-6",children:e.jsxs("div",{className:"grid grid-cols-1 md:grid-cols-2 gap-6",children:[e.jsxs("div",{children:[e.jsx(a.Typography,{tag:"h5",className:"mb-3",children:"Invalid Image (Fallback)"}),e.jsx(a.Typography,{tag:"p",className:"text-sm text-gray-600 dark:text-gray-400 mb-3",children:"Automatically shows fallback on error."}),e.jsx(a.Image,{src:"https://invalid-url-that-will-fail.com/image.jpg",alt:"Image with fallback",width:400,height:300,className:"rounded-lg"})]}),e.jsxs("div",{children:[e.jsx(a.Typography,{tag:"h5",className:"mb-3",children:"Custom Fallback"}),e.jsx(a.Typography,{tag:"p",className:"text-sm text-gray-600 dark:text-gray-400 mb-3",children:"Provide your own fallback image."}),e.jsx(a.Image,{src:"https://invalid-url.com/image.jpg",alt:"Custom fallback",width:400,height:300,fallbackSrc:"https://images.unsplash.com/photo-1506905925346-21bda4d32df4?w=400&h=300&fit=crop",className:"rounded-lg"})]})]})})})}),e.jsx(a.CardContainer,{className:"overflow-hidden",children:e.jsx(a.CardTitle,{title:"Responsive Images",className:"mt-2 mb-2",children:e.jsx("div",{className:"w-full p-4 sm:p-6",children:e.jsxs("div",{className:"space-y-6",children:[e.jsxs("div",{children:[e.jsx(a.Typography,{tag:"h5",className:"mb-3",children:"Full Width Responsive"}),e.jsx(a.Typography,{tag:"p",className:"text-sm text-gray-600 dark:text-gray-400 mb-3",children:"Image fills container width with maintained aspect ratio."}),e.jsx(a.Image,{src:"https://images.unsplash.com/photo-1506905925346-21bda4d32df4?w=800&h=400&fit=crop",alt:"Responsive landscape",aspectRatio:"21/9",fill:!0,containerClassName:"w-full rounded-lg"})]}),e.jsxs("div",{children:[e.jsx(a.Typography,{tag:"h5",className:"mb-3",children:"Grid Responsive Images"}),e.jsx("div",{className:"grid grid-cols-2 md:grid-cols-4 gap-4",children:["photo-1682687220742-aba13b6e50ba","photo-1506905925346-21bda4d32df4","photo-1501594907352-04cda38ebc29","photo-1472214103451-9374bd1c798e"].map((s,r)=>e.jsx(a.Image,{src:`https://images.unsplash.com/${s}?w=300&h=300&fit=crop`,alt:`Gallery image ${r+1}`,aspectRatio:"1/1",fill:!0,containerClassName:"w-full rounded-lg"},s))})]})]})})})}),e.jsx(a.CardContainer,{className:"overflow-hidden",children:e.jsx(a.CardTitle,{title:"Key Features",className:"mt-2 mb-2",children:e.jsx("div",{className:"w-full p-4 sm:p-6",children:e.jsxs("div",{className:"grid grid-cols-1 md:grid-cols-2 gap-4",children:[e.jsxs(a.CardContainer,{className:"p-4",children:[e.jsxs(a.Typography,{tag:"h5",className:"mb-2",children:[e.jsx("span",{role:"img","aria-label":"rocket",children:"🚀"})," ","Lazy Loading"]}),e.jsx(a.Typography,{tag:"p",className:"text-sm text-gray-600 dark:text-gray-400",children:"Native browser lazy loading for better performance and faster page loads."})]}),e.jsxs(a.CardContainer,{className:"p-4",children:[e.jsxs(a.Typography,{tag:"h5",className:"mb-2",children:[e.jsx("span",{role:"img","aria-label":"sparkles",children:"✨"})," ","Smooth Transitions"]}),e.jsx(a.Typography,{tag:"p",className:"text-sm text-gray-600 dark:text-gray-400",children:"Beautiful fade-in animations and blur effects for a polished loading experience."})]}),e.jsxs(a.CardContainer,{className:"p-4",children:[e.jsxs(a.Typography,{tag:"h5",className:"mb-2",children:[e.jsx("span",{role:"img","aria-label":"shield",children:"🛡️"})," ","Error Handling"]}),e.jsx(a.Typography,{tag:"p",className:"text-sm text-gray-600 dark:text-gray-400",children:"Automatic fallback images and error states with user-friendly messaging."})]}),e.jsxs(a.CardContainer,{className:"p-4",children:[e.jsxs(a.Typography,{tag:"h5",className:"mb-2",children:[e.jsx("span",{role:"img","aria-label":"art",children:"🎨"})," ","Aspect Ratios"]}),e.jsx(a.Typography,{tag:"p",className:"text-sm text-gray-600 dark:text-gray-400",children:"CSS aspect-ratio support for consistent layouts without layout shift."})]}),e.jsxs(a.CardContainer,{className:"p-4",children:[e.jsxs(a.Typography,{tag:"h5",className:"mb-2",children:[e.jsx("span",{role:"img","aria-label":"mobile",children:"📱"})," ","Responsive"]}),e.jsx(a.Typography,{tag:"p",className:"text-sm text-gray-600 dark:text-gray-400",children:"Fully responsive with flexible sizing options and fill mode support."})]}),e.jsxs(a.CardContainer,{className:"p-4",children:[e.jsxs(a.Typography,{tag:"h5",className:"mb-2",children:[e.jsx("span",{role:"img","aria-label":"accessibility",children:"♿"})," ","Accessible"]}),e.jsx(a.Typography,{tag:"p",className:"text-sm text-gray-600 dark:text-gray-400",children:"Required alt text and proper ARIA labels for screen readers."})]})]})})})}),e.jsx(a.CardContainer,{className:"overflow-hidden",children:e.jsx(a.CardTitle,{title:"Props",className:"mt-2 mb-2",children:e.jsx("div",{className:"w-full p-4 sm:p-6",children:e.jsx(a.BasicTable,{columns:l,data:t})})})}),e.jsx(a.CardContainer,{className:"overflow-hidden",children:e.jsx(a.CardTitle,{title:"Code Examples",className:"mt-2 mb-2",children:e.jsx("div",{className:"w-full p-4 sm:p-6",children:e.jsx(a.CodeBlock,{language:"tsx",code:`import { Image } from '@e-burgos/tucu-ui';
+
+// Basic usage
+<Image
+  src="/path/to/image.jpg"
+  alt="Description"
+  width={400}
+  height={300}
+/>
+
+// With lazy loading and blur placeholder
+<Image
+  src="/landscape.jpg"
+  alt="Mountain landscape"
+  width={800}
+  height={600}
+  loading="lazy"
+  placeholder="blur"
+  className="rounded-lg"
+/>
+
+// Responsive with aspect ratio
+<Image
+  src="/hero.jpg"
+  alt="Hero image"
+  aspectRatio="16/9"
+  fill
+  containerClassName="w-full rounded-xl"
+/>
+
+// Different object-fit modes
+<Image src={src} alt="Cover" objectFit="cover" />
+<Image src={src} alt="Contain" objectFit="contain" />
+<Image src={src} alt="Fill" objectFit="fill" />
+
+// With error handling
+<Image
+  src="/image.jpg"
+  alt="Image with fallback"
+  width={400}
+  height={300}
+  fallbackSrc="/fallback.jpg"
+  onError={() => console.log('Failed to load')}
+  onLoad={() => console.log('Loaded successfully')}
+/>
+
+// Fill parent container (like Next.js)
+<div className="relative w-full h-64">
+  <Image
+    src="/banner.jpg"
+    alt="Banner"
+    fill
+    objectFit="cover"
+  />
+</div>
+
+// With priority loading (above the fold)
+<Image
+  src="/hero.jpg"
+  alt="Hero"
+  width={1200}
+  height={600}
+  loading="eager"
+  priority="high"
+  placeholder="blur"
+/>
+
+// Grid of images
+<div className="grid grid-cols-3 gap-4">
+  {images.map((img) => (
+    <Image
+      key={img.id}
+      src={img.url}
+      alt={img.alt}
+      aspectRatio="1/1"
+      fill
+      containerClassName="w-full rounded-lg"
+    />
+  ))}
+</div>`})})})})]})};exports.default=i;

package/ImplementationExamplesSection-B0Iyb8pc.mjs

@@ -0,0 +1,284 @@
+import { jsx as e, Fragment as n, jsxs as t } from "react/jsx-runtime";
+import { C as r, a as i, T as o, c as a } from "./index-Hq6IUBmn.mjs";
+import { Code as s } from "lucide-react";
+import "react-router-dom";
+import "react";
+import "react-dom";
+const h = () => /* @__PURE__ */ e(n, { children: /* @__PURE__ */ e(r, { className: "overflow-hidden", children: /* @__PURE__ */ e(i, { title: "Implementation Examples", className: "mt-2 mb-2", children: /* @__PURE__ */ t("div", { className: "w-full space-y-8 p-4 sm:p-6", children: [
+  /* @__PURE__ */ t("div", { className: "flex items-center gap-3", children: [
+    /* @__PURE__ */ e("div", { className: "p-2 rounded-lg bg-gradient-to-br from-indigo-500 via-purple-500 to-violet-500 shadow-md", children: /* @__PURE__ */ e(s, { className: "w-6 h-6 text-white filter drop-shadow-sm" }) }),
+    /* @__PURE__ */ e(o, { tag: "h3", className: "text-xl font-semibold", children: "Basic Usage" })
+  ] }),
+  /* @__PURE__ */ t("div", { className: "space-y-6", children: [
+    /* @__PURE__ */ t("div", { className: "space-y-3", children: [
+      /* @__PURE__ */ e(o, { tag: "h4", className: "font-semibold", children: "1. Automatic Routing with menuItems" }),
+      /* @__PURE__ */ t(
+        o,
+        {
+          tag: "p",
+          className: "text-sm text-gray-600 dark:text-gray-400",
+          children: [
+            "ThemeProvider automatically generates routes from menuItems. Each menu item with a ",
+            /* @__PURE__ */ e("code", { children: "component" }),
+            " prop becomes a route."
+          ]
+        }
+      ),
+      /* @__PURE__ */ e(
+        a,
+        {
+          language: "tsx",
+          code: `import { ThemeProvider, LAYOUT_OPTIONS, LucideIcons } from '@ui/tucu-ui';
+import { Dashboard } from './pages/Dashboard';
+import { Settings } from './pages/Settings';
+import { Profile } from './pages/Profile';
+
+// Menu items with components - routes are generated automatically
+// Note: Use 'path' for internal routing, 'href' for external links
+const menuItems = [
+  {
+    name: 'Dashboard',
+    path: '/', // Internal route path
+    icon: <LucideIcons.Home />,
+    component: <Dashboard />, // This becomes a route
+  },
+  {
+    name: 'Settings',
+    path: '/settings', // Internal route path
+    icon: <LucideIcons.Settings />,
+    component: <Settings />, // This becomes a route
+  },
+  {
+    name: 'Profile',
+    path: '/profile', // Internal route path
+    icon: <LucideIcons.User />,
+    component: <Profile />, // This becomes a route
+  },
+];
+
+function App() {
+  return (
+    <ThemeProvider
+      menuItems={menuItems}
+      layout={LAYOUT_OPTIONS.ADMIN}
+      logo={{ path: '/', name: 'My App' }}
+    />
+    {/* No children needed - routing is handled automatically */}
+  );
+}
+
+// Routes are automatically created:
+// / -> Dashboard component
+// /settings -> Settings component
+// /profile -> Profile component`
+        }
+      )
+    ] }),
+    /* @__PURE__ */ t("div", { className: "space-y-3", children: [
+      /* @__PURE__ */ e(o, { tag: "h4", className: "font-semibold", children: "2. Landing Page (No Routing)" }),
+      /* @__PURE__ */ t(
+        o,
+        {
+          tag: "p",
+          className: "text-sm text-gray-600 dark:text-gray-400",
+          children: [
+            "For landing pages or single-page applications without routing, use ",
+            /* @__PURE__ */ e("code", { children: "customRoutes" }),
+            " with a single route."
+          ]
+        }
+      ),
+      /* @__PURE__ */ e(
+        a,
+        {
+          language: "tsx",
+          code: `import { ThemeProvider, LAYOUT_OPTIONS, Routes, Route } from '@ui/tucu-ui';
+import { LandingPage } from './pages/LandingPage';
+
+function App() {
+  return (
+    <ThemeProvider
+      menuItems={[]} // Empty - no navigation needed for landing page
+      layout={LAYOUT_OPTIONS.CLEAN} // Clean layout for landing pages
+      logo={{ path: '/', name: 'My Brand' }}
+      customRoutes={
+        <Routes>
+          <Route path="*" element={<LandingPage />} />
+        </Routes>
+      }
+    />
+  );
+}
+
+// The customRoutes prop overrides automatic routing
+// BrowserRouter is already included in ThemeProvider
+// No need to import or wrap with BrowserRouter`
+        }
+      )
+    ] }),
+    /* @__PURE__ */ t("div", { className: "space-y-3", children: [
+      /* @__PURE__ */ e(o, { tag: "h4", className: "font-semibold", children: "3. Custom Routing with customRoutes" }),
+      /* @__PURE__ */ t(
+        o,
+        {
+          tag: "p",
+          className: "text-sm text-gray-600 dark:text-gray-400",
+          children: [
+            "For complex routing scenarios, provide your own",
+            " ",
+            /* @__PURE__ */ e("code", { children: "<Routes>" }),
+            " component via",
+            " ",
+            /* @__PURE__ */ e("code", { children: "customRoutes" }),
+            " prop."
+          ]
+        }
+      ),
+      /* @__PURE__ */ e(
+        a,
+        {
+          language: "tsx",
+          code: `import { ThemeProvider, LAYOUT_OPTIONS, Routes, Route } from '@ui/tucu-ui';
+import { BrowserRouter } from 'react-router-dom'; // Already included in ThemeProvider
+import { Home } from './pages/Home';
+import { About } from './pages/About';
+import { Contact } from './pages/Contact';
+import { NotFound } from './pages/NotFound';
+
+function App() {
+  // Menu items for navigation (optional - can be empty if using customRoutes)
+  // Note: 'path' is used for internal routing, 'href' would be for external links
+  const menuItems = [
+    {
+      name: 'Home',
+      path: '/', // Internal route path
+      icon: <LucideIcons.Home />,
+    },
+    {
+      name: 'About',
+      path: '/about', // Internal route path
+      icon: <LucideIcons.Info />,
+    },
+    {
+      name: 'Contact',
+      path: '/contact', // Internal route path
+      icon: <LucideIcons.Mail />,
+    },
+  ];
+
+  return (
+    <ThemeProvider
+      menuItems={menuItems} // For navigation menu
+      layout={LAYOUT_OPTIONS.HORIZONTAL}
+      logo={{ path: '/', name: 'My App' }}
+      customRoutes={
+        <Routes>
+          <Route path="/" element={<Home />} />
+          <Route path="/about" element={<About />} />
+          <Route path="/contact" element={<Contact />} />
+          <Route path="*" element={<NotFound />} />
+        </Routes>
+      }
+    />
+  );
+}
+
+// Note: BrowserRouter is already included in ThemeProvider,
+// so you don't need to wrap it again`
+        }
+      )
+    ] }),
+    /* @__PURE__ */ t("div", { className: "space-y-3", children: [
+      /* @__PURE__ */ e(o, { tag: "h4", className: "font-semibold", children: "4. Using Theme Hooks" }),
+      /* @__PURE__ */ e(
+        a,
+        {
+          language: "tsx",
+          code: `import { useTheme, LAYOUT_OPTIONS } from '@ui/tucu-ui';
+
+function ThemeControls() {
+  const { 
+    mode, 
+    setMode, 
+    layout, 
+    setLayout,
+    primaryPreset,
+    setPrimaryPreset 
+  } = useTheme();
+  
+  return (
+    <div className="space-y-4">
+      <button 
+        onClick={() => setMode(mode === 'light' ? 'dark' : 'light')}
+      >
+        Toggle Theme: {mode}
+      </button>
+      
+      <select 
+        value={layout} 
+        onChange={(e) => setLayout(e.target.value as any)}
+      >
+        <option value={LAYOUT_OPTIONS.CLEAN}>Clean</option>
+        <option value={LAYOUT_OPTIONS.ADMIN}>Admin</option>
+        <option value={LAYOUT_OPTIONS.HORIZONTAL}>Horizontal</option>
+      </select>
+      
+      <div>
+        Current Primary Color: {primaryPreset?.label}
+      </div>
+    </div>
+  );
+}
+
+// Usage with ThemeProvider
+function App() {
+  const menuItems = [
+    { 
+      name: 'Theme Controls', 
+      href: '/theme-controls',
+      component: <ThemeControls />
+    }
+  ];
+
+  return <ThemeProvider menuItems={menuItems} />;
+}`
+        }
+      )
+    ] }),
+    /* @__PURE__ */ t("div", { className: "space-y-3", children: [
+      /* @__PURE__ */ e(o, { tag: "h4", className: "font-semibold", children: "5. Layout-Specific Configuration" }),
+      /* @__PURE__ */ e(
+        a,
+        {
+          language: "tsx",
+          code: `import { ThemeProvider, LAYOUT_OPTIONS } from '@ui/tucu-ui';
+
+function App() {
+  const menuItems = [
+    { name: 'Home', href: '/', icon: <LucideIcons.Home /> },
+    { name: 'About', href: '/about', icon: <LucideIcons.Info /> },
+  ];
+
+  return (
+    <ThemeProvider
+      menuItems={menuItems}
+      layout={LAYOUT_OPTIONS.ADMIN}
+      logo={{ path: '/', name: 'My App' }}
+      rightButton={<SettingsButton />}
+      fullWidth={false} // Set to true for full-width content
+      className="custom-layout-class"
+      headerClassName="custom-header-class"
+      contentClassName="custom-content-class"
+    >
+      <YourAppContent />
+    </ThemeProvider>
+  );
+}`
+        }
+      )
+    ] })
+  ] })
+] }) }) }) });
+export {
+  h as default
+};

package/ImplementationExamplesSection-D3GzoJHk.js

@@ -0,0 +1,178 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("react/jsx-runtime"),o=require("./index-CjRk4ezu.js"),t=require("lucide-react");require("react-router-dom");require("react");require("react-dom");const a=()=>e.jsx(e.Fragment,{children:e.jsx(o.CardContainer,{className:"overflow-hidden",children:e.jsx(o.CardTitle,{title:"Implementation Examples",className:"mt-2 mb-2",children:e.jsxs("div",{className:"w-full space-y-8 p-4 sm:p-6",children:[e.jsxs("div",{className:"flex items-center gap-3",children:[e.jsx("div",{className:"p-2 rounded-lg bg-gradient-to-br from-indigo-500 via-purple-500 to-violet-500 shadow-md",children:e.jsx(t.Code,{className:"w-6 h-6 text-white filter drop-shadow-sm"})}),e.jsx(o.Typography,{tag:"h3",className:"text-xl font-semibold",children:"Basic Usage"})]}),e.jsxs("div",{className:"space-y-6",children:[e.jsxs("div",{className:"space-y-3",children:[e.jsx(o.Typography,{tag:"h4",className:"font-semibold",children:"1. Automatic Routing with menuItems"}),e.jsxs(o.Typography,{tag:"p",className:"text-sm text-gray-600 dark:text-gray-400",children:["ThemeProvider automatically generates routes from menuItems. Each menu item with a ",e.jsx("code",{children:"component"})," prop becomes a route."]}),e.jsx(o.CodeBlock,{language:"tsx",code:`import { ThemeProvider, LAYOUT_OPTIONS, LucideIcons } from '@ui/tucu-ui';
+import { Dashboard } from './pages/Dashboard';
+import { Settings } from './pages/Settings';
+import { Profile } from './pages/Profile';
+
+// Menu items with components - routes are generated automatically
+// Note: Use 'path' for internal routing, 'href' for external links
+const menuItems = [
+  {
+    name: 'Dashboard',
+    path: '/', // Internal route path
+    icon: <LucideIcons.Home />,
+    component: <Dashboard />, // This becomes a route
+  },
+  {
+    name: 'Settings',
+    path: '/settings', // Internal route path
+    icon: <LucideIcons.Settings />,
+    component: <Settings />, // This becomes a route
+  },
+  {
+    name: 'Profile',
+    path: '/profile', // Internal route path
+    icon: <LucideIcons.User />,
+    component: <Profile />, // This becomes a route
+  },
+];
+
+function App() {
+  return (
+    <ThemeProvider
+      menuItems={menuItems}
+      layout={LAYOUT_OPTIONS.ADMIN}
+      logo={{ path: '/', name: 'My App' }}
+    />
+    {/* No children needed - routing is handled automatically */}
+  );
+}
+
+// Routes are automatically created:
+// / -> Dashboard component
+// /settings -> Settings component
+// /profile -> Profile component`})]}),e.jsxs("div",{className:"space-y-3",children:[e.jsx(o.Typography,{tag:"h4",className:"font-semibold",children:"2. Landing Page (No Routing)"}),e.jsxs(o.Typography,{tag:"p",className:"text-sm text-gray-600 dark:text-gray-400",children:["For landing pages or single-page applications without routing, use ",e.jsx("code",{children:"customRoutes"})," with a single route."]}),e.jsx(o.CodeBlock,{language:"tsx",code:`import { ThemeProvider, LAYOUT_OPTIONS, Routes, Route } from '@ui/tucu-ui';
+import { LandingPage } from './pages/LandingPage';
+
+function App() {
+  return (
+    <ThemeProvider
+      menuItems={[]} // Empty - no navigation needed for landing page
+      layout={LAYOUT_OPTIONS.CLEAN} // Clean layout for landing pages
+      logo={{ path: '/', name: 'My Brand' }}
+      customRoutes={
+        <Routes>
+          <Route path="*" element={<LandingPage />} />
+        </Routes>
+      }
+    />
+  );
+}
+
+// The customRoutes prop overrides automatic routing
+// BrowserRouter is already included in ThemeProvider
+// No need to import or wrap with BrowserRouter`})]}),e.jsxs("div",{className:"space-y-3",children:[e.jsx(o.Typography,{tag:"h4",className:"font-semibold",children:"3. Custom Routing with customRoutes"}),e.jsxs(o.Typography,{tag:"p",className:"text-sm text-gray-600 dark:text-gray-400",children:["For complex routing scenarios, provide your own"," ",e.jsx("code",{children:"<Routes>"})," component via"," ",e.jsx("code",{children:"customRoutes"})," prop."]}),e.jsx(o.CodeBlock,{language:"tsx",code:`import { ThemeProvider, LAYOUT_OPTIONS, Routes, Route } from '@ui/tucu-ui';
+import { BrowserRouter } from 'react-router-dom'; // Already included in ThemeProvider
+import { Home } from './pages/Home';
+import { About } from './pages/About';
+import { Contact } from './pages/Contact';
+import { NotFound } from './pages/NotFound';
+
+function App() {
+  // Menu items for navigation (optional - can be empty if using customRoutes)
+  // Note: 'path' is used for internal routing, 'href' would be for external links
+  const menuItems = [
+    {
+      name: 'Home',
+      path: '/', // Internal route path
+      icon: <LucideIcons.Home />,
+    },
+    {
+      name: 'About',
+      path: '/about', // Internal route path
+      icon: <LucideIcons.Info />,
+    },
+    {
+      name: 'Contact',
+      path: '/contact', // Internal route path
+      icon: <LucideIcons.Mail />,
+    },
+  ];
+
+  return (
+    <ThemeProvider
+      menuItems={menuItems} // For navigation menu
+      layout={LAYOUT_OPTIONS.HORIZONTAL}
+      logo={{ path: '/', name: 'My App' }}
+      customRoutes={
+        <Routes>
+          <Route path="/" element={<Home />} />
+          <Route path="/about" element={<About />} />
+          <Route path="/contact" element={<Contact />} />
+          <Route path="*" element={<NotFound />} />
+        </Routes>
+      }
+    />
+  );
+}
+
+// Note: BrowserRouter is already included in ThemeProvider,
+// so you don't need to wrap it again`})]}),e.jsxs("div",{className:"space-y-3",children:[e.jsx(o.Typography,{tag:"h4",className:"font-semibold",children:"4. Using Theme Hooks"}),e.jsx(o.CodeBlock,{language:"tsx",code:`import { useTheme, LAYOUT_OPTIONS } from '@ui/tucu-ui';
+
+function ThemeControls() {
+  const { 
+    mode, 
+    setMode, 
+    layout, 
+    setLayout,
+    primaryPreset,
+    setPrimaryPreset 
+  } = useTheme();
+  
+  return (
+    <div className="space-y-4">
+      <button 
+        onClick={() => setMode(mode === 'light' ? 'dark' : 'light')}
+      >
+        Toggle Theme: {mode}
+      </button>
+      
+      <select 
+        value={layout} 
+        onChange={(e) => setLayout(e.target.value as any)}
+      >
+        <option value={LAYOUT_OPTIONS.CLEAN}>Clean</option>
+        <option value={LAYOUT_OPTIONS.ADMIN}>Admin</option>
+        <option value={LAYOUT_OPTIONS.HORIZONTAL}>Horizontal</option>
+      </select>
+      
+      <div>
+        Current Primary Color: {primaryPreset?.label}
+      </div>
+    </div>
+  );
+}
+
+// Usage with ThemeProvider
+function App() {
+  const menuItems = [
+    { 
+      name: 'Theme Controls', 
+      href: '/theme-controls',
+      component: <ThemeControls />
+    }
+  ];
+
+  return <ThemeProvider menuItems={menuItems} />;
+}`})]}),e.jsxs("div",{className:"space-y-3",children:[e.jsx(o.Typography,{tag:"h4",className:"font-semibold",children:"5. Layout-Specific Configuration"}),e.jsx(o.CodeBlock,{language:"tsx",code:`import { ThemeProvider, LAYOUT_OPTIONS } from '@ui/tucu-ui';
+
+function App() {
+  const menuItems = [
+    { name: 'Home', href: '/', icon: <LucideIcons.Home /> },
+    { name: 'About', href: '/about', icon: <LucideIcons.Info /> },
+  ];
+
+  return (
+    <ThemeProvider
+      menuItems={menuItems}
+      layout={LAYOUT_OPTIONS.ADMIN}
+      logo={{ path: '/', name: 'My App' }}
+      rightButton={<SettingsButton />}
+      fullWidth={false} // Set to true for full-width content
+      className="custom-layout-class"
+      headerClassName="custom-header-class"
+      contentClassName="custom-content-class"
+    >
+      <YourAppContent />
+    </ThemeProvider>
+  );
+}`})]})]})]})})})});exports.default=a;

package/ImplementationGuidelinesSection-B986S98s.mjs

@@ -0,0 +1,52 @@
+import { jsxs as i, Fragment as a, jsx as e } from "react/jsx-runtime";
+import { T as s, C as l, a as t } from "./index-Hq6IUBmn.mjs";
+import { CheckCircle as r, XCircle as n } from "lucide-react";
+import "react-router-dom";
+import "react";
+import "react-dom";
+const g = () => /* @__PURE__ */ i(a, { children: [
+  /* @__PURE__ */ i("div", { className: "text-center space-y-4", children: [
+    /* @__PURE__ */ e(s, { tag: "h2", className: "text-3xl md:text-4xl font-bold", children: "Implementation Guidelines" }),
+    /* @__PURE__ */ e(
+      s,
+      {
+        tag: "p",
+        className: "text-xl text-gray-600 dark:text-gray-400 max-w-2xl mx-auto",
+        children: "Best practices and common pitfalls when implementing the design system"
+      }
+    )
+  ] }),
+  /* @__PURE__ */ i("div", { className: "grid grid-cols-1 md:grid-cols-2 gap-4 sm:gap-6", children: [
+    /* @__PURE__ */ e(l, { className: "group hover:shadow-large transition-all duration-300 hover:-translate-y-1", children: /* @__PURE__ */ e(t, { title: "Best Practices", className: "mt-2 mb-2", children: /* @__PURE__ */ i("div", { className: "w-full space-y-4 p-4 sm:p-6", children: [
+      /* @__PURE__ */ i("div", { className: "flex items-center gap-3", children: [
+        /* @__PURE__ */ e("div", { className: "p-1.5 rounded-lg bg-linear-to-br from-green-500 via-emerald-500 to-teal-500 shadow-sm", children: /* @__PURE__ */ e(r, { className: "h-5 w-5 text-white filter drop-shadow-sm" }) }),
+        /* @__PURE__ */ e(s, { tag: "h4", className: "font-semibold text-green-700", children: "Best Practices" })
+      ] }),
+      /* @__PURE__ */ i("ul", { className: "space-y-2 text-sm", children: [
+        /* @__PURE__ */ e("li", { children: "• Use semantic HTML elements" }),
+        /* @__PURE__ */ e("li", { children: "• Follow consistent naming conventions" }),
+        /* @__PURE__ */ e("li", { children: "• Implement proper ARIA attributes" }),
+        /* @__PURE__ */ e("li", { children: "• Test across different devices" }),
+        /* @__PURE__ */ e("li", { children: "• Optimize for performance" }),
+        /* @__PURE__ */ e("li", { children: "• Document component usage" })
+      ] })
+    ] }) }) }),
+    /* @__PURE__ */ e(l, { className: "group hover:shadow-large transition-all duration-300 hover:-translate-y-1", children: /* @__PURE__ */ e(t, { title: "Common Pitfalls", className: "mt-2 mb-2", children: /* @__PURE__ */ i("div", { className: "w-full space-y-4 p-4 sm:p-6", children: [
+      /* @__PURE__ */ i("div", { className: "flex items-center gap-3", children: [
+        /* @__PURE__ */ e("div", { className: "p-1.5 rounded-lg bg-linear-to-br from-red-500 via-rose-500 to-pink-500 shadow-sm", children: /* @__PURE__ */ e(n, { className: "h-5 w-5 text-white filter drop-shadow-sm" }) }),
+        /* @__PURE__ */ e(s, { tag: "h4", className: "font-semibold text-red-700", children: "Common Pitfalls" })
+      ] }),
+      /* @__PURE__ */ i("ul", { className: "space-y-2 text-sm", children: [
+        /* @__PURE__ */ e("li", { children: "• Inconsistent spacing usage" }),
+        /* @__PURE__ */ e("li", { children: "• Mixing different color systems" }),
+        /* @__PURE__ */ e("li", { children: "• Ignoring responsive design" }),
+        /* @__PURE__ */ e("li", { children: "• Overriding component styles" }),
+        /* @__PURE__ */ e("li", { children: "• Missing accessibility features" }),
+        /* @__PURE__ */ e("li", { children: "• Not following design tokens" })
+      ] })
+    ] }) }) })
+  ] })
+] });
+export {
+  g as default
+};

package/ImplementationGuidelinesSection-Di6FUATm.js

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("react/jsx-runtime"),s=require("./index-CjRk4ezu.js"),i=require("lucide-react");require("react-router-dom");require("react");require("react-dom");const l=()=>e.jsxs(e.Fragment,{children:[e.jsxs("div",{className:"text-center space-y-4",children:[e.jsx(s.Typography,{tag:"h2",className:"text-3xl md:text-4xl font-bold",children:"Implementation Guidelines"}),e.jsx(s.Typography,{tag:"p",className:"text-xl text-gray-600 dark:text-gray-400 max-w-2xl mx-auto",children:"Best practices and common pitfalls when implementing the design system"})]}),e.jsxs("div",{className:"grid grid-cols-1 md:grid-cols-2 gap-4 sm:gap-6",children:[e.jsx(s.CardContainer,{className:"group hover:shadow-large transition-all duration-300 hover:-translate-y-1",children:e.jsx(s.CardTitle,{title:"Best Practices",className:"mt-2 mb-2",children:e.jsxs("div",{className:"w-full space-y-4 p-4 sm:p-6",children:[e.jsxs("div",{className:"flex items-center gap-3",children:[e.jsx("div",{className:"p-1.5 rounded-lg bg-linear-to-br from-green-500 via-emerald-500 to-teal-500 shadow-sm",children:e.jsx(i.CheckCircle,{className:"h-5 w-5 text-white filter drop-shadow-sm"})}),e.jsx(s.Typography,{tag:"h4",className:"font-semibold text-green-700",children:"Best Practices"})]}),e.jsxs("ul",{className:"space-y-2 text-sm",children:[e.jsx("li",{children:"• Use semantic HTML elements"}),e.jsx("li",{children:"• Follow consistent naming conventions"}),e.jsx("li",{children:"• Implement proper ARIA attributes"}),e.jsx("li",{children:"• Test across different devices"}),e.jsx("li",{children:"• Optimize for performance"}),e.jsx("li",{children:"• Document component usage"})]})]})})}),e.jsx(s.CardContainer,{className:"group hover:shadow-large transition-all duration-300 hover:-translate-y-1",children:e.jsx(s.CardTitle,{title:"Common Pitfalls",className:"mt-2 mb-2",children:e.jsxs("div",{className:"w-full space-y-4 p-4 sm:p-6",children:[e.jsxs("div",{className:"flex items-center gap-3",children:[e.jsx("div",{className:"p-1.5 rounded-lg bg-linear-to-br from-red-500 via-rose-500 to-pink-500 shadow-sm",children:e.jsx(i.XCircle,{className:"h-5 w-5 text-white filter drop-shadow-sm"})}),e.jsx(s.Typography,{tag:"h4",className:"font-semibold text-red-700",children:"Common Pitfalls"})]}),e.jsxs("ul",{className:"space-y-2 text-sm",children:[e.jsx("li",{children:"• Inconsistent spacing usage"}),e.jsx("li",{children:"• Mixing different color systems"}),e.jsx("li",{children:"• Ignoring responsive design"}),e.jsx("li",{children:"• Overriding component styles"}),e.jsx("li",{children:"• Missing accessibility features"}),e.jsx("li",{children:"• Not following design tokens"})]})]})})})]})]});exports.default=l;

package/ImplementationStatusSection-CqAnYtcw.js

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("react/jsx-runtime"),t=require("./index-CjRk4ezu.js"),i=require("lucide-react");require("react-router-dom");require("react");require("react-dom");const s=()=>e.jsx("div",{className:"space-y-8",children:e.jsx(t.Alert,{variant:"warning","aria-label":"Accessibility Implementation Status",children:e.jsxs("div",{className:"flex flex-col gap-2",children:[e.jsxs("div",{className:"flex items-center gap-2",children:[e.jsx(i.AlertTriangle,{className:"h-6 w-6"}),e.jsx(t.Typography,{tag:"span",className:"font-semibold",children:"Accessibility Implementation Status"})]}),e.jsx(t.Typography,{tag:"p",className:"text-sm",children:"This library is actively working towards full accessibility compliance. We're transparent about our current state and committed to continuous improvement."})]})})});exports.default=s;

package/ImplementationStatusSection-zClYTFYV.mjs

@@ -0,0 +1,23 @@
+import { jsx as t, jsxs as e } from "react/jsx-runtime";
+import { a4 as i, T as a } from "./index-Hq6IUBmn.mjs";
+import { AlertTriangle as s } from "lucide-react";
+import "react-router-dom";
+import "react";
+import "react-dom";
+const p = () => /* @__PURE__ */ t("div", { className: "space-y-8", children: /* @__PURE__ */ t(
+  i,
+  {
+    variant: "warning",
+    "aria-label": "Accessibility Implementation Status",
+    children: /* @__PURE__ */ e("div", { className: "flex flex-col gap-2", children: [
+      /* @__PURE__ */ e("div", { className: "flex items-center gap-2", children: [
+        /* @__PURE__ */ t(s, { className: "h-6 w-6" }),
+        /* @__PURE__ */ t(a, { tag: "span", className: "font-semibold", children: "Accessibility Implementation Status" })
+      ] }),
+      /* @__PURE__ */ t(a, { tag: "p", className: "text-sm", children: "This library is actively working towards full accessibility compliance. We're transparent about our current state and committed to continuous improvement." })
+    ] })
+  }
+) });
+export {
+  p as default
+};