@e-burgos/tucu-ui 2.4.1 → 2.6.0

package/documentation/MenuItemsGuideSection-CbvbuCdn.js

@@ -0,0 +1,126 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("react/jsx-runtime"),t=require("../index-DWDUS-PU.js"),o=require("lucide-react");require("react-router-dom");require("react");require("react-dom");const a=()=>{const s=[{key:"property",label:"Property"},{key:"type",label:"Type"},{key:"required",label:"Required"},{key:"description",label:"Description"}],r=[{property:"name",type:"string",required:"Yes",description:"Display name of the menu item"},{property:"path",type:"string",required:"Yes",description:e.jsxs(e.Fragment,{children:[e.jsx("strong",{children:"Internal route path"})," for React Router navigation (e.g., ",e.jsx("code",{children:"/dashboard"}),"). Used for routing and active state detection."]})},{property:"href",type:"string?",required:"No",description:e.jsxs(e.Fragment,{children:[e.jsx("strong",{children:"External URL"})," for redirection (e.g.,"," ",e.jsx("code",{children:"https://example.com"}),"). If provided, clicking will redirect to this URL instead of using React Router. Falls back to"," ",e.jsx("code",{children:"path"})," if not provided."]})},{property:"component",type:"JSX.Element?",required:"No",description:e.jsxs(e.Fragment,{children:["React component to render when this route is active. Required for automatic routing. Not needed if using ",e.jsx("code",{children:"customRoutes"}),"."]})},{property:"icon",type:"React.ReactNode?",required:"No",description:"Icon element to display next to the menu item name (typically a Lucide icon)"},{property:"dropdownItems",type:"DropdownItemProps[]?",required:"No",description:"Array of sub-menu items for nested navigation. Creates a dropdown menu when provided."},{property:"isActive",type:"boolean?",required:"No",description:"Manually set active state. Usually handled automatically by matching the current pathname."},{property:"hide",type:"boolean?",required:"No",description:"Hide this menu item from navigation (useful for conditional rendering)"},{property:"onClick",type:"() => void?",required:"No",description:"Callback function executed when the menu item is clicked"},{property:"isPublic",type:"boolean?",required:"No",description:e.jsx(e.Fragment,{children:"Marks the route as publicly accessible (no authentication required). Only used in standalone routing mode."})},{property:"enableNestedRoutes",type:"boolean?",required:"No",description:e.jsxs(e.Fragment,{children:["When ",e.jsx("code",{children:"true"}),", appends ",e.jsx("code",{children:"/*"})," to the route path so the page can handle internal sub-routes. Only used in standalone routing mode."]})}];return e.jsxs(e.Fragment,{children:[e.jsx(t.HeroCard,{title:"MenuItems Guide",description:"Complete guide to configuring menu items for navigation and routing in your application.",icon:e.jsx("div",{className:"w-20 h-20 sm:w-24 sm:h-24 md:w-32 md:h-32 bg-linear-to-br from-blue-500 via-indigo-500 to-cyan-500 rounded-full flex items-center justify-center shadow-lg",children:e.jsx(o.Menu,{className:"w-10 h-10 sm:w-12 sm:h-12 md:w-16 md:h-16 text-white filter drop-shadow-lg"})})}),e.jsxs("div",{className:"text-center",children:[e.jsx(t.Typography,{tag:"h2",className:"mb-2",children:"MenuItems Guide"}),e.jsx(t.Typography,{tag:"p",className:"text-gray-500 dark:text-gray-400 max-w-2xl mx-auto",children:"Complete guide to configuring menu items for navigation and routing"})]}),e.jsx(t.CardContainer,{className:"overflow-hidden",children:e.jsx(t.CardTitle,{title:"MenuItem Properties",className:"mt-2 mb-2",children:e.jsxs("div",{className:"w-full space-y-6 p-4 sm:p-6",children:[e.jsx(t.Typography,{tag:"p",className:"text-gray-600 dark:text-gray-400",children:"Each menu item is an object with the following properties:"}),e.jsx(t.BasicTable,{columns:s.map(i=>({...i,render:(n,d)=>i.key==="property"?e.jsx("code",{className:"text-xs text-brand",children:String(n??"")}):i.key==="type"?e.jsx("code",{className:"text-xs text-gray-600 dark:text-gray-400",children:String(n??"")}):i.key==="required"?e.jsx(t.Badge,{variant:"outline",className:`text-xs ${n==="Yes"?"":"bg-gray-200"}`,children:String(n??"")}):i.key==="description"?e.jsx("span",{className:"text-xs text-gray-600 dark:text-gray-400",children:n}):String(n??"")})),data:r,containerClassName:"mb-4"}),e.jsx(t.Alert,{variant:"info",children:e.jsxs("div",{children:[e.jsxs("div",{className:"flex items-center gap-2 font-semibold",children:[e.jsx(o.Info,{className:"h-4 w-4"}),"Important: path vs href"]}),e.jsxs("div",{className:"text-sm mt-1",children:[e.jsx("strong",{children:"path"})," is used for internal React Router navigation and active state detection. ",e.jsx("strong",{children:"href"})," ","is for external URLs (starts with ",e.jsx("code",{children:"http://"})," or"," ",e.jsx("code",{children:"https://"}),"). If both are provided,"," ",e.jsx("code",{children:"href"})," takes precedence for navigation, but"," ",e.jsx("code",{children:"path"})," is still used for active state matching."]})]})})]})})}),e.jsx(t.CardContainer,{className:"overflow-hidden",children:e.jsx(t.CardTitle,{title:"MenuItems Examples",className:"mt-2 mb-2",children:e.jsx("div",{className:"w-full space-y-6 p-4 sm:p-6",children:e.jsxs("div",{className:"space-y-6",children:[e.jsxs("div",{className:"space-y-3",children:[e.jsx(t.Typography,{tag:"h4",className:"font-semibold",children:"1. Simple Menu Item"}),e.jsx(t.CodeBlock,{language:"tsx",code:`const menuItems = [
+  {
+    name: 'Dashboard',
+    path: '/dashboard',
+    icon: <LucideIcons.Home />,
+    component: <Dashboard />,
+  },
+];`})]}),e.jsxs("div",{className:"space-y-3",children:[e.jsx(t.Typography,{tag:"h4",className:"font-semibold",children:"2. Menu Item with External Link"}),e.jsx(t.CodeBlock,{language:"tsx",code:`const menuItems = [
+  {
+    name: 'Documentation',
+    path: '/docs', // Used for active state
+    href: 'https://docs.example.com', // External URL for navigation
+    icon: <LucideIcons.Book />,
+    // No component needed for external links
+  },
+];`})]}),e.jsxs("div",{className:"space-y-3",children:[e.jsx(t.Typography,{tag:"h4",className:"font-semibold",children:"3. Menu Item with Dropdown"}),e.jsx(t.CodeBlock,{language:"tsx",code:`const menuItems = [
+  {
+    name: 'Design System',
+    path: '/design-system',
+    icon: <LucideIcons.Palette />,
+    component: <DesignSystem />,
+    dropdownItems: [
+      {
+        name: 'Layout',
+        path: '/design-system/layout',
+        icon: <LucideIcons.Layout />,
+        component: <LayoutSystem />,
+      },
+      {
+        name: 'Theming',
+        path: '/design-system/theming',
+        icon: <LucideIcons.Paintbrush />,
+        component: <ThemingGuide />,
+      },
+    ],
+  },
+];`})]}),e.jsxs("div",{className:"space-y-3",children:[e.jsx(t.Typography,{tag:"h4",className:"font-semibold",children:"4. Complete Example with All Features"}),e.jsx(t.CodeBlock,{language:"tsx",code:`import { LucideIcons } from '@ui/tucu-ui';
+import { Dashboard } from './pages/Dashboard';
+import { Settings } from './pages/Settings';
+import { Profile } from './pages/Profile';
+
+const menuItems = [
+  {
+    name: 'Dashboard',
+    path: '/',
+    icon: <LucideIcons.Home />,
+    component: <Dashboard />,
+  },
+  {
+    name: 'Settings',
+    path: '/settings',
+    icon: <LucideIcons.Settings />,
+    component: <Settings />,
+    dropdownItems: [
+      {
+        name: 'General',
+        path: '/settings/general',
+        component: <GeneralSettings />,
+      },
+      {
+        name: 'Profile',
+        path: '/settings/profile',
+        component: <Profile />,
+      },
+    ],
+  },
+  {
+    name: 'Documentation',
+    path: '/docs',
+    href: 'https://docs.example.com', // External link
+    icon: <LucideIcons.Book />,
+  },
+  {
+    name: 'Help',
+    path: '/help',
+    icon: <LucideIcons.HelpCircle />,
+    component: <Help />,
+    onClick: () => {
+      console.log('Help clicked');
+      // Custom click handler
+    },
+  },
+  {
+    name: 'Hidden Item',
+    path: '/hidden',
+    component: <HiddenPage />,
+    hide: true, // Hidden from menu but route still works
+  },
+];
+
+function App() {
+  return (
+    <ThemeProvider menuItems={menuItems} layout={LAYOUT_OPTIONS.ADMIN} />
+  );
+}`})]}),e.jsxs("div",{className:"space-y-3",children:[e.jsx(t.Typography,{tag:"h4",className:"font-semibold",children:"5. Conditional Menu Items"}),e.jsx(t.CodeBlock,{language:"tsx",code:`import { useAuth } from './hooks/useAuth';
+
+function App() {
+  const { isAdmin, isAuthenticated } = useAuth();
+
+  const menuItems = [
+    {
+      name: 'Home',
+      path: '/',
+      icon: <LucideIcons.Home />,
+      component: <Home />,
+    },
+    {
+      name: 'Dashboard',
+      path: '/dashboard',
+      icon: <LucideIcons.LayoutDashboard />,
+      component: <Dashboard />,
+      hide: !isAuthenticated, // Hide if not authenticated
+    },
+    {
+      name: 'Admin Panel',
+      path: '/admin',
+      icon: <LucideIcons.Shield />,
+      component: <AdminPanel />,
+      hide: !isAdmin, // Hide if not admin
+    },
+  ].filter((item) => !item.hide); // Filter out hidden items
+
+  return (
+    <ThemeProvider menuItems={menuItems} layout={LAYOUT_OPTIONS.ADMIN} />
+  );
+}`})]})]})})})})]})};exports.default=a;

