@e-burgos/tucu-ui 2.5.0 → 2.6.0

package/documentation/FileStructureSection-BORCUzqw.js

@@ -0,0 +1,101 @@
+import { jsxs as s, Fragment as r, jsx as e } from "react/jsx-runtime";
+import { H as i, T as t, C as l, a as n, c as d, aj as a } from "../index-DoxeCFUJ.js";
+import { FolderTree as o } from "lucide-react";
+import "react-router-dom";
+import "react";
+import "react-dom";
+const u = () => /* @__PURE__ */ s(r, { children: [
+  /* @__PURE__ */ e(
+    i,
+    {
+      title: "File Structure",
+      description: "Understand the theme system's file organization and important architectural notes.",
+      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-gray-500 via-slate-500 to-zinc-600 rounded-full flex items-center justify-center shadow-lg", children: /* @__PURE__ */ e(o, { className: "w-10 h-10 sm:w-12 sm:h-12 md:w-16 md:h-16 text-white filter drop-shadow-lg" }) })
+    }
+  ),
+  /* @__PURE__ */ s("section", { className: "space-y-8", children: [
+    /* @__PURE__ */ s("div", { className: "text-center", children: [
+      /* @__PURE__ */ e(t, { tag: "h2", className: "mb-2", children: "Theme File Organization" }),
+      /* @__PURE__ */ e(
+        t,
+        {
+          tag: "p",
+          className: "text-gray-500 dark:text-gray-400 max-w-2xl mx-auto",
+          children: "Key directories and files in the theme system"
+        }
+      )
+    ] }),
+    /* @__PURE__ */ e(l, { children: /* @__PURE__ */ e(n, { title: "Directory Tree", children: /* @__PURE__ */ e(
+      d,
+      {
+        language: "markdown",
+        code: `ui/tucu-ui/src/
+├── themes/
+│   ├── components/
+│   │   ├── theme-provider/
+│   │   │   ├── index.tsx
+│   │   │   ├── single-app-theme-provider.tsx
+│   │   │   ├── mfe-app-theme-provider.tsx
+│   │   │   └── theme-wrapper.tsx
+│   │   └── settings/
+│   │       ├── settings-button.tsx
+│   │       ├── settings-drawer.tsx
+│   │       ├── switch-mode.tsx
+│   │       └── lang-selector.tsx
+│   ├── hooks/
+│   │   ├── use-theme.tsx
+│   │   ├── use-theme-color.ts
+│   │   └── use-direction.ts
+│   ├── config/
+│   │   └── index.ts
+│   ├── auth/
+│   ├── pages/
+│   ├── router/
+│   ├── types/
+│   └── index.ts
+└── assets/css/
+    └── globals.css`
+      }
+    ) }) })
+  ] }),
+  /* @__PURE__ */ s("section", { className: "space-y-8", children: [
+    /* @__PURE__ */ s("div", { className: "text-center", children: [
+      /* @__PURE__ */ e(t, { tag: "h2", className: "mb-2", children: "Important Notes" }),
+      /* @__PURE__ */ e(
+        t,
+        {
+          tag: "p",
+          className: "text-gray-500 dark:text-gray-400 max-w-2xl mx-auto",
+          children: "Key architectural details to keep in mind"
+        }
+      )
+    ] }),
+    /* @__PURE__ */ s("div", { className: "space-y-4", children: [
+      /* @__PURE__ */ s(a, { variant: "info", dismissible: !1, children: [
+        /* @__PURE__ */ e(t, { tag: "h5", className: "font-semibold text-sm mb-2", children: "Spacing Classes" }),
+        /* @__PURE__ */ s(t, { tag: "p", className: "text-xs", children: [
+          "All spacing classes use arbitrary values (e.g.,",
+          " ",
+          /* @__PURE__ */ e("code", { className: "px-1 py-0.5 border border-border dark:border-border rounded", children: "p-[16px]" }),
+          ") instead of Tailwind defaults to maintain original spacing values."
+        ] })
+      ] }),
+      /* @__PURE__ */ s(a, { variant: "warning", dismissible: !1, children: [
+        /* @__PURE__ */ e(t, { tag: "h5", className: "font-semibold text-sm mb-2", children: "Theme Persistence" }),
+        /* @__PURE__ */ s(t, { tag: "p", className: "text-xs", children: [
+          "Theme settings are automatically persisted to localStorage using Zustand's persist middleware. Storage key:",
+          " ",
+          /* @__PURE__ */ e("code", { className: "px-1 py-0.5 border border-border dark:border-border rounded", children: "theme-storage" }),
+          "."
+        ] })
+      ] }),
+      /* @__PURE__ */ s(a, { variant: "success", dismissible: !1, children: [
+        /* @__PURE__ */ e(t, { tag: "h5", className: "font-semibold text-sm mb-2", children: "CSS Variables" }),
+        /* @__PURE__ */ e(t, { tag: "p", className: "text-xs", children: "Theme colors are injected as CSS variables on the document root. These variables are used by Tailwind utilities and can be referenced directly in CSS or inline styles." })
+      ] })
+    ] })
+  ] })
+] });
+export {
+  u as default
+};

