@e-burgos/tucu-ui 2.0.7 → 2.0.9

package/documentation/ThemeConfigurationSection-DKcO1n8f.js

@@ -0,0 +1,139 @@
+import { jsxs as a, Fragment as m, jsx as e } from "react/jsx-runtime";
+import { H as d, T as l, C as t, a as c } from "../index-lfg6LZ1p.js";
+import { Settings as i } from "lucide-react";
+import "react-router-dom";
+import "react";
+import "react-dom";
+const A = () => {
+  const s = [
+    { label: "Mode", value: "'light' | 'dark'" },
+    { label: "Theme Style", value: "'default' | 'macos' | 'macos-tahoe'" },
+    { label: "Direction", value: "'ltr' | 'rtl'" },
+    { label: "Layout", value: "6 options (constrained by theme style)" },
+    { label: "Primary Color", value: "34+ predefined presets" },
+    { label: "Dark Primary Color", value: "34+ predefined presets" },
+    { label: "Secondary Color", value: "34+ predefined presets" },
+    { label: "Dark Secondary Color", value: "34+ predefined presets" },
+    { label: "Accent Color", value: "34+ predefined presets" },
+    { label: "Dark Accent Color", value: "34+ predefined presets" },
+    { label: "Muted Color", value: "34+ predefined presets" },
+    { label: "Dark Muted Color", value: "34+ predefined presets" },
+    { label: "Dark Background", value: "Theme base colors" },
+    { label: "Light Background", value: "Theme base colors" },
+    { label: "Light Dark", value: "Theme base colors" },
+    { label: "Dark Light Dark", value: "Theme base colors" },
+    { label: "Language", value: "'en' | 'es' | 'fr'" }
+  ], n = [
+    { name: "DEFAULT_PRIMARY", color: "#0052ff" },
+    { name: "DEFAULT_DARK_PRIMARY", color: "#578bfa" },
+    { name: "DEFAULT_SECONDARY", color: "#f3f4f6" },
+    { name: "DEFAULT_DARK_SECONDARY", color: "#172131" },
+    { name: "DEFAULT_ACCENT", color: "#f7d21a" },
+    { name: "DEFAULT_DARK_ACCENT", color: "#936000" },
+    { name: "DEFAULT_MUTED", color: "#4a5565" },
+    { name: "DEFAULT_DARK_MUTED", color: "#828a99" },
+    { name: "DEFAULT_LIGHT_BG", color: "#ffffff" },
+    { name: "DEFAULT_DARK_BG", color: "#030712" },
+    { name: "DEFAULT_LIGHT_DARK", color: "#f9fafb" },
+    { name: "DEFAULT_DARK_LIGHT_DARK", color: "#0a101d" },
+    { name: "BLUE", color: "#105eff" },
+    { name: "DARK_BLUE", color: "#2162ee" },
+    { name: "GREEN", color: "#129961" },
+    { name: "DARK_GREEN", color: "#159962" },
+    { name: "ORANGE", color: "#e1591b" },
+    { name: "DARK_ORANGE", color: "#e66020" },
+    { name: "GRAY", color: "#6a7282" },
+    { name: "DARK_GRAY", color: "#6a7282" },
+    { name: "INDIGO", color: "#596ff2" },
+    { name: "DARK_INDIGO", color: "#5c71ee" },
+    { name: "PINK", color: "#cb51bb" },
+    { name: "DARK_PINK", color: "#d058c1" },
+    { name: "PURPLE", color: "#9d6bf2" },
+    { name: "DARK_PURPLE", color: "#bc7bfb" },
+    { name: "RED", color: "#e13947" },
+    { name: "DARK_RED", color: "#e6404e" },
+    { name: "TEAL", color: "#0093cb" },
+    { name: "DARK_TEAL", color: "#0095cd" },
+    { name: "YELLOW", color: "#cf9700" },
+    { name: "DARK_YELLOW", color: "#c79e00" },
+    { name: "CHARTREUSE", color: "#56b340" },
+    { name: "DARK_CHARTREUSE", color: "#7bc869" }
+  ];
+  return /* @__PURE__ */ a(m, { children: [
+    /* @__PURE__ */ e(
+      d,
+      {
+        title: "Theme Configuration",
+        description: "All available configuration options and the 34 color presets that power the theming system.",
+        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-emerald-500 via-teal-500 to-cyan-500 rounded-full flex items-center justify-center shadow-lg", children: /* @__PURE__ */ e(i, { className: "w-10 h-10 sm:w-12 sm:h-12 md:w-16 md:h-16 text-white filter drop-shadow-lg" }) })
+      }
+    ),
+    /* @__PURE__ */ a("section", { className: "space-y-8", children: [
+      /* @__PURE__ */ a("div", { className: "text-center", children: [
+        /* @__PURE__ */ e(l, { tag: "h2", className: "mb-2", children: "Available Options" }),
+        /* @__PURE__ */ e(
+          l,
+          {
+            tag: "p",
+            className: "text-gray-500 dark:text-gray-400 max-w-2xl mx-auto",
+            children: "All configurable properties managed by the theme store"
+          }
+        )
+      ] }),
+      /* @__PURE__ */ e(t, { children: /* @__PURE__ */ e(c, { title: "Configuration Options", children: /* @__PURE__ */ e("div", { className: "space-y-3", children: s.map((r, o) => /* @__PURE__ */ a(
+        "div",
+        {
+          className: "flex justify-between items-center py-2 px-3 bg-gray-200 dark:bg-gray-800 rounded-lg",
+          children: [
+            /* @__PURE__ */ e("span", { className: "font-medium text-sm", children: r.label }),
+            /* @__PURE__ */ e("code", { className: "text-xs text-gray-600 dark:text-gray-400", children: r.value })
+          ]
+        },
+        o
+      )) }) }) })
+    ] }),
+    /* @__PURE__ */ a("section", { className: "space-y-8", children: [
+      /* @__PURE__ */ a("div", { className: "text-center", children: [
+        /* @__PURE__ */ e(l, { tag: "h2", className: "mb-2", children: "Color Presets" }),
+        /* @__PURE__ */ e(
+          l,
+          {
+            tag: "p",
+            className: "text-gray-500 dark:text-gray-400 max-w-2xl mx-auto",
+            children: "34 predefined colors (12 default + 22 spectrum)"
+          }
+        )
+      ] }),
+      /* @__PURE__ */ e(t, { children: /* @__PURE__ */ e(c, { title: "Preset Palette", children: /* @__PURE__ */ a("div", { className: "space-y-4", children: [
+        /* @__PURE__ */ e("div", { className: "grid grid-cols-1 sm:grid-cols-2 md:grid-cols-3 gap-3", children: n.map((r, o) => /* @__PURE__ */ a(
+          "div",
+          {
+            className: "flex items-center gap-2 p-2 bg-gray-200 dark:bg-gray-800 rounded-lg hover:bg-gray-100 dark:hover:bg-gray-700 transition-colors",
+            children: [
+              /* @__PURE__ */ e(
+                "div",
+                {
+                  className: "w-4 h-4 rounded-full border border-gray-300 dark:border-gray-600 shadow-sm",
+                  style: { backgroundColor: r.color }
+                }
+              ),
+              /* @__PURE__ */ e("span", { className: "text-xs font-medium truncate", children: r.name })
+            ]
+          },
+          o
+        )) }),
+        /* @__PURE__ */ e(
+          l,
+          {
+            tag: "p",
+            className: "text-xs text-gray-500 dark:text-gray-400 mt-2",
+            children: "Spectrum colors use the -50 value from Tucu UI Design Tokens. Default colors use semantic mappings (e.g., blue-60 for primary)."
+          }
+        )
+      ] }) }) })
+    ] })
+  ] });
+};
+export {
+  A as default
+};