package/documentation/ModalSection-445ZMEa_.js

@@ -0,0 +1,30 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("react/jsx-runtime"),s=require("react"),t=require("../index-DWDUS-PU.js"),c=require("lucide-react");require("react-router-dom");require("react-dom");const m=()=>{const[a,n]=s.useState(!1),[l,o]=s.useState(!1),[i,r]=s.useState(!1);return e.jsxs(e.Fragment,{children:[e.jsx(t.HeroCard,{title:"Modal",description:`A modal dialog component for displaying content in an overlay with
+          customizable buttons and close functionality.`,icon:e.jsx("div",{className:"w-16 h-16 sm:w-20 sm:h-20 md:w-24 md:h-24 bg-linear-to-br from-amber-500 to-orange-500 rounded-full flex items-center justify-center shadow-lg",children:e.jsx(c.Maximize2,{className:"w-8 h-8 sm:w-10 sm:h-10 md:w-12 md:h-12 text-white filter drop-shadow-lg"})})}),e.jsx(t.CardContainer,{className:"overflow-hidden",children:e.jsx(t.CardTitle,{title:"Basic Examples",className:"mt-2 mb-2",children:e.jsx("div",{className:"w-full p-4 sm:p-6",children:e.jsxs("div",{className:"space-y-4",children:[e.jsxs(t.CardContainer,{className:"p-4",children:[e.jsx(t.Typography,{tag:"h5",className:"mb-3",children:"Basic Modal"}),e.jsx(t.Button,{onClick:()=>n(!0),children:"Open Modal"}),e.jsx(t.Modal,{isOpen:a,setIsOpen:n,text:{title:"Modal Title",content:"This is the modal content.",button:"Confirm"}})]}),e.jsxs(t.CardContainer,{className:"p-4",children:[e.jsx(t.Typography,{tag:"h5",className:"mb-3",children:"Modal with Custom Content"}),e.jsx(t.Button,{onClick:()=>o(!0),children:"Open Custom Modal"}),e.jsx(t.Modal,{isOpen:l,setIsOpen:o,text:{title:"Custom Modal"},children:e.jsx(t.Typography,{tag:"p",children:"Custom content goes here"})})]})]})})})}),e.jsx(t.PropPlayground,{componentName:"Modal",defaultValues:{isOpen:i,setIsOpen:r,closeable:!0,hideButtons:!1},excludeProps:["setIsOpen","onBack","onClose","onSubmit"],children:d=>e.jsx(t.Modal,{...d,text:{title:"Modal Preview",content:"This is a preview of the modal component."},children:e.jsx("p",{className:"text-sm text-gray-600 dark:text-gray-400",children:"Modal body content"})})}),e.jsx(t.AutoPropsTable,{componentName:"Modal"}),e.jsx(t.CardContainer,{className:"overflow-hidden",children:e.jsx(t.CardTitle,{title:"Code Example",className:"mt-2 mb-2",children:e.jsx("div",{className:"w-full p-4 sm:p-6",children:e.jsx(t.CodeBlock,{language:"tsx",code:`import { Modal, Button } from '@e-burgos/tucu-ui';
+import { useState } from 'react';
+
+function MyComponent() {
+  const [isOpen, setIsOpen] = useState(false);
+
+  return (
+    <>
+      <Button onClick={() => setIsOpen(true)}>Open Modal</Button>
+      <Modal
+        isOpen={isOpen}
+        setIsOpen={setIsOpen}
+        text={{
+          title: 'Modal Title',
+          content: 'This is the modal content.',
+          button: 'Confirm',
+        }}
+      />
+    </>
+  );
+}
+
+// With custom content
+<Modal isOpen={isOpen} setIsOpen={setIsOpen} text={{ title: 'Custom Modal' }}>
+  <div>Custom content here</div>
+</Modal>
+
+// Non-closeable
+<Modal isOpen={isOpen} setIsOpen={setIsOpen} closeable={false} />`})})})})]})};exports.default=m;