package/documentation/FormComponentsSection-BB7qCeJ_.js

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("react/jsx-runtime"),t=require("../index-DWDUS-PU.js"),r=require("lucide-react");require("react-router-dom");require("react");require("react-dom");const n=()=>{const o=[{icon:e.jsx(r.Type,{className:"w-6 h-6 text-white filter drop-shadow-sm"}),title:"Text Inputs",description:"Standard text entry with validation and helper text",color:"from-blue-500 to-cyan-500",components:["Input","Textarea"]},{icon:e.jsx(r.List,{className:"w-6 h-6 text-white filter drop-shadow-sm"}),title:"Selection",description:"Dropdown and autocomplete with search support",color:"from-green-500 to-emerald-500",components:["Select","InputSearcher"]},{icon:e.jsx(r.CheckSquare,{className:"w-6 h-6 text-white filter drop-shadow-sm"}),title:"Choice Controls",description:"Boolean and group selection inputs",color:"from-purple-500 to-violet-500",components:["Checkbox","Radio","RadioGroup","Switch"]},{icon:e.jsx(r.Upload,{className:"w-6 h-6 text-white filter drop-shadow-sm"}),title:"File Upload",description:"File input with drag & drop support",color:"from-pink-500 to-rose-500",components:["FileInput"]},{icon:e.jsx(r.Hash,{className:"w-6 h-6 text-white filter drop-shadow-sm"}),title:"Specialized",description:"PIN codes and toggle selection bars",color:"from-indigo-500 to-purple-500",components:["PinCode","ToggleBar"]}];return e.jsxs(e.Fragment,{children:[e.jsx(t.HeroCard,{title:"Form Components",description:"11 input components ready for use with FormField. Each integrates automatically with validation, error display, and form state.",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(r.LayoutGrid,{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:"Available Inputs"}),e.jsx(t.Typography,{tag:"p",className:"text-gray-500 dark:text-gray-400 max-w-2xl mx-auto",children:"All form inputs organized by category"})]}),e.jsx("div",{className:"grid grid-cols-1 sm:grid-cols-2 lg:grid-cols-3 gap-4 sm:gap-6",children:o.map((s,a)=>e.jsx(t.CardContainer,{children:e.jsxs("div",{className:"w-full p-4 sm:p-6 space-y-4",children:[e.jsxs("div",{className:"flex items-center gap-3",children:[e.jsx("div",{className:`p-2.5 rounded-xl bg-linear-to-br ${s.color} shadow-lg`,children:s.icon}),e.jsxs("div",{children:[e.jsx(t.Typography,{tag:"h3",className:"font-semibold",children:s.title}),e.jsx(t.Typography,{tag:"p",className:"text-sm text-gray-500 dark:text-gray-400",children:s.description})]})]}),e.jsx("div",{className:"flex flex-wrap gap-1.5",children:s.components.map((i,l)=>e.jsx(t.Badge,{color:"success",variant:"outline",className:"text-xs",children:i},l))})]})},a))})]}),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 with FormField"}),e.jsx(t.Typography,{tag:"p",className:"text-gray-500 dark:text-gray-400 max-w-2xl mx-auto",children:"Any input wrapped in FormField gets automatic registration and error handling"})]}),e.jsx(t.CardContainer,{children:e.jsx("div",{className:"w-full p-4 sm:p-6",children:e.jsx("div",{className:"grid grid-cols-1 sm:grid-cols-2 gap-4",children:[{label:"Input",code:'<FormField name="email"><Input type="email" /></FormField>'},{label:"Select",code:'<FormField name="country"><Select options={countries} /></FormField>'},{label:"Checkbox",code:'<FormField name="terms"><Checkbox label="Accept" /></FormField>'},{label:"InputSearcher",code:'<FormField name="city"><InputSearcher options={cities} /></FormField>'}].map((s,a)=>e.jsxs("div",{className:"p-3 bg-gray-100 dark:bg-gray-800/50 rounded-lg border border-border",children:[e.jsx(t.Typography,{tag:"span",className:"text-xs font-semibold text-brand block mb-2",children:s.label}),e.jsx("code",{className:"text-xs text-gray-600 dark:text-gray-400 break-all",children:s.code})]},a))})})})]})]})};exports.default=n;