package/documentation/ThemeHooksSection-D5hs4bKp.js

@@ -0,0 +1,154 @@
+import { jsxs as t, Fragment as l, jsx as e } from "react/jsx-runtime";
+import { H as c, T as r, ax as o, C as a, a as s } from "../index-lfg6LZ1p.js";
+import { Anchor as d, Zap as n, Palette as h, Globe as m } from "lucide-react";
+import "react-router-dom";
+import "react";
+import "react-dom";
+const w = () => /* @__PURE__ */ t(l, { children: [
+  /* @__PURE__ */ e(
+    c,
+    {
+      title: "Theme Hooks",
+      description: "Powerful hooks for accessing, modifying, and reacting to theme state throughout your application.",
+      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-yellow-500 via-amber-500 to-orange-500 rounded-full flex items-center justify-center shadow-lg", children: /* @__PURE__ */ e(d, { 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(r, { tag: "h2", className: "mb-2", children: "Available Hooks" }),
+      /* @__PURE__ */ e(
+        r,
+        {
+          tag: "p",
+          className: "text-gray-500 dark:text-gray-400 max-w-2xl mx-auto",
+          children: "Three hooks that power the theming system"
+        }
+      )
+    ] }),
+    /* @__PURE__ */ e("div", { className: "grid grid-cols-1 sm:grid-cols-2 lg:grid-cols-3 gap-4 sm:gap-6", children: [
+      {
+        icon: /* @__PURE__ */ e(n, { className: "w-6 h-6 text-white filter drop-shadow-sm" }),
+        title: "useTheme",
+        description: "Main hook — all state, setters, and actions. Zustand-based with localStorage persistence.",
+        iconBgClassName: "from-yellow-500 via-amber-500 to-orange-500"
+      },
+      {
+        icon: /* @__PURE__ */ e(h, { className: "w-6 h-6 text-white filter drop-shadow-sm" }),
+        title: "useThemeColor",
+        description: "Injects 12 CSS variables (6 light/dark pairs) into document root for real-time theming.",
+        iconBgClassName: "from-blue-500 via-cyan-500 to-teal-500"
+      },
+      {
+        icon: /* @__PURE__ */ e(m, { className: "w-6 h-6 text-white filter drop-shadow-sm" }),
+        title: "useDirection",
+        description: "Sets document.documentElement.dir for RTL/LTR layout support.",
+        iconBgClassName: "from-purple-500 via-violet-500 to-indigo-500"
+      }
+    ].map((i) => /* @__PURE__ */ e(o, { layout: "horizontal", ...i }, i.title)) })
+  ] }),
+  /* @__PURE__ */ t("section", { className: "space-y-8", children: [
+    /* @__PURE__ */ t("div", { className: "text-center", children: [
+      /* @__PURE__ */ e(r, { tag: "h2", className: "mb-2", children: "useTheme Hook API" }),
+      /* @__PURE__ */ e(
+        r,
+        {
+          tag: "p",
+          className: "text-gray-500 dark:text-gray-400 max-w-2xl mx-auto",
+          children: "Complete state, setters, and actions reference"
+        }
+      )
+    ] }),
+    /* @__PURE__ */ t("div", { className: "grid grid-cols-1 lg:grid-cols-2 gap-6", children: [
+      /* @__PURE__ */ e(a, { children: /* @__PURE__ */ e(s, { title: "State Properties", children: /* @__PURE__ */ t("div", { className: "space-y-4", children: [
+        /* @__PURE__ */ t(
+          r,
+          {
+            tag: "p",
+            className: "text-gray-600 dark:text-gray-400 text-sm",
+            children: [
+              "Accessed via",
+              " ",
+              /* @__PURE__ */ e("code", { className: "px-1 py-0.5 border border-gray-300 dark:border-gray-600 rounded text-xs", children: "useTheme()" }),
+              " ",
+              "— persisted to localStorage automatically."
+            ]
+          }
+        ),
+        /* @__PURE__ */ t("ul", { className: "text-xs text-gray-600 dark:text-gray-400 space-y-1 ml-4 list-disc", children: [
+          /* @__PURE__ */ e("li", { children: "mode, layout, direction, logo, lang" }),
+          /* @__PURE__ */ e("li", { children: "colorScheme (theme variant: default | macos | macos-tahoe)" }),
+          /* @__PURE__ */ e("li", { children: "primaryPreset, darkPrimaryPreset" }),
+          /* @__PURE__ */ e("li", { children: "secondaryPreset, darkSecondaryPreset" }),
+          /* @__PURE__ */ e("li", { children: "accentPreset, darkAccentPreset" }),
+          /* @__PURE__ */ e("li", { children: "mutedPreset, darkMutedPreset" }),
+          /* @__PURE__ */ e("li", { children: "darkBgPreset, lightBgPreset" }),
+          /* @__PURE__ */ e("li", { children: "lightDarkPreset, darkLightDarkPreset" }),
+          /* @__PURE__ */ e("li", { children: "isSettingsOpen, showSettings" })
+        ] })
+      ] }) }) }),
+      /* @__PURE__ */ e(a, { children: /* @__PURE__ */ e(s, { title: "Setters", children: /* @__PURE__ */ t("div", { className: "space-y-4", children: [
+        /* @__PURE__ */ e(
+          r,
+          {
+            tag: "p",
+            className: "text-gray-600 dark:text-gray-400 text-sm",
+            children: "Each setter updates the store and persists to localStorage."
+          }
+        ),
+        /* @__PURE__ */ t("ul", { className: "text-xs text-gray-600 dark:text-gray-400 space-y-1 ml-4 list-disc", children: [
+          /* @__PURE__ */ e("li", { children: "setMode, setLayout, setDirection" }),
+          /* @__PURE__ */ e("li", { children: "setPrimaryPreset, setDarkPrimaryPreset" }),
+          /* @__PURE__ */ e("li", { children: "setSecondaryPreset, setDarkSecondaryPreset" }),
+          /* @__PURE__ */ e("li", { children: "setAccentPreset, setDarkAccentPreset" }),
+          /* @__PURE__ */ e("li", { children: "setMutedPreset, setDarkMutedPreset" }),
+          /* @__PURE__ */ e("li", { children: "setDarkBgPreset, setLightBgPreset" }),
+          /* @__PURE__ */ e("li", { children: "setLightDarkPreset, setDarkLightDarkPreset" }),
+          /* @__PURE__ */ e("li", { children: "setLogo, setLang, setIsSettingsOpen" }),
+          /* @__PURE__ */ e("li", { children: "setShowSettings" })
+        ] })
+      ] }) }) }),
+      /* @__PURE__ */ e(a, { children: /* @__PURE__ */ e(s, { title: "Actions", children: /* @__PURE__ */ t("div", { className: "space-y-4", children: [
+        /* @__PURE__ */ e(
+          r,
+          {
+            tag: "p",
+            className: "text-gray-600 dark:text-gray-400 text-sm",
+            children: "Compound actions that apply multiple state changes at once."
+          }
+        ),
+        /* @__PURE__ */ t("ul", { className: "text-xs text-gray-600 dark:text-gray-400 space-y-1 ml-4 list-disc", children: [
+          /* @__PURE__ */ e("li", { children: "restoreDefaultColors — resets all color presets to defaults" }),
+          /* @__PURE__ */ e("li", { children: "applyMacOSTheme — sets layout to MACOS + Sonoma style" }),
+          /* @__PURE__ */ e("li", { children: "applyMacOSTahoeTheme — sets layout to MACOS_TAHOE + Tahoe style" }),
+          /* @__PURE__ */ e("li", { children: "applyThemeStyle(style: THEME_VARIANT) — generic applicator for any variant" })
+        ] })
+      ] }) }) }),
+      /* @__PURE__ */ e(a, { children: /* @__PURE__ */ e(s, { title: "useThemeColor Variables", children: /* @__PURE__ */ t("div", { className: "space-y-4", children: [
+        /* @__PURE__ */ t(
+          r,
+          {
+            tag: "p",
+            className: "text-gray-600 dark:text-gray-400 text-sm",
+            children: [
+              "12 CSS variables injected into",
+              " ",
+              /* @__PURE__ */ e("code", { className: "px-1 py-0.5 border border-gray-300 dark:border-gray-600 rounded text-xs", children: "document.documentElement" }),
+              ":"
+            ]
+          }
+        ),
+        /* @__PURE__ */ t("ul", { className: "text-xs text-gray-600 dark:text-gray-400 space-y-1 ml-4 list-disc", children: [
+          /* @__PURE__ */ e("li", { children: "--color-semantic-bg-primary / dark variant" }),
+          /* @__PURE__ */ e("li", { children: "--color-semantic-bg-secondary / dark variant" }),
+          /* @__PURE__ */ e("li", { children: "--color-semantic-accent-bold-yellow / dark variant" }),
+          /* @__PURE__ */ e("li", { children: "--color-semantic-fg-muted / dark variant" }),
+          /* @__PURE__ */ e("li", { children: "--color-semantic-bg / dark variant" }),
+          /* @__PURE__ */ e("li", { children: "--color-semantic-bg-secondary-wash / dark variant" })
+        ] })
+      ] }) }) })
+    ] })
+  ] })
+] });
+export {
+  w as default
+};

