@e-burgos/tucu-ui 2.0.7 → 2.0.9

package/documentation/TestingSection-sjNf_YR6.js

@@ -0,0 +1,36 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("react/jsx-runtime"),t=require("../index-BaGqriuz.js"),s=require("lucide-react");require("react-router-dom");require("react");require("react-dom");const l=()=>{const r=[{icon:e.jsx(s.Scan,{className:"w-6 h-6 text-white filter drop-shadow-sm"}),title:"jest-axe",description:"Automated WCAG violation detection in unit tests. Run axe-core checks on rendered components.",iconBgClassName:"from-red-500 to-pink-500"},{icon:e.jsx(s.Monitor,{className:"w-6 h-6 text-white filter drop-shadow-sm"}),title:"Lighthouse",description:"Full page accessibility audit with scoring. Available in Chrome DevTools or CI pipelines.",iconBgClassName:"from-blue-500 to-indigo-500"},{icon:e.jsx(s.Accessibility,{className:"w-6 h-6 text-white filter drop-shadow-sm"}),title:"Screen Reader Testing",description:"Manual testing with VoiceOver (macOS), NVDA (Windows), or Orca (Linux) to verify announcements.",iconBgClassName:"from-purple-500 to-violet-500"},{icon:e.jsx(s.Keyboard,{className:"w-6 h-6 text-white filter drop-shadow-sm"}),title:"Keyboard-Only Testing",description:"Navigate the entire interface using only Tab, Arrow keys, Enter, and Escape. No mouse allowed.",iconBgClassName:"from-teal-500 to-cyan-500"}],o=`import { render } from '@testing-library/react';
+import { axe, toHaveNoViolations } from 'jest-axe';
+import { Input, Modal, Alert, Select } from '@e-burgos/tucu-ui';
+
+expect.extend(toHaveNoViolations);
+
+describe('Accessibility Tests', () => {
+  it('Input has no violations', async () => {
+    const { container } = render(
+      <Input label="Email" required helperText="Enter your email" />
+    );
+    const results = await axe(container);
+    expect(results).toHaveNoViolations();
+  });
+
+  it('Alert has no violations', async () => {
+    const { container } = render(
+      <Alert variant="warning">Important message</Alert>
+    );
+    const results = await axe(container);
+    expect(results).toHaveNoViolations();
+  });
+
+  it('Select has no violations', async () => {
+    const { container } = render(
+      <Select
+        label="Country"
+        options={[{ name: 'Argentina', value: 'ar' }]}
+        value=""
+        onSelect={() => {}}
+      />
+    );
+    const results = await axe(container);
+    expect(results).toHaveNoViolations();
+  });
+});`,n=["Tab through all interactive elements — verify logical order","Press Escape on modals, drawers, selects — verify they close","Arrow keys in Tabs and Select — verify correct navigation","Check visible focus rings on all focusable elements","Verify color contrast ≥ 4.5:1 (use browser inspector)","Test with VoiceOver/NVDA — verify announcements make sense","Resize to 200% zoom — verify no content is hidden or overlapping","Disable CSS — verify content order is logical"];return e.jsxs(e.Fragment,{children:[e.jsx(t.HeroCard,{title:"Accessibility Testing",description:"Strategies for testing accessibility — automated tools catch ~30% of issues, manual testing catches the rest.",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-teal-500 via-cyan-500 to-blue-500 rounded-full flex items-center justify-center shadow-lg",children:e.jsx(s.TestTube,{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:"Testing Tools"}),e.jsx(t.Typography,{tag:"p",className:"text-gray-500 dark:text-gray-400 max-w-2xl mx-auto",children:"Recommended tools for accessibility validation"})]}),e.jsx("div",{className:"grid grid-cols-1 sm:grid-cols-2 gap-4 sm:gap-6",children:r.map(a=>e.jsx(t.FeatureCard,{layout:"horizontal",...a},a.title))})]}),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:"Automated Tests with jest-axe"}),e.jsx(t.Typography,{tag:"p",className:"text-gray-500 dark:text-gray-400 max-w-2xl mx-auto",children:"Add axe-core checks to your existing test suite"})]}),e.jsx(t.CodeBlock,{language:"tsx",code:o})]}),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:"Manual Testing Checklist"}),e.jsx(t.Typography,{tag:"p",className:"text-gray-500 dark:text-gray-400 max-w-2xl mx-auto",children:"Steps to manually verify accessibility"})]}),e.jsx(t.CardContainer,{children:e.jsx("div",{className:"w-full p-4 sm:p-6 space-y-3",children:n.map((a,i)=>e.jsxs("div",{className:"flex items-start gap-3",children:[e.jsx("div",{className:"flex items-center justify-center w-6 h-6 rounded-full bg-blue-100 dark:bg-blue-900/30 shrink-0 mt-0.5",children:e.jsx(t.Typography,{tag:"span",className:"text-xs font-semibold text-blue-600 dark:text-blue-400",children:i+1})}),e.jsx(t.Typography,{tag:"p",className:"text-sm text-gray-600 dark:text-gray-400",children:a})]},i))})})]})]})};exports.default=l;

package/documentation/TextareaSection-B7E_PE99.js

@@ -0,0 +1,34 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("react/jsx-runtime"),l=require("react"),a=require("../index-BaGqriuz.js"),m=require("lucide-react");require("react-router-dom");require("react-dom");const x=()=>{const[t,o]=l.useState(""),[i,n]=l.useState(""),d=[{label:"Primary",color:"primary"},{label:"Secondary",color:"secondary"},{label:"Danger",color:"danger"},{label:"Info",color:"info"},{label:"Success",color:"success"},{label:"Warning",color:"warning"}],c=[{label:"Small",size:"sm"},{label:"Medium",size:"md"},{label:"Large",size:"lg"}];return e.jsxs(e.Fragment,{children:[e.jsx(a.HeroCard,{title:"Textarea",description:"A multi-line text input component for longer text content.",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-rose-500 via-pink-500 to-fuchsia-500 rounded-full flex items-center justify-center shadow-lg border border-rose-500/50",children:e.jsx(m.AlignLeft,{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(a.CardContainer,{className:"overflow-hidden",children:e.jsx(a.CardTitle,{title:"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 md:grid-cols-2 gap-4",children:[e.jsxs(a.CardContainer,{className:"p-4",children:[e.jsx(a.Typography,{tag:"h5",className:"mb-3",children:"Basic Textarea"}),e.jsx(a.Textarea,{label:"Message",placeholder:"Write your message here",value:t,onChange:r=>o(r.target.value),rows:4})]}),e.jsxs(a.CardContainer,{className:"p-4",children:[e.jsx(a.Typography,{tag:"h5",className:"mb-3",children:"With Helper Text"}),e.jsx(a.Textarea,{label:"Description",placeholder:"Enter description",helperText:"Provide a detailed description",rows:4})]}),e.jsxs(a.CardContainer,{className:"p-4",children:[e.jsx(a.Typography,{tag:"h5",className:"mb-3",children:"With Error"}),e.jsx(a.Textarea,{label:"Comments",placeholder:"Enter comments",error:"Comments are required",rows:4})]}),e.jsxs(a.CardContainer,{className:"p-4",children:[e.jsx(a.Typography,{tag:"h5",className:"mb-3",children:"Disabled"}),e.jsx(a.Textarea,{label:"Notes",placeholder:"Disabled textarea",disabled:!0,rows:4})]})]})})})}),e.jsx(a.CardContainer,{className:"overflow-hidden",children:e.jsx(a.CardTitle,{title:"Variants",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-4",children:[e.jsxs(a.CardContainer,{className:"p-4",children:[e.jsx(a.Typography,{tag:"h5",className:"mb-3",children:"Ghost (default)"}),e.jsx(a.Textarea,{label:"Ghost Variant",placeholder:"Enter text",variant:"ghost",rows:3})]}),e.jsxs(a.CardContainer,{className:"p-4",children:[e.jsx(a.Typography,{tag:"h5",className:"mb-3",children:"Solid"}),e.jsx(a.Textarea,{label:"Solid Variant",placeholder:"Enter text",variant:"solid",rows:3})]}),e.jsxs(a.CardContainer,{className:"p-4",children:[e.jsx(a.Typography,{tag:"h5",className:"mb-3",children:"Transparent"}),e.jsx(a.Textarea,{label:"Transparent Variant",placeholder:"Enter text",variant:"transparent",rows:3})]})]})})})}),e.jsx(a.CardContainer,{className:"overflow-hidden",children:e.jsx(a.CardTitle,{title:"Colors",className:"mt-2 mb-2",children:e.jsx("div",{className:"w-full p-4 sm:p-6",children:e.jsx("div",{className:"grid grid-cols-1 gap-4 sm:grid-cols-2 xl:grid-cols-3",children:d.map(({label:r,color:s})=>e.jsxs(a.CardContainer,{className:"p-4",children:[e.jsx(a.Typography,{tag:"h5",className:"mb-3",children:r}),e.jsx(a.Textarea,{label:`${r} Textarea`,placeholder:"Enter text",rows:3,color:s})]},s))})})})}),e.jsx(a.CardContainer,{className:"overflow-hidden",children:e.jsx(a.CardTitle,{title:"Sizes",className:"mt-2 mb-2",children:e.jsx("div",{className:"w-full p-4 sm:p-6",children:e.jsx("div",{className:"grid grid-cols-1 gap-4 md:grid-cols-3",children:c.map(({label:r,size:s})=>e.jsxs(a.CardContainer,{className:"p-4",children:[e.jsx(a.Typography,{tag:"h5",className:"mb-3",children:r}),e.jsx(a.Textarea,{label:`${r} Textarea`,placeholder:"Enter text",rows:3,size:s})]},s))})})})}),e.jsx(a.PropPlayground,{componentName:"Textarea",defaultValues:{label:"Preview Textarea",placeholder:"Enter text",variant:"ghost",color:"primary",size:"md",rows:4,helperText:"",error:"",useUppercaseLabel:!1,disabled:!1},controlOverrides:[{name:"placeholder",type:"text",description:"Placeholder text rendered inside the textarea"},{name:"color",type:"select",options:["primary","secondary","danger","info","success","warning"],description:"Color treatment applied to the control"},{name:"rows",type:"number",description:"Visible row count for the textarea preview"},{name:"disabled",type:"boolean",description:"Disables the textarea and prevents interaction"}],includeProps:["label","placeholder","variant","color","size","rows","helperText","error","useUppercaseLabel","disabled"],excludeProps:["inputClassName"],children:r=>e.jsx("div",{className:"w-full max-w-lg",children:e.jsx(a.Textarea,{...r,rows:typeof r.rows=="number"?r.rows:4,placeholder:r.placeholder||"Enter text",value:i,onChange:s=>n(s.target.value)})})}),e.jsx(a.AutoPropsTable,{componentName:"Textarea"}),e.jsx(a.CardContainer,{className:"overflow-hidden",children:e.jsx(a.CardTitle,{title:"Code Example",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 { Textarea } from '@e-burgos/tucu-ui';
+
+<Textarea
+  label="Message"
+  placeholder="Write your message here"
+  value={value}
+  onChange={(e) => setValue(e.target.value)}
+  rows={4}
+/>
+
+<Textarea
+  label="Description"
+  placeholder="Enter description"
+  helperText="Provide a detailed description"
+  rows={4}
+/>
+
+// Variants
+<Textarea label="Ghost" variant="ghost" rows={4} />
+<Textarea label="Solid" variant="solid" rows={4} />
+<Textarea label="Transparent" variant="transparent" rows={4} />
+
+// Colors
+<Textarea label="Primary" color="primary" rows={4} />
+<Textarea label="Secondary" color="secondary" rows={4} />
+<Textarea label="Danger" color="danger" rows={4} />
+<Textarea label="Info" color="info" rows={4} />
+<Textarea label="Success" color="success" rows={4} />
+<Textarea label="Warning" color="warning" rows={4} />
+
+// Sizes
+<Textarea label="Small" size="sm" rows={3} />
+<Textarea label="Medium" size="md" rows={4} />
+<Textarea label="Large" size="lg" rows={5} />`})})})})]})};exports.default=x;

package/documentation/TextareaSection-CD-kZuGl.js

@@ -0,0 +1,258 @@
+import { jsxs as l, Fragment as b, jsx as e } from "react/jsx-runtime";
+import { useState as c } from "react";
+import { H as x, C as a, a as i, T as t, v as s, P as u, A as w, c as N } from "../index-lfg6LZ1p.js";
+import { AlignLeft as v } from "lucide-react";
+import "react-router-dom";
+import "react-dom";
+const P = () => {
+  const [n, d] = c(""), [m, h] = c(""), p = [
+    { label: "Primary", color: "primary" },
+    { label: "Secondary", color: "secondary" },
+    { label: "Danger", color: "danger" },
+    { label: "Info", color: "info" },
+    { label: "Success", color: "success" },
+    { label: "Warning", color: "warning" }
+  ], g = [
+    { label: "Small", size: "sm" },
+    { label: "Medium", size: "md" },
+    { label: "Large", size: "lg" }
+  ];
+  return /* @__PURE__ */ l(b, { children: [
+    /* @__PURE__ */ e(
+      x,
+      {
+        title: "Textarea",
+        description: "A multi-line text input component for longer text content.",
+        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-rose-500 via-pink-500 to-fuchsia-500 rounded-full flex items-center justify-center shadow-lg border border-rose-500/50", children: /* @__PURE__ */ e(v, { 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(a, { className: "overflow-hidden", children: /* @__PURE__ */ e(i, { title: "Examples", className: "mt-2 mb-2", children: /* @__PURE__ */ e("div", { className: "w-full p-4 sm:p-6", children: /* @__PURE__ */ l("div", { className: "grid grid-cols-1 md:grid-cols-2 gap-4", children: [
+      /* @__PURE__ */ l(a, { className: "p-4", children: [
+        /* @__PURE__ */ e(t, { tag: "h5", className: "mb-3", children: "Basic Textarea" }),
+        /* @__PURE__ */ e(
+          s,
+          {
+            label: "Message",
+            placeholder: "Write your message here",
+            value: n,
+            onChange: (r) => d(r.target.value),
+            rows: 4
+          }
+        )
+      ] }),
+      /* @__PURE__ */ l(a, { className: "p-4", children: [
+        /* @__PURE__ */ e(t, { tag: "h5", className: "mb-3", children: "With Helper Text" }),
+        /* @__PURE__ */ e(
+          s,
+          {
+            label: "Description",
+            placeholder: "Enter description",
+            helperText: "Provide a detailed description",
+            rows: 4
+          }
+        )
+      ] }),
+      /* @__PURE__ */ l(a, { className: "p-4", children: [
+        /* @__PURE__ */ e(t, { tag: "h5", className: "mb-3", children: "With Error" }),
+        /* @__PURE__ */ e(
+          s,
+          {
+            label: "Comments",
+            placeholder: "Enter comments",
+            error: "Comments are required",
+            rows: 4
+          }
+        )
+      ] }),
+      /* @__PURE__ */ l(a, { className: "p-4", children: [
+        /* @__PURE__ */ e(t, { tag: "h5", className: "mb-3", children: "Disabled" }),
+        /* @__PURE__ */ e(
+          s,
+          {
+            label: "Notes",
+            placeholder: "Disabled textarea",
+            disabled: !0,
+            rows: 4
+          }
+        )
+      ] })
+    ] }) }) }) }),
+    /* @__PURE__ */ e(a, { className: "overflow-hidden", children: /* @__PURE__ */ e(i, { title: "Variants", className: "mt-2 mb-2", children: /* @__PURE__ */ e("div", { className: "w-full p-4 sm:p-6", children: /* @__PURE__ */ l("div", { className: "grid grid-cols-1 md:grid-cols-3 gap-4", children: [
+      /* @__PURE__ */ l(a, { className: "p-4", children: [
+        /* @__PURE__ */ e(t, { tag: "h5", className: "mb-3", children: "Ghost (default)" }),
+        /* @__PURE__ */ e(
+          s,
+          {
+            label: "Ghost Variant",
+            placeholder: "Enter text",
+            variant: "ghost",
+            rows: 3
+          }
+        )
+      ] }),
+      /* @__PURE__ */ l(a, { className: "p-4", children: [
+        /* @__PURE__ */ e(t, { tag: "h5", className: "mb-3", children: "Solid" }),
+        /* @__PURE__ */ e(
+          s,
+          {
+            label: "Solid Variant",
+            placeholder: "Enter text",
+            variant: "solid",
+            rows: 3
+          }
+        )
+      ] }),
+      /* @__PURE__ */ l(a, { className: "p-4", children: [
+        /* @__PURE__ */ e(t, { tag: "h5", className: "mb-3", children: "Transparent" }),
+        /* @__PURE__ */ e(
+          s,
+          {
+            label: "Transparent Variant",
+            placeholder: "Enter text",
+            variant: "transparent",
+            rows: 3
+          }
+        )
+      ] })
+    ] }) }) }) }),
+    /* @__PURE__ */ e(a, { className: "overflow-hidden", children: /* @__PURE__ */ e(i, { title: "Colors", className: "mt-2 mb-2", children: /* @__PURE__ */ e("div", { className: "w-full p-4 sm:p-6", children: /* @__PURE__ */ e("div", { className: "grid grid-cols-1 gap-4 sm:grid-cols-2 xl:grid-cols-3", children: p.map(({ label: r, color: o }) => /* @__PURE__ */ l(a, { className: "p-4", children: [
+      /* @__PURE__ */ e(t, { tag: "h5", className: "mb-3", children: r }),
+      /* @__PURE__ */ e(
+        s,
+        {
+          label: `${r} Textarea`,
+          placeholder: "Enter text",
+          rows: 3,
+          color: o
+        }
+      )
+    ] }, o)) }) }) }) }),
+    /* @__PURE__ */ e(a, { className: "overflow-hidden", children: /* @__PURE__ */ e(i, { title: "Sizes", className: "mt-2 mb-2", children: /* @__PURE__ */ e("div", { className: "w-full p-4 sm:p-6", children: /* @__PURE__ */ e("div", { className: "grid grid-cols-1 gap-4 md:grid-cols-3", children: g.map(({ label: r, size: o }) => /* @__PURE__ */ l(a, { className: "p-4", children: [
+      /* @__PURE__ */ e(t, { tag: "h5", className: "mb-3", children: r }),
+      /* @__PURE__ */ e(
+        s,
+        {
+          label: `${r} Textarea`,
+          placeholder: "Enter text",
+          rows: 3,
+          size: o
+        }
+      )
+    ] }, o)) }) }) }) }),
+    /* @__PURE__ */ e(
+      u,
+      {
+        componentName: "Textarea",
+        defaultValues: {
+          label: "Preview Textarea",
+          placeholder: "Enter text",
+          variant: "ghost",
+          color: "primary",
+          size: "md",
+          rows: 4,
+          helperText: "",
+          error: "",
+          useUppercaseLabel: !1,
+          disabled: !1
+        },
+        controlOverrides: [
+          {
+            name: "placeholder",
+            type: "text",
+            description: "Placeholder text rendered inside the textarea"
+          },
+          {
+            name: "color",
+            type: "select",
+            options: [
+              "primary",
+              "secondary",
+              "danger",
+              "info",
+              "success",
+              "warning"
+            ],
+            description: "Color treatment applied to the control"
+          },
+          {
+            name: "rows",
+            type: "number",
+            description: "Visible row count for the textarea preview"
+          },
+          {
+            name: "disabled",
+            type: "boolean",
+            description: "Disables the textarea and prevents interaction"
+          }
+        ],
+        includeProps: [
+          "label",
+          "placeholder",
+          "variant",
+          "color",
+          "size",
+          "rows",
+          "helperText",
+          "error",
+          "useUppercaseLabel",
+          "disabled"
+        ],
+        excludeProps: ["inputClassName"],
+        children: (r) => /* @__PURE__ */ e("div", { className: "w-full max-w-lg", children: /* @__PURE__ */ e(
+          s,
+          {
+            ...r,
+            rows: typeof r.rows == "number" ? r.rows : 4,
+            placeholder: r.placeholder || "Enter text",
+            value: m,
+            onChange: (o) => h(o.target.value)
+          }
+        ) })
+      }
+    ),
+    /* @__PURE__ */ e(w, { componentName: "Textarea" }),
+    /* @__PURE__ */ e(a, { className: "overflow-hidden", children: /* @__PURE__ */ e(i, { title: "Code Example", className: "mt-2 mb-2", children: /* @__PURE__ */ e("div", { className: "w-full p-4 sm:p-6", children: /* @__PURE__ */ e(
+      N,
+      {
+        language: "tsx",
+        code: `import { Textarea } from '@e-burgos/tucu-ui';
+
+<Textarea
+  label="Message"
+  placeholder="Write your message here"
+  value={value}
+  onChange={(e) => setValue(e.target.value)}
+  rows={4}
+/>
+
+<Textarea
+  label="Description"
+  placeholder="Enter description"
+  helperText="Provide a detailed description"
+  rows={4}
+/>
+
+// Variants
+<Textarea label="Ghost" variant="ghost" rows={4} />
+<Textarea label="Solid" variant="solid" rows={4} />
+<Textarea label="Transparent" variant="transparent" rows={4} />
+
+// Colors
+<Textarea label="Primary" color="primary" rows={4} />
+<Textarea label="Secondary" color="secondary" rows={4} />
+<Textarea label="Danger" color="danger" rows={4} />
+<Textarea label="Info" color="info" rows={4} />
+<Textarea label="Success" color="success" rows={4} />
+<Textarea label="Warning" color="warning" rows={4} />
+
+// Sizes
+<Textarea label="Small" size="sm" rows={3} />
+<Textarea label="Medium" size="md" rows={4} />
+<Textarea label="Large" size="lg" rows={5} />`
+      }
+    ) }) }) })
+  ] });
+};
+export {
+  P as default
+};

package/documentation/ThemeArchitectureSection-CJLVZw1o.js

@@ -0,0 +1,141 @@
+import { jsxs as t, Fragment as r, jsx as e } from "react/jsx-runtime";
+import { H as l, T as o, ax as c, aA as n, c as m } from "../index-lfg6LZ1p.js";
+import { Layers as d, Zap as h, Palette as p, Moon as u, Layout as g, Monitor as y, Sparkles as w } from "lucide-react";
+import "react-router-dom";
+import "react";
+import "react-dom";
+const x = () => {
+  const i = [
+    {
+      icon: /* @__PURE__ */ e(h, { className: "w-6 h-6 text-white filter drop-shadow-sm" }),
+      title: "Zustand State Management",
+      description: "Centralized theme state with minimal boilerplate, localStorage persistence, and excellent TypeScript support.",
+      iconBgClassName: "from-yellow-500 via-amber-500 to-orange-500"
+    },
+    {
+      icon: /* @__PURE__ */ e(p, { className: "w-6 h-6 text-white filter drop-shadow-sm" }),
+      title: "CSS Custom Properties",
+      description: "Dynamic brand colors using 12 CSS variables (6 light/dark pairs) for real-time theme updates without rebuilds.",
+      iconBgClassName: "from-blue-500 via-cyan-500 to-teal-500"
+    },
+    {
+      icon: /* @__PURE__ */ e(u, { className: "w-6 h-6 text-white filter drop-shadow-sm" }),
+      title: "Dark Mode Support",
+      description: "Automatic dark/light mode switching with smooth transitions and system preference detection.",
+      iconBgClassName: "from-purple-500 via-violet-500 to-indigo-500"
+    }
+  ], s = [
+    {
+      icon: /* @__PURE__ */ e(g, { className: "w-5 h-5" }),
+      title: "Default",
+      description: "Standard theme with Clean, Admin, and Horizontal layouts.",
+      color: "blue"
+    },
+    {
+      icon: /* @__PURE__ */ e(y, { className: "w-5 h-5" }),
+      title: "macOS (Sonoma)",
+      description: "macOS-inspired dock layout with Sonoma visual style.",
+      color: "purple"
+    },
+    {
+      icon: /* @__PURE__ */ e(w, { className: "w-5 h-5" }),
+      title: "macOS Tahoe",
+      description: "Latest macOS Tahoe style with Tahoe and Tahoe Dock layouts.",
+      color: "teal"
+    }
+  ];
+  return /* @__PURE__ */ t(r, { children: [
+    /* @__PURE__ */ e(
+      l,
+      {
+        title: "Theme Architecture",
+        description: "Built on Zustand, CSS custom properties, and Tailwind CSS v4 for a flexible, performant, and type-safe 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-purple-500 via-violet-500 to-indigo-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(o, { tag: "h2", className: "mb-2", children: "Core Technologies" }),
+        /* @__PURE__ */ e(
+          o,
+          {
+            tag: "p",
+            className: "text-gray-500 dark:text-gray-400 max-w-2xl mx-auto",
+            children: "Three pillars 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: i.map((a) => /* @__PURE__ */ e(c, { layout: "horizontal", ...a }, a.title)) })
+    ] }),
+    /* @__PURE__ */ t("section", { className: "space-y-8", children: [
+      /* @__PURE__ */ t("div", { className: "text-center", children: [
+        /* @__PURE__ */ e(o, { tag: "h2", className: "mb-2", children: "Theme Variants" }),
+        /* @__PURE__ */ e(
+          o,
+          {
+            tag: "p",
+            className: "text-gray-500 dark:text-gray-400 max-w-2xl mx-auto",
+            children: "Three visual styles with their own layout constraints"
+          }
+        )
+      ] }),
+      /* @__PURE__ */ e("div", { className: "grid grid-cols-1 sm:grid-cols-2 lg:grid-cols-3 gap-4 sm:gap-6", children: s.map((a) => /* @__PURE__ */ e(
+        n,
+        {
+          icon: a.icon,
+          title: a.title,
+          description: a.description,
+          color: a.color
+        },
+        a.title
+      )) })
+    ] }),
+    /* @__PURE__ */ t("section", { className: "space-y-8", children: [
+      /* @__PURE__ */ t("div", { className: "text-center", children: [
+        /* @__PURE__ */ e(o, { tag: "h2", className: "mb-2", children: "Layout Constraint Map" }),
+        /* @__PURE__ */ e(
+          o,
+          {
+            tag: "p",
+            className: "text-gray-500 dark:text-gray-400 max-w-2xl mx-auto",
+            children: "Each theme variant restricts which layouts are available"
+          }
+        )
+      ] }),
+      /* @__PURE__ */ e(
+        m,
+        {
+          language: "typescript",
+          code: `// THEME_STYLE_LAYOUTS mapping
+const THEME_STYLE_LAYOUTS: Record<THEME_VARIANT, ThemeStyleConfig> = {
+  default: {
+    validLayouts: [CLEAN, ADMIN, HORIZONTAL],
+    defaultLayout: HORIZONTAL,
+  },
+  macos: {
+    validLayouts: [MACOS],
+    defaultLayout: MACOS,
+  },
+  'macos-tahoe': {
+    validLayouts: [MACOS_TAHOE, MACOS_TAHOE_DOCK],
+    defaultLayout: MACOS_TAHOE,
+  },
+};
+
+// LAYOUT_OPTIONS enum (6 values)
+enum LAYOUT_OPTIONS {
+  CLEAN = 'clean',
+  ADMIN = 'admin',
+  HORIZONTAL = 'horizontal',
+  MACOS = 'macos',
+  MACOS_TAHOE = 'macos-tahoe',
+  MACOS_TAHOE_DOCK = 'macos-tahoe-dock',
+}`
+        }
+      )
+    ] })
+  ] });
+};
+export {
+  x as default
+};

package/documentation/ThemeArchitectureSection-DTZZ9DW8.js

@@ -0,0 +1,25 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("react/jsx-runtime"),a=require("../index-BaGqriuz.js"),s=require("lucide-react");require("react-router-dom");require("react");require("react-dom");const r=()=>{const o=[{icon:e.jsx(s.Zap,{className:"w-6 h-6 text-white filter drop-shadow-sm"}),title:"Zustand State Management",description:"Centralized theme state with minimal boilerplate, localStorage persistence, and excellent TypeScript support.",iconBgClassName:"from-yellow-500 via-amber-500 to-orange-500"},{icon:e.jsx(s.Palette,{className:"w-6 h-6 text-white filter drop-shadow-sm"}),title:"CSS Custom Properties",description:"Dynamic brand colors using 12 CSS variables (6 light/dark pairs) for real-time theme updates without rebuilds.",iconBgClassName:"from-blue-500 via-cyan-500 to-teal-500"},{icon:e.jsx(s.Moon,{className:"w-6 h-6 text-white filter drop-shadow-sm"}),title:"Dark Mode Support",description:"Automatic dark/light mode switching with smooth transitions and system preference detection.",iconBgClassName:"from-purple-500 via-violet-500 to-indigo-500"}],i=[{icon:e.jsx(s.Layout,{className:"w-5 h-5"}),title:"Default",description:"Standard theme with Clean, Admin, and Horizontal layouts.",color:"blue"},{icon:e.jsx(s.Monitor,{className:"w-5 h-5"}),title:"macOS (Sonoma)",description:"macOS-inspired dock layout with Sonoma visual style.",color:"purple"},{icon:e.jsx(s.Sparkles,{className:"w-5 h-5"}),title:"macOS Tahoe",description:"Latest macOS Tahoe style with Tahoe and Tahoe Dock layouts.",color:"teal"}];return e.jsxs(e.Fragment,{children:[e.jsx(a.HeroCard,{title:"Theme Architecture",description:"Built on Zustand, CSS custom properties, and Tailwind CSS v4 for a flexible, performant, and type-safe theming system.",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(s.Layers,{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(a.Typography,{tag:"h2",className:"mb-2",children:"Core Technologies"}),e.jsx(a.Typography,{tag:"p",className:"text-gray-500 dark:text-gray-400 max-w-2xl mx-auto",children:"Three pillars 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:o.map(t=>e.jsx(a.FeatureCard,{layout:"horizontal",...t},t.title))})]}),e.jsxs("section",{className:"space-y-8",children:[e.jsxs("div",{className:"text-center",children:[e.jsx(a.Typography,{tag:"h2",className:"mb-2",children:"Theme Variants"}),e.jsx(a.Typography,{tag:"p",className:"text-gray-500 dark:text-gray-400 max-w-2xl mx-auto",children:"Three visual styles with their own layout constraints"})]}),e.jsx("div",{className:"grid grid-cols-1 sm:grid-cols-2 lg:grid-cols-3 gap-4 sm:gap-6",children:i.map(t=>e.jsx(a.ColorCard,{icon:t.icon,title:t.title,description:t.description,color:t.color},t.title))})]}),e.jsxs("section",{className:"space-y-8",children:[e.jsxs("div",{className:"text-center",children:[e.jsx(a.Typography,{tag:"h2",className:"mb-2",children:"Layout Constraint Map"}),e.jsx(a.Typography,{tag:"p",className:"text-gray-500 dark:text-gray-400 max-w-2xl mx-auto",children:"Each theme variant restricts which layouts are available"})]}),e.jsx(a.CodeBlock,{language:"typescript",code:`// THEME_STYLE_LAYOUTS mapping
+const THEME_STYLE_LAYOUTS: Record<THEME_VARIANT, ThemeStyleConfig> = {
+  default: {
+    validLayouts: [CLEAN, ADMIN, HORIZONTAL],
+    defaultLayout: HORIZONTAL,
+  },
+  macos: {
+    validLayouts: [MACOS],
+    defaultLayout: MACOS,
+  },
+  'macos-tahoe': {
+    validLayouts: [MACOS_TAHOE, MACOS_TAHOE_DOCK],
+    defaultLayout: MACOS_TAHOE,
+  },
+};
+
+// LAYOUT_OPTIONS enum (6 values)
+enum LAYOUT_OPTIONS {
+  CLEAN = 'clean',
+  ADMIN = 'admin',
+  HORIZONTAL = 'horizontal',
+  MACOS = 'macos',
+  MACOS_TAHOE = 'macos-tahoe',
+  MACOS_TAHOE_DOCK = 'macos-tahoe-dock',
+}`})]})]})};exports.default=r;

package/documentation/ThemeConfigurationSection-66D5XJGb.js

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("react/jsx-runtime"),a=require("../index-BaGqriuz.js"),t=require("lucide-react");require("react-router-dom");require("react");require("react-dom");const c=()=>{const o=[{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'"}],s=[{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 e.jsxs(e.Fragment,{children:[e.jsx(a.HeroCard,{title:"Theme Configuration",description:"All available configuration options and the 34 color presets that power the theming system.",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-emerald-500 via-teal-500 to-cyan-500 rounded-full flex items-center justify-center shadow-lg",children:e.jsx(t.Settings,{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(a.Typography,{tag:"h2",className:"mb-2",children:"Available Options"}),e.jsx(a.Typography,{tag:"p",className:"text-gray-500 dark:text-gray-400 max-w-2xl mx-auto",children:"All configurable properties managed by the theme store"})]}),e.jsx(a.CardContainer,{children:e.jsx(a.CardTitle,{title:"Configuration Options",children:e.jsx("div",{className:"space-y-3",children:o.map((r,l)=>e.jsxs("div",{className:"flex justify-between items-center py-2 px-3 bg-gray-200 dark:bg-gray-800 rounded-lg",children:[e.jsx("span",{className:"font-medium text-sm",children:r.label}),e.jsx("code",{className:"text-xs text-gray-600 dark:text-gray-400",children:r.value})]},l))})})})]}),e.jsxs("section",{className:"space-y-8",children:[e.jsxs("div",{className:"text-center",children:[e.jsx(a.Typography,{tag:"h2",className:"mb-2",children:"Color Presets"}),e.jsx(a.Typography,{tag:"p",className:"text-gray-500 dark:text-gray-400 max-w-2xl mx-auto",children:"34 predefined colors (12 default + 22 spectrum)"})]}),e.jsx(a.CardContainer,{children:e.jsx(a.CardTitle,{title:"Preset Palette",children:e.jsxs("div",{className:"space-y-4",children:[e.jsx("div",{className:"grid grid-cols-1 sm:grid-cols-2 md:grid-cols-3 gap-3",children:s.map((r,l)=>e.jsxs("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:[e.jsx("div",{className:"w-4 h-4 rounded-full border border-gray-300 dark:border-gray-600 shadow-sm",style:{backgroundColor:r.color}}),e.jsx("span",{className:"text-xs font-medium truncate",children:r.name})]},l))}),e.jsx(a.Typography,{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)."})]})})})]})]})};exports.default=c;