package/documentation/FormComponentsSection-yKE3yL-Y.js

@@ -0,0 +1,148 @@
+import { jsxs as t, Fragment as d, jsx as e } from "react/jsx-runtime";
+import { H as n, T as o, C as i, K as c } from "../index-DoxeCFUJ.js";
+import { LayoutGrid as m, Type as p, List as h, CheckSquare as g, Upload as u, Hash as x } from "lucide-react";
+import "react-router-dom";
+import "react";
+import "react-dom";
+const C = () => /* @__PURE__ */ t(d, { children: [
+  /* @__PURE__ */ e(
+    n,
+    {
+      title: "Form Components",
+      description: "11 input components ready for use with FormField. Each integrates automatically with validation, error display, and form state.",
+      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(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: "Available Inputs" }),
+      /* @__PURE__ */ e(
+        o,
+        {
+          tag: "p",
+          className: "text-gray-500 dark:text-gray-400 max-w-2xl mx-auto",
+          children: "All form inputs organized by category"
+        }
+      )
+    ] }),
+    /* @__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(p, { className: "w-6 h-6 text-white filter drop-shadow-sm" }),
+        title: "Text Inputs",
+        description: "Standard text entry with validation and helper text",
+        color: "from-blue-500 to-cyan-500",
+        components: ["Input", "Textarea"]
+      },
+      {
+        icon: /* @__PURE__ */ e(h, { className: "w-6 h-6 text-white filter drop-shadow-sm" }),
+        title: "Selection",
+        description: "Dropdown and autocomplete with search support",
+        color: "from-green-500 to-emerald-500",
+        components: ["Select", "InputSearcher"]
+      },
+      {
+        icon: /* @__PURE__ */ e(g, { className: "w-6 h-6 text-white filter drop-shadow-sm" }),
+        title: "Choice Controls",
+        description: "Boolean and group selection inputs",
+        color: "from-purple-500 to-violet-500",
+        components: ["Checkbox", "Radio", "RadioGroup", "Switch"]
+      },
+      {
+        icon: /* @__PURE__ */ e(u, { className: "w-6 h-6 text-white filter drop-shadow-sm" }),
+        title: "File Upload",
+        description: "File input with drag & drop support",
+        color: "from-pink-500 to-rose-500",
+        components: ["FileInput"]
+      },
+      {
+        icon: /* @__PURE__ */ e(x, { className: "w-6 h-6 text-white filter drop-shadow-sm" }),
+        title: "Specialized",
+        description: "PIN codes and toggle selection bars",
+        color: "from-indigo-500 to-purple-500",
+        components: ["PinCode", "ToggleBar"]
+      }
+    ].map((a, r) => /* @__PURE__ */ e(i, { children: /* @__PURE__ */ t("div", { className: "w-full p-4 sm:p-6 space-y-4", children: [
+      /* @__PURE__ */ t("div", { className: "flex items-center gap-3", children: [
+        /* @__PURE__ */ e(
+          "div",
+          {
+            className: `p-2.5 rounded-xl bg-linear-to-br ${a.color} shadow-lg`,
+            children: a.icon
+          }
+        ),
+        /* @__PURE__ */ t("div", { children: [
+          /* @__PURE__ */ e(o, { tag: "h3", className: "font-semibold", children: a.title }),
+          /* @__PURE__ */ e(
+            o,
+            {
+              tag: "p",
+              className: "text-sm text-gray-500 dark:text-gray-400",
+              children: a.description
+            }
+          )
+        ] })
+      ] }),
+      /* @__PURE__ */ e("div", { className: "flex flex-wrap gap-1.5", children: a.components.map((l, s) => /* @__PURE__ */ e(
+        c,
+        {
+          color: "success",
+          variant: "outline",
+          className: "text-xs",
+          children: l
+        },
+        s
+      )) })
+    ] }) }, r)) })
+  ] }),
+  /* @__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 with FormField" }),
+      /* @__PURE__ */ e(
+        o,
+        {
+          tag: "p",
+          className: "text-gray-500 dark:text-gray-400 max-w-2xl mx-auto",
+          children: "Any input wrapped in FormField gets automatic registration and error handling"
+        }
+      )
+    ] }),
+    /* @__PURE__ */ e(i, { children: /* @__PURE__ */ e("div", { className: "w-full p-4 sm:p-6", children: /* @__PURE__ */ e("div", { className: "grid grid-cols-1 sm:grid-cols-2 gap-4", children: [
+      {
+        label: "Input",
+        code: '<FormField name="email"><Input type="email" /></FormField>'
+      },
+      {
+        label: "Select",
+        code: '<FormField name="country"><Select options={countries} /></FormField>'
+      },
+      {
+        label: "Checkbox",
+        code: '<FormField name="terms"><Checkbox label="Accept" /></FormField>'
+      },
+      {
+        label: "InputSearcher",
+        code: '<FormField name="city"><InputSearcher options={cities} /></FormField>'
+      }
+    ].map((a, r) => /* @__PURE__ */ t(
+      "div",
+      {
+        className: "p-3 bg-gray-100 dark:bg-gray-800/50 rounded-lg border border-border",
+        children: [
+          /* @__PURE__ */ e(
+            o,
+            {
+              tag: "span",
+              className: "text-xs font-semibold text-brand block mb-2",
+              children: a.label
+            }
+          ),
+          /* @__PURE__ */ e("code", { className: "text-xs text-gray-600 dark:text-gray-400 break-all", children: a.code })
+        ]
+      },
+      r
+    )) }) }) })
+  ] })
+] });
+export {
+  C as default
+};