package/documentation/ThemeHooksSection-nIFp-F0q.js

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("react/jsx-runtime"),s=require("../index-BaGqriuz.js"),t=require("lucide-react");require("react-router-dom");require("react");require("react-dom");const i=()=>{const a=[{icon:e.jsx(t.Zap,{className:"w-6 h-6 text-white filter drop-shadow-sm"}),title:"useTheme",description:"Main hook — all state, setters, and actions. Zustand-based with localStorage persistence.",iconBgClassName:"from-yellow-500 via-amber-500 to-orange-500"},{icon:e.jsx(t.Palette,{className:"w-6 h-6 text-white filter drop-shadow-sm"}),title:"useThemeColor",description:"Injects 12 CSS variables (6 light/dark pairs) into document root for real-time theming.",iconBgClassName:"from-blue-500 via-cyan-500 to-teal-500"},{icon:e.jsx(t.Globe,{className:"w-6 h-6 text-white filter drop-shadow-sm"}),title:"useDirection",description:"Sets document.documentElement.dir for RTL/LTR layout support.",iconBgClassName:"from-purple-500 via-violet-500 to-indigo-500"}];return e.jsxs(e.Fragment,{children:[e.jsx(s.HeroCard,{title:"Theme Hooks",description:"Powerful hooks for accessing, modifying, and reacting to theme state throughout 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-yellow-500 via-amber-500 to-orange-500 rounded-full flex items-center justify-center shadow-lg",children:e.jsx(t.Anchor,{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:"Available Hooks"}),e.jsx(s.Typography,{tag:"p",className:"text-gray-500 dark:text-gray-400 max-w-2xl mx-auto",children:"Three hooks that power the theming system"})]}),e.jsx("div",{className:"grid grid-cols-1 sm:grid-cols-2 lg:grid-cols-3 gap-4 sm:gap-6",children:a.map(r=>e.jsx(s.FeatureCard,{layout:"horizontal",...r},r.title))})]}),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:"useTheme Hook API"}),e.jsx(s.Typography,{tag:"p",className:"text-gray-500 dark:text-gray-400 max-w-2xl mx-auto",children:"Complete state, setters, and actions reference"})]}),e.jsxs("div",{className:"grid grid-cols-1 lg:grid-cols-2 gap-6",children:[e.jsx(s.CardContainer,{children:e.jsx(s.CardTitle,{title:"State Properties",children:e.jsxs("div",{className:"space-y-4",children:[e.jsxs(s.Typography,{tag:"p",className:"text-gray-600 dark:text-gray-400 text-sm",children:["Accessed via"," ",e.jsx("code",{className:"px-1 py-0.5 border border-gray-300 dark:border-gray-600 rounded text-xs",children:"useTheme()"})," ","— persisted to localStorage automatically."]}),e.jsxs("ul",{className:"text-xs text-gray-600 dark:text-gray-400 space-y-1 ml-4 list-disc",children:[e.jsx("li",{children:"mode, layout, direction, logo, lang"}),e.jsx("li",{children:"colorScheme (theme variant: default | macos | macos-tahoe)"}),e.jsx("li",{children:"primaryPreset, darkPrimaryPreset"}),e.jsx("li",{children:"secondaryPreset, darkSecondaryPreset"}),e.jsx("li",{children:"accentPreset, darkAccentPreset"}),e.jsx("li",{children:"mutedPreset, darkMutedPreset"}),e.jsx("li",{children:"darkBgPreset, lightBgPreset"}),e.jsx("li",{children:"lightDarkPreset, darkLightDarkPreset"}),e.jsx("li",{children:"isSettingsOpen, showSettings"})]})]})})}),e.jsx(s.CardContainer,{children:e.jsx(s.CardTitle,{title:"Setters",children:e.jsxs("div",{className:"space-y-4",children:[e.jsx(s.Typography,{tag:"p",className:"text-gray-600 dark:text-gray-400 text-sm",children:"Each setter updates the store and persists to localStorage."}),e.jsxs("ul",{className:"text-xs text-gray-600 dark:text-gray-400 space-y-1 ml-4 list-disc",children:[e.jsx("li",{children:"setMode, setLayout, setDirection"}),e.jsx("li",{children:"setPrimaryPreset, setDarkPrimaryPreset"}),e.jsx("li",{children:"setSecondaryPreset, setDarkSecondaryPreset"}),e.jsx("li",{children:"setAccentPreset, setDarkAccentPreset"}),e.jsx("li",{children:"setMutedPreset, setDarkMutedPreset"}),e.jsx("li",{children:"setDarkBgPreset, setLightBgPreset"}),e.jsx("li",{children:"setLightDarkPreset, setDarkLightDarkPreset"}),e.jsx("li",{children:"setLogo, setLang, setIsSettingsOpen"}),e.jsx("li",{children:"setShowSettings"})]})]})})}),e.jsx(s.CardContainer,{children:e.jsx(s.CardTitle,{title:"Actions",children:e.jsxs("div",{className:"space-y-4",children:[e.jsx(s.Typography,{tag:"p",className:"text-gray-600 dark:text-gray-400 text-sm",children:"Compound actions that apply multiple state changes at once."}),e.jsxs("ul",{className:"text-xs text-gray-600 dark:text-gray-400 space-y-1 ml-4 list-disc",children:[e.jsx("li",{children:"restoreDefaultColors — resets all color presets to defaults"}),e.jsx("li",{children:"applyMacOSTheme — sets layout to MACOS + Sonoma style"}),e.jsx("li",{children:"applyMacOSTahoeTheme — sets layout to MACOS_TAHOE + Tahoe style"}),e.jsx("li",{children:"applyThemeStyle(style: THEME_VARIANT) — generic applicator for any variant"})]})]})})}),e.jsx(s.CardContainer,{children:e.jsx(s.CardTitle,{title:"useThemeColor Variables",children:e.jsxs("div",{className:"space-y-4",children:[e.jsxs(s.Typography,{tag:"p",className:"text-gray-600 dark:text-gray-400 text-sm",children:["12 CSS variables injected into"," ",e.jsx("code",{className:"px-1 py-0.5 border border-gray-300 dark:border-gray-600 rounded text-xs",children:"document.documentElement"}),":"]}),e.jsxs("ul",{className:"text-xs text-gray-600 dark:text-gray-400 space-y-1 ml-4 list-disc",children:[e.jsx("li",{children:"--color-semantic-bg-primary / dark variant"}),e.jsx("li",{children:"--color-semantic-bg-secondary / dark variant"}),e.jsx("li",{children:"--color-semantic-accent-bold-yellow / dark variant"}),e.jsx("li",{children:"--color-semantic-fg-muted / dark variant"}),e.jsx("li",{children:"--color-semantic-bg / dark variant"}),e.jsx("li",{children:"--color-semantic-bg-secondary-wash / dark variant"})]})]})})})]})]})]})};exports.default=i;