package/documentation/ModalSection-BWoZ5Pcl.js

@@ -0,0 +1,114 @@
+import { jsxs as t, Fragment as f, jsx as e } from "react/jsx-runtime";
+import { useState as o } from "react";
+import { H as O, C as s, a as d, T as n, x as r, a3 as a, P as M, A as C, c as x } from "../index-DoxeCFUJ.js";
+import { Maximize2 as b } from "lucide-react";
+import "react-router-dom";
+import "react-dom";
+const B = () => {
+  const [c, l] = o(!1), [m, i] = o(!1), [p, h] = o(!1);
+  return /* @__PURE__ */ t(f, { children: [
+    /* @__PURE__ */ e(
+      O,
+      {
+        title: "Modal",
+        description: `A modal dialog component for displaying content in an overlay with
+          customizable buttons and close functionality.`,
+        icon: /* @__PURE__ */ e("div", { className: "w-16 h-16 sm:w-20 sm:h-20 md:w-24 md:h-24 bg-linear-to-br from-amber-500 to-orange-500 rounded-full flex items-center justify-center shadow-lg", children: /* @__PURE__ */ e(b, { className: "w-8 h-8 sm:w-10 sm:h-10 md:w-12 md:h-12 text-white filter drop-shadow-lg" }) })
+      }
+    ),
+    /* @__PURE__ */ e(s, { className: "overflow-hidden", children: /* @__PURE__ */ e(d, { title: "Basic Examples", className: "mt-2 mb-2", children: /* @__PURE__ */ e("div", { className: "w-full p-4 sm:p-6", children: /* @__PURE__ */ t("div", { className: "space-y-4", children: [
+      /* @__PURE__ */ t(s, { className: "p-4", children: [
+        /* @__PURE__ */ e(n, { tag: "h5", className: "mb-3", children: "Basic Modal" }),
+        /* @__PURE__ */ e(r, { onClick: () => l(!0), children: "Open Modal" }),
+        /* @__PURE__ */ e(
+          a,
+          {
+            isOpen: c,
+            setIsOpen: l,
+            text: {
+              title: "Modal Title",
+              content: "This is the modal content.",
+              button: "Confirm"
+            }
+          }
+        )
+      ] }),
+      /* @__PURE__ */ t(s, { className: "p-4", children: [
+        /* @__PURE__ */ e(n, { tag: "h5", className: "mb-3", children: "Modal with Custom Content" }),
+        /* @__PURE__ */ e(r, { onClick: () => i(!0), children: "Open Custom Modal" }),
+        /* @__PURE__ */ e(
+          a,
+          {
+            isOpen: m,
+            setIsOpen: i,
+            text: { title: "Custom Modal" },
+            children: /* @__PURE__ */ e(n, { tag: "p", children: "Custom content goes here" })
+          }
+        )
+      ] })
+    ] }) }) }) }),
+    /* @__PURE__ */ e(
+      M,
+      {
+        componentName: "Modal",
+        defaultValues: {
+          isOpen: p,
+          setIsOpen: h,
+          closeable: !0,
+          hideButtons: !1
+        },
+        excludeProps: ["setIsOpen", "onBack", "onClose", "onSubmit"],
+        children: (u) => /* @__PURE__ */ e(
+          a,
+          {
+            ...u,
+            text: {
+              title: "Modal Preview",
+              content: "This is a preview of the modal component."
+            },
+            children: /* @__PURE__ */ e("p", { className: "text-sm text-gray-600 dark:text-gray-400", children: "Modal body content" })
+          }
+        )
+      }
+    ),
+    /* @__PURE__ */ e(C, { componentName: "Modal" }),
+    /* @__PURE__ */ e(s, { className: "overflow-hidden", children: /* @__PURE__ */ e(d, { title: "Code Example", className: "mt-2 mb-2", children: /* @__PURE__ */ e("div", { className: "w-full p-4 sm:p-6", children: /* @__PURE__ */ e(
+      x,
+      {
+        language: "tsx",
+        code: `import { Modal, Button } from '@e-burgos/tucu-ui';
+import { useState } from 'react';
+
+function MyComponent() {
+  const [isOpen, setIsOpen] = useState(false);
+
+  return (
+    <>
+      <Button onClick={() => setIsOpen(true)}>Open Modal</Button>
+      <Modal
+        isOpen={isOpen}
+        setIsOpen={setIsOpen}
+        text={{
+          title: 'Modal Title',
+          content: 'This is the modal content.',
+          button: 'Confirm',
+        }}
+      />
+    </>
+  );
+}
+
+// With custom content
+<Modal isOpen={isOpen} setIsOpen={setIsOpen} text={{ title: 'Custom Modal' }}>
+  <div>Custom content here</div>
+</Modal>
+
+// Non-closeable
+<Modal isOpen={isOpen} setIsOpen={setIsOpen} closeable={false} />`
+      }
+    ) }) }) })
+  ] });
+};
+export {
+  B as default
+};