package/documentation/FormMethodsSection-BjBBjdJs.js

@@ -0,0 +1,194 @@
+import { jsxs as a, Fragment as c, jsx as e } from "react/jsx-runtime";
+import { H as m, T as t, C as r, c as h } from "../index-DoxeCFUJ.js";
+import { Terminal as u, Activity as p, Circle as l, Wrench as f } from "lucide-react";
+import "react-router-dom";
+import "react";
+import "react-dom";
+const V = () => {
+  const n = `import { useFormContext } from '@e-burgos/tucu-ui';
+
+function FormActions() {
+  const {
+    formState: { errors, isDirty, isValid, isSubmitting },
+    reset,
+    trigger,
+    setValue,
+    getValues,
+    watch,
+  } = useFormContext<FormValues>();
+
+  // Watch specific field changes
+  const nameValue = watch('name');
+
+  // Reset to default values
+  const handleReset = () => reset(defaultValues);
+
+  // Trigger validation on all fields
+  const handleValidate = async () => {
+    const result = await trigger();
+    console.log('All fields valid:', result);
+  };
+
+  // Set value programmatically (triggers validation)
+  const handleSetValue = () => {
+    setValue('name', 'John Doe', { shouldValidate: true });
+  };
+
+  // Get current values snapshot
+  const handleGetValues = () => {
+    const values = getValues();
+    console.log('Current values:', values);
+  };
+
+  return (
+    <div className="space-y-4">
+      <p>Name: {nameValue}</p>
+      <p>Dirty: {isDirty ? 'Yes' : 'No'}</p>
+      <p>Valid: {isValid ? 'Yes' : 'No'}</p>
+      <button onClick={handleReset}>Reset</button>
+      <button onClick={handleValidate}>Validate</button>
+      <button onClick={handleSetValue}>Set Value</button>
+      <button onClick={handleGetValues}>Get Values</button>
+    </div>
+  );
+}
+
+// Must be inside <Form> to access context
+<Form<FormValues> onSubmit={handleSubmit}>
+  <FormActions />
+  {/* form fields */}
+</Form>`, o = [
+    { name: "errors", description: "Object containing all field errors" },
+    { name: "isDirty", description: "True if any field has been modified" },
+    { name: "isValid", description: "True if form passes all validations" },
+    {
+      name: "isSubmitting",
+      description: "True during async form submission"
+    },
+    {
+      name: "dirtyFields",
+      description: "Object of fields that have been modified"
+    },
+    {
+      name: "touchedFields",
+      description: "Object of fields that have been focused/blurred"
+    }
+  ], d = [
+    {
+      name: "reset(values?)",
+      description: "Reset form to defaults or provided values"
+    },
+    {
+      name: "trigger(name?)",
+      description: "Trigger validation for all fields or a specific field"
+    },
+    {
+      name: "setValue(name, value, options?)",
+      description: "Set a field value programmatically"
+    },
+    {
+      name: "getValues(name?)",
+      description: "Get current form values (all or specific field)"
+    },
+    {
+      name: "watch(name?)",
+      description: "Subscribe to field changes (causes re-render)"
+    },
+    {
+      name: "setError(name, error)",
+      description: "Manually set an error on a field"
+    },
+    {
+      name: "clearErrors(name?)",
+      description: "Clear errors for all fields or a specific field"
+    }
+  ];
+  return /* @__PURE__ */ a(c, { children: [
+    /* @__PURE__ */ e(
+      m,
+      {
+        title: "Form Methods",
+        description: "Access react-hook-form methods via useFormContext inside any child of Form. Programmatically control values, trigger validation, and read form state.",
+        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", children: /* @__PURE__ */ e(u, { 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(t, { tag: "h2", className: "mb-2", children: "useFormContext Example" }),
+        /* @__PURE__ */ e(
+          t,
+          {
+            tag: "p",
+            className: "text-gray-500 dark:text-gray-400 max-w-2xl mx-auto",
+            children: "Access form state and methods from any component inside Form"
+          }
+        )
+      ] }),
+      /* @__PURE__ */ e(r, { className: "overflow-hidden", children: /* @__PURE__ */ e("div", { className: "w-full p-4 sm:p-6", children: /* @__PURE__ */ e(h, { language: "tsx", code: n }) }) })
+    ] }),
+    /* @__PURE__ */ a("section", { className: "space-y-8", children: [
+      /* @__PURE__ */ a("div", { className: "text-center", children: [
+        /* @__PURE__ */ e(t, { tag: "h2", className: "mb-2", children: "API Reference" }),
+        /* @__PURE__ */ e(
+          t,
+          {
+            tag: "p",
+            className: "text-gray-500 dark:text-gray-400 max-w-2xl mx-auto",
+            children: "Form state properties and available methods"
+          }
+        )
+      ] }),
+      /* @__PURE__ */ a("div", { className: "grid grid-cols-1 md:grid-cols-2 gap-4 sm:gap-6", children: [
+        /* @__PURE__ */ e(r, { children: /* @__PURE__ */ a("div", { className: "w-full p-4 sm:p-6 space-y-4", children: [
+          /* @__PURE__ */ a("div", { className: "flex items-center gap-2", children: [
+            /* @__PURE__ */ e(p, { className: "w-5 h-5 text-brand" }),
+            /* @__PURE__ */ e(t, { tag: "h3", className: "font-semibold", children: "formState Properties" })
+          ] }),
+          /* @__PURE__ */ e("div", { className: "space-y-2", children: o.map((s, i) => /* @__PURE__ */ a("div", { className: "flex items-start gap-2", children: [
+            /* @__PURE__ */ e(l, { className: "w-3 h-3 text-brand mt-1.5 shrink-0" }),
+            /* @__PURE__ */ a("div", { children: [
+              /* @__PURE__ */ e("code", { className: "text-xs text-brand font-semibold", children: s.name }),
+              /* @__PURE__ */ a(
+                t,
+                {
+                  tag: "span",
+                  className: "text-xs text-gray-500 dark:text-gray-400 ml-2",
+                  children: [
+                    "— ",
+                    s.description
+                  ]
+                }
+              )
+            ] })
+          ] }, i)) })
+        ] }) }),
+        /* @__PURE__ */ e(r, { children: /* @__PURE__ */ a("div", { className: "w-full p-4 sm:p-6 space-y-4", children: [
+          /* @__PURE__ */ a("div", { className: "flex items-center gap-2", children: [
+            /* @__PURE__ */ e(f, { className: "w-5 h-5 text-brand" }),
+            /* @__PURE__ */ e(t, { tag: "h3", className: "font-semibold", children: "Methods" })
+          ] }),
+          /* @__PURE__ */ e("div", { className: "space-y-2", children: d.map((s, i) => /* @__PURE__ */ a("div", { className: "flex items-start gap-2", children: [
+            /* @__PURE__ */ e(l, { className: "w-3 h-3 text-brand mt-1.5 shrink-0" }),
+            /* @__PURE__ */ a("div", { children: [
+              /* @__PURE__ */ e("code", { className: "text-xs text-brand font-semibold", children: s.name }),
+              /* @__PURE__ */ a(
+                t,
+                {
+                  tag: "span",
+                  className: "text-xs text-gray-500 dark:text-gray-400 ml-2",
+                  children: [
+                    "— ",
+                    s.description
+                  ]
+                }
+              )
+            ] })
+          ] }, i)) })
+        ] }) })
+      ] })
+    ] })
+  ] });
+};
+export {
+  V as default
+};