package/documentation/ThemeProviderIntegrationSection-T1FvNpOT.js

@@ -0,0 +1,122 @@
+import { jsxs as t, Fragment as n, jsx as e } from "react/jsx-runtime";
+import { H as i, T as o, C as a, a as r, c as s } from "../index-lfg6LZ1p.js";
+import { Puzzle as m } from "lucide-react";
+import "react-router-dom";
+import "react";
+import "react-dom";
+const P = () => /* @__PURE__ */ t(n, { children: [
+  /* @__PURE__ */ e(
+    i,
+    {
+      title: "ThemeProvider Integration",
+      description: "The routing system is fully integrated with ThemeProvider. It provides seamless navigation, layout management, and theming through the architecturalPatterns prop.",
+      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-blue-500 via-indigo-500 to-purple-500 rounded-full flex items-center justify-center shadow-lg", children: /* @__PURE__ */ e(m, { 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(o, { tag: "h2", className: "mb-2", children: "ThemeProvider Props" }),
+      /* @__PURE__ */ e(
+        o,
+        {
+          tag: "p",
+          className: "text-gray-500 dark:text-gray-400 max-w-2xl mx-auto",
+          children: "The ThemeProvider accepts layout, theming, and routing configuration"
+        }
+      )
+    ] }),
+    /* @__PURE__ */ e(a, { children: /* @__PURE__ */ e(r, { title: "Interface Definition", children: /* @__PURE__ */ e(s, { language: "typescript", code: `interface StandaloneAppProviderProps
+  extends Omit<ThemeWrapperProps, 'menuItems' | 'children'> {
+  menuItems: StandaloneAppRoutesMenuItem[];  // Required: Array of route items
+  customRoutes?: React.ReactElement<typeof Routes>; // Override default routing
+}
+
+interface ThemeWrapperProps {
+  // Layout Configuration
+  themeStyle?: 'default' | 'macos' | 'macos-tahoe';
+  layout?: LAYOUT_OPTIONS; // Values depend on themeStyle
+
+  // Layout values per themeStyle:
+  // default → 'clean' | 'admin' | 'horizontal'
+  // macos → 'macos'
+  // macos-tahoe → 'macos-tahoe' | 'macos-tahoe-dock'
+
+  // Branding
+  logo?: { name: string; secondName?: string };
+  rightButton?: React.ReactNode;
+
+  // Theming
+  brandColor?: PresetColorType;
+  mode?: 'light' | 'dark';
+  customPaletteColor?: { ... };
+
+  // Settings Panel
+  showSettings?: boolean;
+
+  // Layout customization
+  className?: string;
+  headerClassName?: string;
+  contentClassName?: string;
+  fullWidth?: boolean;
+}` }) }) })
+  ] }),
+  /* @__PURE__ */ t("section", { className: "space-y-8", children: [
+    /* @__PURE__ */ t("div", { className: "text-center", children: [
+      /* @__PURE__ */ e(o, { tag: "h2", className: "mb-2", children: "Usage Examples" }),
+      /* @__PURE__ */ e(
+        o,
+        {
+          tag: "p",
+          className: "text-gray-500 dark:text-gray-400 max-w-2xl mx-auto",
+          children: "Custom layout and routing override patterns"
+        }
+      )
+    ] }),
+    /* @__PURE__ */ t("div", { className: "grid grid-cols-1 lg:grid-cols-2 gap-6", children: [
+      /* @__PURE__ */ e(a, { children: /* @__PURE__ */ e(r, { title: "Custom Layout", children: /* @__PURE__ */ e(s, { language: "tsx", code: `import { ThemeProvider } from '@e-burgos/tucu-ui';
+
+function CustomLayoutApp() {
+  return (
+    <ThemeProvider
+      themeStyle="default"
+      layout="admin"
+      menuItems={menuItems}
+      logo={{ name: 'My', secondName: 'App' }}
+      rightButton={
+        <div className="flex gap-2">
+          <Button variant="ghost" size="small">
+            Profile
+          </Button>
+          <Button variant="ghost" size="small">
+            Logout
+          </Button>
+        </div>
+      }
+      headerClassName="bg-brand/5 border-b border-brand/20"
+      contentClassName="max-w-7xl mx-auto"
+      fullWidth={false}
+    />
+  );
+}` }) }) }),
+      /* @__PURE__ */ e(a, { children: /* @__PURE__ */ e(r, { title: "Custom Routes Override", children: /* @__PURE__ */ e(s, { language: "tsx", code: `import { ThemeProvider } from '@e-burgos/tucu-ui';
+
+function App() {
+  return (
+    <ThemeProvider
+      menuItems={menuItems}
+      customRoutes={
+        <Routes>
+          <Route path="/" element={<HomePage />} />
+          <Route path="/custom" element={<CustomPage />} />
+          <Route path="*" element={<NotFoundPage />} />
+        </Routes>
+      }
+    />
+  );
+}` }) }) })
+    ] })
+  ] })
+] });
+export {
+  P as default
+};