package/documentation/NFTGridSection-2-m_Uk8V.js

@@ -0,0 +1,19 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("react/jsx-runtime"),t=require("../index-DWDUS-PU.js"),i=require("lucide-react");require("react-router-dom");require("react");require("react-dom");const o=()=>e.jsxs(e.Fragment,{children:[e.jsx(t.HeroCard,{title:"NFTGrid",description:"Grid card component for displaying NFT items with author information, image, collection, and price.",icon:e.jsx("div",{className:"w-20 h-20 sm:w-24 sm:h-24 md:w-32 md:h-32 bg-linear-to-br from-cyan-500 via-blue-500 to-indigo-500 rounded-full flex items-center justify-center shadow-lg border border-cyan-500/50",children:e.jsx(i.Grid3x3,{className:"w-10 h-10 sm:w-12 sm:h-12 md:w-16 md:h-16 text-white filter drop-shadow-lg"})})}),e.jsx(t.CardContainer,{className:"overflow-hidden",children:e.jsx(t.CardTitle,{title:"Grid Examples",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 sm:grid-cols-2 lg:grid-cols-3 gap-5",children:[e.jsx(t.NFTGrid,{author:"CryptoPunk",authorImage:"https://i.pravatar.cc/80?img=1",image:"https://picsum.photos/seed/nft1/400/300",name:"CryptoPunk #1234",collection:"Crypto Punks",price:"45 ETH"}),e.jsx(t.NFTGrid,{author:"BoredApe",authorImage:"https://i.pravatar.cc/80?img=12",image:"https://picsum.photos/seed/nft2/400/300",name:"Bored Ape #8821",collection:"BAYC",price:"72 ETH"}),e.jsx(t.NFTGrid,{author:"Azuki",authorImage:"https://i.pravatar.cc/80?img=25",image:"https://picsum.photos/seed/nft3/400/300",name:"Azuki #5501",collection:"Azuki",price:"18.5 ETH"}),e.jsx(t.NFTGrid,{author:"Doodles",authorImage:"https://i.pravatar.cc/80?img=33",image:"https://picsum.photos/seed/nft4/400/300",name:"Doodle #3120",collection:"Doodles",price:"8.2 ETH"}),e.jsx(t.NFTGrid,{author:"CloneX",authorImage:"https://i.pravatar.cc/80?img=44",image:"https://picsum.photos/seed/nft5/400/300",name:"CloneX #12882",collection:"CloneX",price:"5.8 ETH"}),e.jsx(t.NFTGrid,{author:"Moonbird",authorImage:"https://i.pravatar.cc/80?img=56",image:"https://picsum.photos/seed/nft6/400/300",name:"Moonbird #7744",collection:"Moonbirds",price:"12 ETH",profilePath:"/profile/moonbird"})]})})})}),e.jsx(t.PropPlayground,{componentName:"NFTGrid",defaultValues:{author:"CryptoPunk",authorImage:"https://i.pravatar.cc/80?img=1",image:"https://picsum.photos/seed/nft1/400/300",name:"CryptoPunk #1234",collection:"Crypto Punks",price:"45 ETH",profilePath:""},controlOverrides:[{name:"author",type:"text",description:"NFT author name"},{name:"name",type:"text",description:"NFT item name"},{name:"collection",type:"text",description:"Collection name"},{name:"price",type:"text",description:"Price display text"}],includeProps:["author","name","collection","price","profilePath"],children:r=>e.jsx("div",{className:"w-full max-w-xs",children:e.jsx(t.NFTGrid,{...r,authorImage:"https://i.pravatar.cc/80?img=1",image:"https://picsum.photos/seed/nft1/400/300"})})}),e.jsx(t.AutoPropsTable,{componentName:"NFTGrid"}),e.jsx(t.CardContainer,{className:"overflow-hidden",children:e.jsx(t.CardTitle,{title:"Code Example",className:"mt-2 mb-2",children:e.jsx("div",{className:"w-full p-4 sm:p-6",children:e.jsx(t.CodeBlock,{language:"tsx",code:`import { NFTGrid } from '@e-burgos/tucu-ui';
+
+// Single card
+<NFTGrid
+  author="CryptoPunk"
+  authorImage="/avatars/cryptopunk.jpg"
+  image="/nfts/punk-1234.jpg"
+  name="CryptoPunk #1234"
+  collection="Crypto Punks"
+  price="45 ETH"
+  profilePath="/profile/cryptopunk"
+/>
+
+// Grid layout
+<div className="grid grid-cols-1 sm:grid-cols-2 lg:grid-cols-3 gap-5">
+  <NFTGrid {...nft1} />
+  <NFTGrid {...nft2} />
+  <NFTGrid {...nft3} />
+</div>`})})})})]});exports.default=o;

package/documentation/NFTGridSection-CEinlBJu.js

@@ -0,0 +1,160 @@
+import { jsxs as o, Fragment as s, jsx as e } from "react/jsx-runtime";
+import { H as c, C as i, a as r, N as t, P as p, A as n, c as m } from "../index-DoxeCFUJ.js";
+import { Grid3x3 as l } from "lucide-react";
+import "react-router-dom";
+import "react";
+import "react-dom";
+const T = () => /* @__PURE__ */ o(s, { children: [
+  /* @__PURE__ */ e(
+    c,
+    {
+      title: "NFTGrid",
+      description: "Grid card component for displaying NFT items with author information, image, collection, and price.",
+      icon: /* @__PURE__ */ e("div", { className: "w-20 h-20 sm:w-24 sm:h-24 md:w-32 md:h-32 bg-linear-to-br from-cyan-500 via-blue-500 to-indigo-500 rounded-full flex items-center justify-center shadow-lg border border-cyan-500/50", children: /* @__PURE__ */ e(l, { className: "w-10 h-10 sm:w-12 sm:h-12 md:w-16 md:h-16 text-white filter drop-shadow-lg" }) })
+    }
+  ),
+  /* @__PURE__ */ e(i, { className: "overflow-hidden", children: /* @__PURE__ */ e(r, { title: "Grid Examples", className: "mt-2 mb-2", children: /* @__PURE__ */ e("div", { className: "w-full p-4 sm:p-6", children: /* @__PURE__ */ o("div", { className: "grid grid-cols-1 sm:grid-cols-2 lg:grid-cols-3 gap-5", children: [
+    /* @__PURE__ */ e(
+      t,
+      {
+        author: "CryptoPunk",
+        authorImage: "https://i.pravatar.cc/80?img=1",
+        image: "https://picsum.photos/seed/nft1/400/300",
+        name: "CryptoPunk #1234",
+        collection: "Crypto Punks",
+        price: "45 ETH"
+      }
+    ),
+    /* @__PURE__ */ e(
+      t,
+      {
+        author: "BoredApe",
+        authorImage: "https://i.pravatar.cc/80?img=12",
+        image: "https://picsum.photos/seed/nft2/400/300",
+        name: "Bored Ape #8821",
+        collection: "BAYC",
+        price: "72 ETH"
+      }
+    ),
+    /* @__PURE__ */ e(
+      t,
+      {
+        author: "Azuki",
+        authorImage: "https://i.pravatar.cc/80?img=25",
+        image: "https://picsum.photos/seed/nft3/400/300",
+        name: "Azuki #5501",
+        collection: "Azuki",
+        price: "18.5 ETH"
+      }
+    ),
+    /* @__PURE__ */ e(
+      t,
+      {
+        author: "Doodles",
+        authorImage: "https://i.pravatar.cc/80?img=33",
+        image: "https://picsum.photos/seed/nft4/400/300",
+        name: "Doodle #3120",
+        collection: "Doodles",
+        price: "8.2 ETH"
+      }
+    ),
+    /* @__PURE__ */ e(
+      t,
+      {
+        author: "CloneX",
+        authorImage: "https://i.pravatar.cc/80?img=44",
+        image: "https://picsum.photos/seed/nft5/400/300",
+        name: "CloneX #12882",
+        collection: "CloneX",
+        price: "5.8 ETH"
+      }
+    ),
+    /* @__PURE__ */ e(
+      t,
+      {
+        author: "Moonbird",
+        authorImage: "https://i.pravatar.cc/80?img=56",
+        image: "https://picsum.photos/seed/nft6/400/300",
+        name: "Moonbird #7744",
+        collection: "Moonbirds",
+        price: "12 ETH",
+        profilePath: "/profile/moonbird"
+      }
+    )
+  ] }) }) }) }),
+  /* @__PURE__ */ e(
+    p,
+    {
+      componentName: "NFTGrid",
+      defaultValues: {
+        author: "CryptoPunk",
+        authorImage: "https://i.pravatar.cc/80?img=1",
+        image: "https://picsum.photos/seed/nft1/400/300",
+        name: "CryptoPunk #1234",
+        collection: "Crypto Punks",
+        price: "45 ETH",
+        profilePath: ""
+      },
+      controlOverrides: [
+        {
+          name: "author",
+          type: "text",
+          description: "NFT author name"
+        },
+        {
+          name: "name",
+          type: "text",
+          description: "NFT item name"
+        },
+        {
+          name: "collection",
+          type: "text",
+          description: "Collection name"
+        },
+        {
+          name: "price",
+          type: "text",
+          description: "Price display text"
+        }
+      ],
+      includeProps: ["author", "name", "collection", "price", "profilePath"],
+      children: (a) => /* @__PURE__ */ e("div", { className: "w-full max-w-xs", children: /* @__PURE__ */ e(
+        t,
+        {
+          ...a,
+          authorImage: "https://i.pravatar.cc/80?img=1",
+          image: "https://picsum.photos/seed/nft1/400/300"
+        }
+      ) })
+    }
+  ),
+  /* @__PURE__ */ e(n, { componentName: "NFTGrid" }),
+  /* @__PURE__ */ e(i, { className: "overflow-hidden", children: /* @__PURE__ */ e(r, { title: "Code Example", className: "mt-2 mb-2", children: /* @__PURE__ */ e("div", { className: "w-full p-4 sm:p-6", children: /* @__PURE__ */ e(
+    m,
+    {
+      language: "tsx",
+      code: `import { NFTGrid } from '@e-burgos/tucu-ui';
+
+// Single card
+<NFTGrid
+  author="CryptoPunk"
+  authorImage="/avatars/cryptopunk.jpg"
+  image="/nfts/punk-1234.jpg"
+  name="CryptoPunk #1234"
+  collection="Crypto Punks"
+  price="45 ETH"
+  profilePath="/profile/cryptopunk"
+/>
+
+// Grid layout
+<div className="grid grid-cols-1 sm:grid-cols-2 lg:grid-cols-3 gap-5">
+  <NFTGrid {...nft1} />
+  <NFTGrid {...nft2} />
+  <NFTGrid {...nft3} />
+</div>`
+    }
+  ) }) }) })
+] });
+export {
+  T as default
+};

package/documentation/NestedRoutesSection-D_qsJSnp.js

@@ -0,0 +1,39 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("react/jsx-runtime"),s=require("../index-DWDUS-PU.js"),t=require("lucide-react");require("react-router-dom");require("react");require("react-dom");const a=()=>e.jsxs(e.Fragment,{children:[e.jsx(s.HeroCard,{title:"Nested Routes",description:"Create hierarchical navigation with unlimited nesting levels. Each menu item supports dropdownItems that automatically render as sidebar dropdown menus.",icon:e.jsx("div",{className:"w-20 h-20 sm:w-24 sm:h-24 md:w-32 md:h-32 bg-linear-to-br from-purple-500 via-violet-500 to-indigo-500 rounded-full flex items-center justify-center shadow-lg",children:e.jsx(t.Layers3,{className:"w-10 h-10 sm:w-12 sm:h-12 md:w-16 md:h-16 text-white filter drop-shadow-lg"})})}),e.jsxs("section",{className:"space-y-8",children:[e.jsxs("div",{className:"text-center",children:[e.jsx(s.Typography,{tag:"h2",className:"mb-2",children:"Nested Routes Example"}),e.jsx(s.Typography,{tag:"p",className:"text-gray-500 dark:text-gray-400 max-w-2xl mx-auto",children:"Parent routes with dropdownItems generate hierarchical navigation"})]}),e.jsx(s.CardContainer,{children:e.jsx(s.CardTitle,{title:"Configuration",children:e.jsx(s.CodeBlock,{language:"tsx",code:`import { ThemeProvider, StandaloneAppRoutesMenuItem } from '@e-burgos/tucu-ui';
+
+const menuItems: StandaloneAppRoutesMenuItem[] = [
+  {
+    name: 'Components',
+    path: '/components',
+    icon: <LucideIcons.Component />,
+    component: <ComponentsPage />,
+    enableNestedRoutes: true, // Adds /* to path for nested routing
+    dropdownItems: [
+      {
+        name: 'Buttons',
+        path: '/components/buttons',
+        icon: <LucideIcons.MousePointerClick />,
+        component: <ButtonsPage />,
+      },
+      {
+        name: 'Forms',
+        path: '/components/forms',
+        icon: <LucideIcons.FileText />,
+        component: <FormsPage />,
+      },
+    ],
+  },
+  {
+    name: 'Utilities',
+    path: '/utilities',
+    icon: <LucideIcons.Wrench />,
+    component: <UtilitiesPage />,
+    dropdownItems: [
+      {
+        name: 'Hooks',
+        path: '/utilities/hooks',
+        icon: <LucideIcons.Zap />,
+        component: <HooksPage />,
+      },
+    ],
+  },
+];`})})})]}),e.jsxs("section",{className:"space-y-8",children:[e.jsxs("div",{className:"text-center",children:[e.jsx(s.Typography,{tag:"h2",className:"mb-2",children:"Navigation Structure"}),e.jsx(s.Typography,{tag:"p",className:"text-gray-500 dark:text-gray-400 max-w-2xl mx-auto",children:"Visual representation of the generated sidebar"})]}),e.jsx(s.CardContainer,{children:e.jsxs("div",{className:"space-y-3 p-4",children:[e.jsxs("div",{className:"p-3 bg-light-dark rounded-lg",children:[e.jsxs("div",{className:"flex items-center gap-2 mb-2",children:[e.jsx("div",{className:"p-1.5 rounded bg-linear-to-br from-blue-500 to-cyan-500 shadow-lg",children:e.jsx(t.Component,{className:"w-3 h-3 text-white filter drop-shadow-sm"})}),e.jsx("span",{className:"font-medium",children:"Components"})]}),e.jsxs("div",{className:"ml-6 space-y-1",children:[e.jsxs("div",{className:"flex items-center gap-2 text-sm text-gray-600 dark:text-gray-400",children:[e.jsx(t.MousePointerClick,{className:"w-3 h-3"}),"Buttons"]}),e.jsxs("div",{className:"flex items-center gap-2 text-sm text-gray-600 dark:text-gray-400",children:[e.jsx(t.FileText,{className:"w-3 h-3"}),"Forms"]})]})]}),e.jsxs("div",{className:"p-3 bg-light-dark rounded-lg",children:[e.jsxs("div",{className:"flex items-center gap-2 mb-2",children:[e.jsx("div",{className:"p-1.5 rounded bg-linear-to-br from-purple-500 to-indigo-500 shadow-lg",children:e.jsx(t.Wrench,{className:"w-3 h-3 text-white filter drop-shadow-sm"})}),e.jsx("span",{className:"font-medium",children:"Utilities"})]}),e.jsx("div",{className:"ml-6 space-y-1",children:e.jsxs("div",{className:"flex items-center gap-2 text-sm text-gray-600 dark:text-gray-400",children:[e.jsx(t.Zap,{className:"w-3 h-3"}),"Hooks"]})})]})]})}),e.jsx(s.Alert,{variant:"info",dismissible:!1,children:e.jsxs(s.Typography,{tag:"p",className:"text-sm",children:[e.jsx(t.Info,{className:"w-4 h-4 inline mr-2"}),"Use"," ",e.jsx("code",{className:"px-1 py-0.5 border border-border rounded text-xs",children:"enableNestedRoutes: true"})," ","on parent routes when child components need their own internal routing (e.g., tabs, sub-pages)."]})})]})]});exports.default=a;

package/documentation/NestedRoutesSection-DrqTtZfw.js

@@ -0,0 +1,120 @@
+import { jsxs as t, Fragment as n, jsx as e } from "react/jsx-runtime";
+import { H as o, T as a, C as s, a as i, c as r, aj as d } from "../index-DoxeCFUJ.js";
+import { Layers3 as c, Component as l, MousePointerClick as m, FileText as h, Wrench as p, Zap as u, Info as g } from "lucide-react";
+import "react-router-dom";
+import "react";
+import "react-dom";
+const C = () => /* @__PURE__ */ t(n, { children: [
+  /* @__PURE__ */ e(
+    o,
+    {
+      title: "Nested Routes",
+      description: "Create hierarchical navigation with unlimited nesting levels. Each menu item supports dropdownItems that automatically render as sidebar dropdown menus.",
+      icon: /* @__PURE__ */ e("div", { className: "w-20 h-20 sm:w-24 sm:h-24 md:w-32 md:h-32 bg-linear-to-br from-purple-500 via-violet-500 to-indigo-500 rounded-full flex items-center justify-center shadow-lg", children: /* @__PURE__ */ e(c, { className: "w-10 h-10 sm:w-12 sm:h-12 md:w-16 md:h-16 text-white filter drop-shadow-lg" }) })
+    }
+  ),
+  /* @__PURE__ */ t("section", { className: "space-y-8", children: [
+    /* @__PURE__ */ t("div", { className: "text-center", children: [
+      /* @__PURE__ */ e(a, { tag: "h2", className: "mb-2", children: "Nested Routes Example" }),
+      /* @__PURE__ */ e(
+        a,
+        {
+          tag: "p",
+          className: "text-gray-500 dark:text-gray-400 max-w-2xl mx-auto",
+          children: "Parent routes with dropdownItems generate hierarchical navigation"
+        }
+      )
+    ] }),
+    /* @__PURE__ */ e(s, { children: /* @__PURE__ */ e(i, { title: "Configuration", children: /* @__PURE__ */ e(r, { language: "tsx", code: `import { ThemeProvider, StandaloneAppRoutesMenuItem } from '@e-burgos/tucu-ui';
+
+const menuItems: StandaloneAppRoutesMenuItem[] = [
+  {
+    name: 'Components',
+    path: '/components',
+    icon: <LucideIcons.Component />,
+    component: <ComponentsPage />,
+    enableNestedRoutes: true, // Adds /* to path for nested routing
+    dropdownItems: [
+      {
+        name: 'Buttons',
+        path: '/components/buttons',
+        icon: <LucideIcons.MousePointerClick />,
+        component: <ButtonsPage />,
+      },
+      {
+        name: 'Forms',
+        path: '/components/forms',
+        icon: <LucideIcons.FileText />,
+        component: <FormsPage />,
+      },
+    ],
+  },
+  {
+    name: 'Utilities',
+    path: '/utilities',
+    icon: <LucideIcons.Wrench />,
+    component: <UtilitiesPage />,
+    dropdownItems: [
+      {
+        name: 'Hooks',
+        path: '/utilities/hooks',
+        icon: <LucideIcons.Zap />,
+        component: <HooksPage />,
+      },
+    ],
+  },
+];` }) }) })
+  ] }),
+  /* @__PURE__ */ t("section", { className: "space-y-8", children: [
+    /* @__PURE__ */ t("div", { className: "text-center", children: [
+      /* @__PURE__ */ e(a, { tag: "h2", className: "mb-2", children: "Navigation Structure" }),
+      /* @__PURE__ */ e(
+        a,
+        {
+          tag: "p",
+          className: "text-gray-500 dark:text-gray-400 max-w-2xl mx-auto",
+          children: "Visual representation of the generated sidebar"
+        }
+      )
+    ] }),
+    /* @__PURE__ */ e(s, { children: /* @__PURE__ */ t("div", { className: "space-y-3 p-4", children: [
+      /* @__PURE__ */ t("div", { className: "p-3 bg-light-dark rounded-lg", children: [
+        /* @__PURE__ */ t("div", { className: "flex items-center gap-2 mb-2", children: [
+          /* @__PURE__ */ e("div", { className: "p-1.5 rounded bg-linear-to-br from-blue-500 to-cyan-500 shadow-lg", children: /* @__PURE__ */ e(l, { className: "w-3 h-3 text-white filter drop-shadow-sm" }) }),
+          /* @__PURE__ */ e("span", { className: "font-medium", children: "Components" })
+        ] }),
+        /* @__PURE__ */ t("div", { className: "ml-6 space-y-1", children: [
+          /* @__PURE__ */ t("div", { className: "flex items-center gap-2 text-sm text-gray-600 dark:text-gray-400", children: [
+            /* @__PURE__ */ e(m, { className: "w-3 h-3" }),
+            "Buttons"
+          ] }),
+          /* @__PURE__ */ t("div", { className: "flex items-center gap-2 text-sm text-gray-600 dark:text-gray-400", children: [
+            /* @__PURE__ */ e(h, { className: "w-3 h-3" }),
+            "Forms"
+          ] })
+        ] })
+      ] }),
+      /* @__PURE__ */ t("div", { className: "p-3 bg-light-dark rounded-lg", children: [
+        /* @__PURE__ */ t("div", { className: "flex items-center gap-2 mb-2", children: [
+          /* @__PURE__ */ e("div", { className: "p-1.5 rounded bg-linear-to-br from-purple-500 to-indigo-500 shadow-lg", children: /* @__PURE__ */ e(p, { className: "w-3 h-3 text-white filter drop-shadow-sm" }) }),
+          /* @__PURE__ */ e("span", { className: "font-medium", children: "Utilities" })
+        ] }),
+        /* @__PURE__ */ e("div", { className: "ml-6 space-y-1", children: /* @__PURE__ */ t("div", { className: "flex items-center gap-2 text-sm text-gray-600 dark:text-gray-400", children: [
+          /* @__PURE__ */ e(u, { className: "w-3 h-3" }),
+          "Hooks"
+        ] }) })
+      ] })
+    ] }) }),
+    /* @__PURE__ */ e(d, { variant: "info", dismissible: !1, children: /* @__PURE__ */ t(a, { tag: "p", className: "text-sm", children: [
+      /* @__PURE__ */ e(g, { className: "w-4 h-4 inline mr-2" }),
+      "Use",
+      " ",
+      /* @__PURE__ */ e("code", { className: "px-1 py-0.5 border border-border rounded text-xs", children: "enableNestedRoutes: true" }),
+      " ",
+      "on parent routes when child components need their own internal routing (e.g., tabs, sub-pages)."
+    ] }) })
+  ] })
+] });
+export {
+  C as default
+};