package/documentation/FormMethodsSection-DUQ4_4_0.js

@@ -0,0 +1,53 @@
+"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 o=()=>{const i=`import { useFormContext } from '@e-burgos/tucu-ui';
+
+function FormActions() {
+  const {
+    formState: { errors, isDirty, isValid, isSubmitting },
+    reset,
+    trigger,
+    setValue,
+    getValues,
+    watch,
+  } = useFormContext<FormValues>();
+
+  // Watch specific field changes
+  const nameValue = watch('name');
+
+  // Reset to default values
+  const handleReset = () => reset(defaultValues);
+
+  // Trigger validation on all fields
+  const handleValidate = async () => {
+    const result = await trigger();
+    console.log('All fields valid:', result);
+  };
+
+  // Set value programmatically (triggers validation)
+  const handleSetValue = () => {
+    setValue('name', 'John Doe', { shouldValidate: true });
+  };
+
+  // Get current values snapshot
+  const handleGetValues = () => {
+    const values = getValues();
+    console.log('Current values:', values);
+  };
+
+  return (
+    <div className="space-y-4">
+      <p>Name: {nameValue}</p>
+      <p>Dirty: {isDirty ? 'Yes' : 'No'}</p>
+      <p>Valid: {isValid ? 'Yes' : 'No'}</p>
+      <button onClick={handleReset}>Reset</button>
+      <button onClick={handleValidate}>Validate</button>
+      <button onClick={handleSetValue}>Set Value</button>
+      <button onClick={handleGetValues}>Get Values</button>
+    </div>
+  );
+}
+
+// Must be inside <Form> to access context
+<Form<FormValues> onSubmit={handleSubmit}>
+  <FormActions />
+  {/* form fields */}
+</Form>`,l=[{name:"errors",description:"Object containing all field errors"},{name:"isDirty",description:"True if any field has been modified"},{name:"isValid",description:"True if form passes all validations"},{name:"isSubmitting",description:"True during async form submission"},{name:"dirtyFields",description:"Object of fields that have been modified"},{name:"touchedFields",description:"Object of fields that have been focused/blurred"}],n=[{name:"reset(values?)",description:"Reset form to defaults or provided values"},{name:"trigger(name?)",description:"Trigger validation for all fields or a specific field"},{name:"setValue(name, value, options?)",description:"Set a field value programmatically"},{name:"getValues(name?)",description:"Get current form values (all or specific field)"},{name:"watch(name?)",description:"Subscribe to field changes (causes re-render)"},{name:"setError(name, error)",description:"Manually set an error on a field"},{name:"clearErrors(name?)",description:"Clear errors for all fields or a specific field"}];return e.jsxs(e.Fragment,{children:[e.jsx(s.HeroCard,{title:"Form Methods",description:"Access react-hook-form methods via useFormContext inside any child of Form. Programmatically control values, trigger validation, and read form state.",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",children:e.jsx(t.Terminal,{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:"useFormContext Example"}),e.jsx(s.Typography,{tag:"p",className:"text-gray-500 dark:text-gray-400 max-w-2xl mx-auto",children:"Access form state and methods from any component inside Form"})]}),e.jsx(s.CardContainer,{className:"overflow-hidden",children:e.jsx("div",{className:"w-full p-4 sm:p-6",children:e.jsx(s.CodeBlock,{language:"tsx",code:i})})})]}),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:"API Reference"}),e.jsx(s.Typography,{tag:"p",className:"text-gray-500 dark:text-gray-400 max-w-2xl mx-auto",children:"Form state properties and available methods"})]}),e.jsxs("div",{className:"grid grid-cols-1 md:grid-cols-2 gap-4 sm:gap-6",children:[e.jsx(s.CardContainer,{children:e.jsxs("div",{className:"w-full p-4 sm:p-6 space-y-4",children:[e.jsxs("div",{className:"flex items-center gap-2",children:[e.jsx(t.Activity,{className:"w-5 h-5 text-brand"}),e.jsx(s.Typography,{tag:"h3",className:"font-semibold",children:"formState Properties"})]}),e.jsx("div",{className:"space-y-2",children:l.map((a,r)=>e.jsxs("div",{className:"flex items-start gap-2",children:[e.jsx(t.Circle,{className:"w-3 h-3 text-brand mt-1.5 shrink-0"}),e.jsxs("div",{children:[e.jsx("code",{className:"text-xs text-brand font-semibold",children:a.name}),e.jsxs(s.Typography,{tag:"span",className:"text-xs text-gray-500 dark:text-gray-400 ml-2",children:["— ",a.description]})]})]},r))})]})}),e.jsx(s.CardContainer,{children:e.jsxs("div",{className:"w-full p-4 sm:p-6 space-y-4",children:[e.jsxs("div",{className:"flex items-center gap-2",children:[e.jsx(t.Wrench,{className:"w-5 h-5 text-brand"}),e.jsx(s.Typography,{tag:"h3",className:"font-semibold",children:"Methods"})]}),e.jsx("div",{className:"space-y-2",children:n.map((a,r)=>e.jsxs("div",{className:"flex items-start gap-2",children:[e.jsx(t.Circle,{className:"w-3 h-3 text-brand mt-1.5 shrink-0"}),e.jsxs("div",{children:[e.jsx("code",{className:"text-xs text-brand font-semibold",children:a.name}),e.jsxs(s.Typography,{tag:"span",className:"text-xs text-gray-500 dark:text-gray-400 ml-2",children:["— ",a.description]})]})]},r))})]})})]})]})]})};exports.default=o;

package/documentation/HamburgerSection-BjB9wmVz.js

@@ -0,0 +1,97 @@
+import { jsxs as a, Fragment as m, jsx as e } from "react/jsx-runtime";
+import { useState as c } from "react";
+import { H as d, C as i, a as o, T as s, z as r, P as p, A as u, c as h } from "../index-DoxeCFUJ.js";
+import { Menu as g } from "lucide-react";
+import "react-router-dom";
+import "react-dom";
+const H = () => {
+  const [l, t] = c(!1);
+  return /* @__PURE__ */ a(m, { children: [
+    /* @__PURE__ */ e(
+      d,
+      {
+        title: "Hamburger",
+        description: `An animated hamburger menu button component, perfect for mobile
+          navigation menus.`,
+        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-blue-600 to-indigo-500 rounded-full flex items-center justify-center shadow-lg", children: /* @__PURE__ */ e(g, { 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(i, { className: "overflow-hidden", children: /* @__PURE__ */ e(o, { title: "Basic Examples", className: "mt-2 mb-2", children: /* @__PURE__ */ e("div", { className: "w-full p-4 sm:p-6", children: /* @__PURE__ */ a("div", { className: "grid grid-cols-1 md:grid-cols-2 gap-4", children: [
+      /* @__PURE__ */ a(i, { className: "p-4", children: [
+        /* @__PURE__ */ e(s, { tag: "h5", className: "mb-3", children: "Closed State" }),
+        /* @__PURE__ */ e(r, { isOpen: !1, onClick: () => t(!1) })
+      ] }),
+      /* @__PURE__ */ a(i, { className: "p-4", children: [
+        /* @__PURE__ */ e(s, { tag: "h5", className: "mb-3", children: "Open State" }),
+        /* @__PURE__ */ e(r, { isOpen: !0, onClick: () => t(!0) })
+      ] }),
+      /* @__PURE__ */ a(i, { className: "p-4", children: [
+        /* @__PURE__ */ e(s, { tag: "h5", className: "mb-3", children: "Interactive Example" }),
+        /* @__PURE__ */ e(r, { isOpen: l, onClick: () => t(!l) })
+      ] }),
+      /* @__PURE__ */ a(i, { className: "p-4", children: [
+        /* @__PURE__ */ e(s, { tag: "h5", className: "mb-3", children: "With Different Variants" }),
+        /* @__PURE__ */ a("div", { className: "flex gap-2", children: [
+          /* @__PURE__ */ e(r, { variant: "solid", color: "primary" }),
+          /* @__PURE__ */ e(r, { variant: "ghost", color: "primary" }),
+          /* @__PURE__ */ e(r, { variant: "transparent" })
+        ] })
+      ] })
+    ] }) }) }) }),
+    /* @__PURE__ */ e(
+      p,
+      {
+        componentName: "Hamburger",
+        defaultValues: {
+          isOpen: !1,
+          color: "primary",
+          size: "medium",
+          variant: "solid"
+        },
+        excludeProps: [
+          "onClick",
+          "aria-label",
+          "aria-describedby",
+          "tooltip",
+          "tooltipArrow",
+          "tooltipColor",
+          "tooltipPlacement",
+          "isLoading",
+          "loaderSize",
+          "loaderVariant",
+          "fullWidth",
+          "disabled"
+        ],
+        children: (n) => /* @__PURE__ */ e(r, { ...n })
+      }
+    ),
+    /* @__PURE__ */ e(u, { componentName: "Hamburger" }),
+    /* @__PURE__ */ e(i, { className: "overflow-hidden", children: /* @__PURE__ */ e(o, { title: "Code Example", className: "mt-2 mb-2", children: /* @__PURE__ */ e("div", { className: "w-full p-4 sm:p-6", children: /* @__PURE__ */ e(
+      h,
+      {
+        language: "tsx",
+        code: `import { Hamburger } from '@e-burgos/tucu-ui';
+import { useState } from 'react';
+
+function MyComponent() {
+  const [isOpen, setIsOpen] = useState(false);
+
+  return (
+    <Hamburger
+      isOpen={isOpen}
+      onClick={() => setIsOpen(!isOpen)}
+    />
+  );
+}
+
+// With different variants
+<Hamburger variant="solid" color="primary" />
+<Hamburger variant="ghost" color="primary" />
+<Hamburger variant="transparent" />`
+      }
+    ) }) }) })
+  ] });
+};
+export {
+  H as default
+};

package/documentation/HamburgerSection-Cu9u90NY.js

@@ -0,0 +1,19 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("react/jsx-runtime"),t=require("react"),r=require("../index-DWDUS-PU.js"),n=require("lucide-react");require("react-router-dom");require("react-dom");const l=()=>{const[s,a]=t.useState(!1);return e.jsxs(e.Fragment,{children:[e.jsx(r.HeroCard,{title:"Hamburger",description:`An animated hamburger menu button component, perfect for mobile
+          navigation menus.`,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-blue-600 to-indigo-500 rounded-full flex items-center justify-center shadow-lg",children:e.jsx(n.Menu,{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(r.CardContainer,{className:"overflow-hidden",children:e.jsx(r.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:"grid grid-cols-1 md:grid-cols-2 gap-4",children:[e.jsxs(r.CardContainer,{className:"p-4",children:[e.jsx(r.Typography,{tag:"h5",className:"mb-3",children:"Closed State"}),e.jsx(r.Hamburger,{isOpen:!1,onClick:()=>a(!1)})]}),e.jsxs(r.CardContainer,{className:"p-4",children:[e.jsx(r.Typography,{tag:"h5",className:"mb-3",children:"Open State"}),e.jsx(r.Hamburger,{isOpen:!0,onClick:()=>a(!0)})]}),e.jsxs(r.CardContainer,{className:"p-4",children:[e.jsx(r.Typography,{tag:"h5",className:"mb-3",children:"Interactive Example"}),e.jsx(r.Hamburger,{isOpen:s,onClick:()=>a(!s)})]}),e.jsxs(r.CardContainer,{className:"p-4",children:[e.jsx(r.Typography,{tag:"h5",className:"mb-3",children:"With Different Variants"}),e.jsxs("div",{className:"flex gap-2",children:[e.jsx(r.Hamburger,{variant:"solid",color:"primary"}),e.jsx(r.Hamburger,{variant:"ghost",color:"primary"}),e.jsx(r.Hamburger,{variant:"transparent"})]})]})]})})})}),e.jsx(r.PropPlayground,{componentName:"Hamburger",defaultValues:{isOpen:!1,color:"primary",size:"medium",variant:"solid"},excludeProps:["onClick","aria-label","aria-describedby","tooltip","tooltipArrow","tooltipColor","tooltipPlacement","isLoading","loaderSize","loaderVariant","fullWidth","disabled"],children:i=>e.jsx(r.Hamburger,{...i})}),e.jsx(r.AutoPropsTable,{componentName:"Hamburger"}),e.jsx(r.CardContainer,{className:"overflow-hidden",children:e.jsx(r.CardTitle,{title:"Code Example",className:"mt-2 mb-2",children:e.jsx("div",{className:"w-full p-4 sm:p-6",children:e.jsx(r.CodeBlock,{language:"tsx",code:`import { Hamburger } from '@e-burgos/tucu-ui';
+import { useState } from 'react';
+
+function MyComponent() {
+  const [isOpen, setIsOpen] = useState(false);
+
+  return (
+    <Hamburger
+      isOpen={isOpen}
+      onClick={() => setIsOpen(!isOpen)}
+    />
+  );
+}
+
+// With different variants
+<Hamburger variant="solid" color="primary" />
+<Hamburger variant="ghost" color="primary" />
+<Hamburger variant="transparent" />`})})})})]})};exports.default=l;