package/documentation/ThemeProviderIntegrationSection-hBvjgSG1.js

@@ -0,0 +1,73 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("react/jsx-runtime"),t=require("../index-BaGqriuz.js"),o=require("lucide-react");require("react-router-dom");require("react");require("react-dom");const a=()=>e.jsxs(e.Fragment,{children:[e.jsx(t.HeroCard,{title:"ThemeProvider Integration",description:"The routing system is fully integrated with ThemeProvider. It provides seamless navigation, layout management, and theming through the architecturalPatterns prop.",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-purple-500 rounded-full flex items-center justify-center shadow-lg",children:e.jsx(o.Puzzle,{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(t.Typography,{tag:"h2",className:"mb-2",children:"ThemeProvider Props"}),e.jsx(t.Typography,{tag:"p",className:"text-gray-500 dark:text-gray-400 max-w-2xl mx-auto",children:"The ThemeProvider accepts layout, theming, and routing configuration"})]}),e.jsx(t.CardContainer,{children:e.jsx(t.CardTitle,{title:"Interface Definition",children:e.jsx(t.CodeBlock,{language:"typescript",code:`interface StandaloneAppProviderProps
+  extends Omit<ThemeWrapperProps, 'menuItems' | 'children'> {
+  menuItems: StandaloneAppRoutesMenuItem[];  // Required: Array of route items
+  customRoutes?: React.ReactElement<typeof Routes>; // Override default routing
+}
+
+interface ThemeWrapperProps {
+  // Layout Configuration
+  themeStyle?: 'default' | 'macos' | 'macos-tahoe';
+  layout?: LAYOUT_OPTIONS; // Values depend on themeStyle
+
+  // Layout values per themeStyle:
+  // default → 'clean' | 'admin' | 'horizontal'
+  // macos → 'macos'
+  // macos-tahoe → 'macos-tahoe' | 'macos-tahoe-dock'
+
+  // Branding
+  logo?: { name: string; secondName?: string };
+  rightButton?: React.ReactNode;
+
+  // Theming
+  brandColor?: PresetColorType;
+  mode?: 'light' | 'dark';
+  customPaletteColor?: { ... };
+
+  // Settings Panel
+  showSettings?: boolean;
+
+  // Layout customization
+  className?: string;
+  headerClassName?: string;
+  contentClassName?: string;
+  fullWidth?: boolean;
+}`})})})]}),e.jsxs("section",{className:"space-y-8",children:[e.jsxs("div",{className:"text-center",children:[e.jsx(t.Typography,{tag:"h2",className:"mb-2",children:"Usage Examples"}),e.jsx(t.Typography,{tag:"p",className:"text-gray-500 dark:text-gray-400 max-w-2xl mx-auto",children:"Custom layout and routing override patterns"})]}),e.jsxs("div",{className:"grid grid-cols-1 lg:grid-cols-2 gap-6",children:[e.jsx(t.CardContainer,{children:e.jsx(t.CardTitle,{title:"Custom Layout",children:e.jsx(t.CodeBlock,{language:"tsx",code:`import { ThemeProvider } from '@e-burgos/tucu-ui';
+
+function CustomLayoutApp() {
+  return (
+    <ThemeProvider
+      themeStyle="default"
+      layout="admin"
+      menuItems={menuItems}
+      logo={{ name: 'My', secondName: 'App' }}
+      rightButton={
+        <div className="flex gap-2">
+          <Button variant="ghost" size="small">
+            Profile
+          </Button>
+          <Button variant="ghost" size="small">
+            Logout
+          </Button>
+        </div>
+      }
+      headerClassName="bg-brand/5 border-b border-brand/20"
+      contentClassName="max-w-7xl mx-auto"
+      fullWidth={false}
+    />
+  );
+}`})})}),e.jsx(t.CardContainer,{children:e.jsx(t.CardTitle,{title:"Custom Routes Override",children:e.jsx(t.CodeBlock,{language:"tsx",code:`import { ThemeProvider } from '@e-burgos/tucu-ui';
+
+function App() {
+  return (
+    <ThemeProvider
+      menuItems={menuItems}
+      customRoutes={
+        <Routes>
+          <Route path="/" element={<HomePage />} />
+          <Route path="/custom" element={<CustomPage />} />
+          <Route path="*" element={<NotFoundPage />} />
+        </Routes>
+      }
+    />
+  );
+}`})})})]})]})]});exports.default=a;

package/documentation/{ThemeProviderRequiredSection-DqP08VHV.js → ThemeProviderRequiredSection-03ZYoeWQ.js}

@@ -1,13 +1,32 @@
-import { jsxs as r, Fragment as t, jsx as e } from "react/jsx-runtime";
-import { ag as a, C as d, a as n, T as o } from "../index-B919yoKU.js";
-import { AlertTriangle as i } from "lucide-react";
+import { jsxs as r, Fragment as o, jsx as e } from "react/jsx-runtime";
+import { H as a, T as t, aj as d, C as i, a as n } from "../index-lfg6LZ1p.js";
+import { Shield as s, AlertTriangle as l } from "lucide-react";
 import "react-router-dom";
 import "react";
 import "react-dom";
-const g = () => /* @__PURE__ */ r(t, { children: [
-  /* @__PURE__ */ e(a, { variant: "warning", children: /* @__PURE__ */ r("div", { children: [
+const y = () => /* @__PURE__ */ r(o, { children: [
+  /* @__PURE__ */ e(
+    a,
+    {
+      title: "ThemeProvider Required",
+      description: "Essential prerequisite for using the layout system and theme hooks. All layout components depend on the theme context.",
+      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(s, { className: "w-10 h-10 sm:w-12 sm:h-12 md:w-16 md:h-16 text-white filter drop-shadow-lg" }) })
+    }
+  ),
+  /* @__PURE__ */ r("div", { className: "text-center", children: [
+    /* @__PURE__ */ e(t, { tag: "h2", className: "mb-2", children: "ThemeProvider Required" }),
+    /* @__PURE__ */ e(
+      t,
+      {
+        tag: "p",
+        className: "text-gray-500 dark:text-gray-400 max-w-2xl mx-auto",
+        children: "Essential prerequisite for using the layout system and theme hooks"
+      }
+    )
+  ] }),
+  /* @__PURE__ */ e(d, { variant: "warning", children: /* @__PURE__ */ r("div", { children: [
     /* @__PURE__ */ r("div", { className: "flex items-center gap-2 font-semibold", children: [
-      /* @__PURE__ */ e(i, { className: "h-4 w-4" }),
+      /* @__PURE__ */ e(l, { className: "h-4 w-4" }),
       "ThemeProvider Required"
     ] }),
     /* @__PURE__ */ r("div", { children: [
@@ -17,8 +36,8 @@ const g = () => /* @__PURE__ */ r(t, { children: [
       "."
     ] })
   ] }) }),
-  /* @__PURE__ */ e(d, { className: "overflow-hidden", children: /* @__PURE__ */ e(n, { title: "Routing System", className: "mt-2 mb-2", children: /* @__PURE__ */ r("div", { className: "w-full space-y-6 p-4 sm:p-6", children: [
-    /* @__PURE__ */ r(o, { tag: "p", className: "text-gray-600 dark:text-gray-400", children: [
+  /* @__PURE__ */ e(i, { className: "overflow-hidden", children: /* @__PURE__ */ e(n, { title: "Routing System", className: "mt-2 mb-2", children: /* @__PURE__ */ r("div", { className: "w-full space-y-6 p-4 sm:p-6", children: [
+    /* @__PURE__ */ r(t, { tag: "p", className: "text-gray-600 dark:text-gray-400", children: [
       /* @__PURE__ */ e("strong", { children: "ThemeProvider" }),
       " includes",
       " ",
@@ -28,9 +47,9 @@ const g = () => /* @__PURE__ */ r(t, { children: [
     ] }),
     /* @__PURE__ */ r("div", { className: "space-y-4", children: [
       /* @__PURE__ */ r("div", { className: "p-4 bg-blue-50 dark:bg-blue-900/20 rounded-lg border border-blue-200 dark:border-blue-800", children: [
-        /* @__PURE__ */ e(o, { tag: "h4", className: "font-semibold mb-2", children: "1. Automatic Routing (Default)" }),
+        /* @__PURE__ */ e(t, { tag: "h4", className: "font-semibold mb-2", children: "1. Automatic Routing (Default)" }),
         /* @__PURE__ */ r(
-          o,
+          t,
           {
             tag: "p",
             className: "text-sm text-gray-700 dark:text-gray-300 mb-2",
@@ -45,7 +64,7 @@ const g = () => /* @__PURE__ */ r(t, { children: [
           }
         ),
         /* @__PURE__ */ r(
-          o,
+          t,
           {
             tag: "p",
             className: "text-xs text-gray-600 dark:text-gray-400",
@@ -59,9 +78,9 @@ const g = () => /* @__PURE__ */ r(t, { children: [
         )
       ] }),
       /* @__PURE__ */ r("div", { className: "p-4 bg-green-50 dark:bg-green-900/20 rounded-lg border border-green-200 dark:border-green-800", children: [
-        /* @__PURE__ */ e(o, { tag: "h4", className: "font-semibold mb-2", children: "2. Custom Routing" }),
+        /* @__PURE__ */ e(t, { tag: "h4", className: "font-semibold mb-2", children: "2. Custom Routing" }),
         /* @__PURE__ */ r(
-          o,
+          t,
           {
             tag: "p",
             className: "text-sm text-gray-700 dark:text-gray-300 mb-2",
@@ -76,7 +95,7 @@ const g = () => /* @__PURE__ */ r(t, { children: [
           }
         ),
         /* @__PURE__ */ r(
-          o,
+          t,
           {
             tag: "p",
             className: "text-xs text-gray-600 dark:text-gray-400",
@@ -91,5 +110,5 @@ const g = () => /* @__PURE__ */ r(t, { children: [
   ] }) }) })
 ] });
 export {
-  g as default
+  y as default
 };

package/documentation/ThemeProviderRequiredSection-MqNAwToF.js

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("react/jsx-runtime"),r=require("../index-BaGqriuz.js"),t=require("lucide-react");require("react-router-dom");require("react");require("react-dom");const s=()=>e.jsxs(e.Fragment,{children:[e.jsx(r.HeroCard,{title:"ThemeProvider Required",description:"Essential prerequisite for using the layout system and theme hooks. All layout components depend on the theme context.",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.Shield,{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(r.Typography,{tag:"h2",className:"mb-2",children:"ThemeProvider Required"}),e.jsx(r.Typography,{tag:"p",className:"text-gray-500 dark:text-gray-400 max-w-2xl mx-auto",children:"Essential prerequisite for using the layout system and theme hooks"})]}),e.jsx(r.Alert,{variant:"warning",children:e.jsxs("div",{children:[e.jsxs("div",{className:"flex items-center gap-2 font-semibold",children:[e.jsx(t.AlertTriangle,{className:"h-4 w-4"}),"ThemeProvider Required"]}),e.jsxs("div",{children:["Before using any layout components or theme hooks, you MUST wrap your application with ThemeProvider. All layout components and theme hooks depend on the theme context provided by ThemeProvider. Located in"," ",e.jsx("code",{className:"px-1 py-0.5 border border-gray-300 dark:border-gray-700 rounded text-xs",children:"ui/tucu-ui/src/themes/components/theme-provider"}),"."]})]})}),e.jsx(r.CardContainer,{className:"overflow-hidden",children:e.jsx(r.CardTitle,{title:"Routing System",className:"mt-2 mb-2",children:e.jsxs("div",{className:"w-full space-y-6 p-4 sm:p-6",children:[e.jsxs(r.Typography,{tag:"p",className:"text-gray-600 dark:text-gray-400",children:[e.jsx("strong",{children:"ThemeProvider"})," includes"," ",e.jsx("code",{className:"px-1 py-0.5 border border-gray-300 dark:border-gray-700 rounded text-xs",children:"BrowserRouter"})," ","from React Router and handles routing automatically. You have two options:"]}),e.jsxs("div",{className:"space-y-4",children:[e.jsxs("div",{className:"p-4 bg-blue-50 dark:bg-blue-900/20 rounded-lg border border-blue-200 dark:border-blue-800",children:[e.jsx(r.Typography,{tag:"h4",className:"font-semibold mb-2",children:"1. Automatic Routing (Default)"}),e.jsxs(r.Typography,{tag:"p",className:"text-sm text-gray-700 dark:text-gray-300 mb-2",children:["Provide ",e.jsx("code",{children:"menuItems"})," with ",e.jsx("code",{children:"component"})," ","prop. ThemeProvider will automatically generate routes from your menu items."]}),e.jsxs(r.Typography,{tag:"p",className:"text-xs text-gray-600 dark:text-gray-400",children:[e.jsx("strong",{children:"Use when:"})," You want routing based on menu items. Each menu item with a ",e.jsx("code",{children:"component"})," prop becomes a route."]})]}),e.jsxs("div",{className:"p-4 bg-green-50 dark:bg-green-900/20 rounded-lg border border-green-200 dark:border-green-800",children:[e.jsx(r.Typography,{tag:"h4",className:"font-semibold mb-2",children:"2. Custom Routing"}),e.jsxs(r.Typography,{tag:"p",className:"text-sm text-gray-700 dark:text-gray-300 mb-2",children:["Provide ",e.jsx("code",{children:"customRoutes"})," prop with your own"," ",e.jsx("code",{children:"<Routes>"})," component. This gives you full control over routing."]}),e.jsxs(r.Typography,{tag:"p",className:"text-xs text-gray-600 dark:text-gray-400",children:[e.jsx("strong",{children:"Use when:"})," You need custom routing logic, landing pages without navigation, or complex routing scenarios."]})]})]})]})})})]});exports.default=s;

package/documentation/ThemeProviderSection-FaRMSgB9.js

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("react/jsx-runtime"),t=require("../index-BaGqriuz.js"),i=require("lucide-react");require("react-router-dom");require("react");require("react-dom");const n=()=>{const o=[{key:"prop",label:"Prop"},{key:"type",label:"Type"},{key:"default",label:"Default"},{key:"description",label:"Description"}],s=[{prop:"menuItems",type:"IMenuItem[]",default:"Required",description:"Navigation menu items"},{prop:"themeStyle",type:"'default' | 'macos' | 'macos-tahoe'",default:"'default'",description:"Visual theme variant — constrains available layouts"},{prop:"layout",type:"LAYOUT_OPTIONS",default:"HORIZONTAL",description:"Layout type (constrained by themeStyle)"},{prop:"mode",type:"'light' | 'dark'",default:"'dark'",description:"Color mode"},{prop:"showSettings",type:"boolean",default:"false",description:"Show theme settings drawer button"},{prop:"customPaletteColor",type:"object",default:"-",description:"Custom color palette with 12 color slots (primary, darkPrimary, secondary, etc.)"},{prop:"logo",type:"LogoType",default:"{ path: '/', name: '' }",description:"Logo configuration object with path and name"},{prop:"brandColor",type:"PresetColorType",default:"-",description:"Brand color preset name"},{prop:"headerClassName",type:"string",default:"-",description:"Custom CSS classes for header"},{prop:"contentClassName",type:"string",default:"-",description:"Custom CSS classes for content area"},{prop:"fullWidth",type:"boolean",default:"false",description:"Enable full width layout"},{prop:"rightButton",type:"ReactNode",default:"-",description:"Custom button component for header right area"},{prop:"className",type:"string",default:"-",description:"Custom CSS classes for root layout"},{prop:"setCurrentPathname",type:"(pathname: string) => void",default:"-",description:"Callback invoked on route change with current pathname"}];return e.jsxs(e.Fragment,{children:[e.jsx(t.HeroCard,{title:"ThemeProvider Component",description:"The root component that wraps your application, manages all theme state, handles routing, and applies color configurations.",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-cyan-500 to-teal-500 rounded-full flex items-center justify-center shadow-lg",children:e.jsx(i.Component,{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(t.Typography,{tag:"h2",className:"mb-2",children:"Props Reference"}),e.jsx(t.Typography,{tag:"p",className:"text-gray-500 dark:text-gray-400 max-w-2xl mx-auto",children:"Complete list of ThemeProvider configuration props"})]}),e.jsx(t.CardContainer,{children:e.jsx(t.CardTitle,{title:"ThemeProvider Props",children:e.jsxs("div",{className:"space-y-6",children:[e.jsxs(t.Typography,{tag:"p",className:"text-gray-600 dark:text-gray-400",children:["Located in"," ",e.jsx("code",{className:"px-1 py-0.5 border border-gray-300 dark:border-gray-600 rounded text-xs",children:"ui/tucu-ui/src/themes/components/theme-provider/"})]}),e.jsx(t.BasicTable,{columns:o.map(r=>({...r,render:a=>r.key==="prop"?e.jsx("code",{className:"text-xs text-brand",children:String(a??"")}):r.key==="type"||r.key==="default"?e.jsx("code",{className:"text-xs text-gray-600 dark:text-gray-400",children:String(a??"")}):r.key==="description"?e.jsx("span",{className:"text-xs text-gray-600 dark:text-gray-400",children:String(a??"")}):String(a??"")})),data:s,containerClassName:"mb-4"})]})})})]})]})};exports.default=n;