@axzydev/axzy_ui_system 1.3.0 → 1.3.2

package/package.json

@@ -4,7 +4,7 @@
   "packageManager": "pnpm@10.34.0",
   "private": false,
   "license": "MIT",
-  "version": "1.3.0",
+  "version": "1.3.2",
   "type": "module",
   "sideEffects": [
     "*.css"

package/src/App.tsx

@@ -7,7 +7,8 @@ import {
   FaSlidersH,
   FaTable,
 } from "react-icons/fa";
-import { ITLayout, ITThemeProvider } from "./index";
+import { ITLayout, ITThemeProvider, useDebouncedSearch } from "./index";
+import type { ITNavigationItem } from "./index";
 import "./index.css";
 
 // Import Showcases
@@ -44,6 +45,7 @@ import {
   FormBuilderShowcase,
   WysiwygShowcase,
   FieldShowcase,
+  MaskedInputShowcase,
   MultiSelectShowcase,
   ChipInputShowcase,
 } from "./showcases/FormShowcases";
@@ -68,186 +70,165 @@ import {
   ThemeProviderShowcase,
 } from "./showcases/FeedbackShowcases";
 
-type ViewMode = "home" | "ui-system";
+// Sandbox routing / landing (dev-only, never published)
+import {
+  SANDBOX_GROUPS,
+  firstItemOf,
+} from "./sandbox/navigation";
+import { useHashRoute } from "./sandbox/useHashRoute";
+import TopbarSearch from "./sandbox/TopbarSearch";
+import { LandingShowcase } from "./sandbox/LandingShowcase";
+import NotFoundShowcase from "./sandbox/NotFoundShowcase";
 
-// Group definitions for the sidebar (UI System showroom). Estático: se define
-// fuera del componente para que su referencia sea estable en los deps del memo.
-const categories = [
-  {
-    id: "general",
-    label: "General",
-    icon: <FaHome />,
-    subitems: [
-      { id: "getting-started", label: "Getting Started" },
-      { id: "sizes", label: "Medidas · sm / md / lg" },
-    ],
-  },
-  {
-    id: "struc",
-    label: "Estructura & Layout",
-    icon: <FaCreditCard />,
-    subitems: [
-      { id: "layout", label: "ITLayout & ITNavbar" },
-      { id: "stack", label: "ITStack" },
-      { id: "flex", label: "ITFlex" },
-      { id: "grid", label: "ITGrid" },
-      { id: "card", label: "ITCard" },
-      { id: "text", label: "ITText" },
-      { id: "accordion", label: "ITAccordion" },
-      { id: "pageheader", label: "ITPageHeader" },
-      { id: "page", label: "ITPage" },
-      { id: "screen-dashboard", label: "Dashboard Ejemplo" },
-      { id: "screen-form", label: "Formulario Ejemplo" },
-    ],
-  },
-  {
-    id: "forms",
-    label: "Formularios & Inputs",
-    icon: <FaKeyboard />,
-    subitems: [
-      { id: "button", label: "ITButton" },
-      { id: "input", label: "ITInput" },
-      { id: "select", label: "ITSelect" },
-      { id: "searchselect", label: "ITSearchSelect" },
-      { id: "multiselect", label: "ITMultiSelect" },
-      { id: "chipinput", label: "ITChipInput" },
-      { id: "field", label: "ITField" },
-      { id: "datepicker", label: "ITDatePicker" },
-      { id: "timepicker", label: "ITTimePicker" },
-      { id: "calendar", label: "ITCalendar" },
-      { id: "slidetoggle", label: "ITSlideToggle" },
-      { id: "dropfile", label: "ITDropfile" },
-      { id: "wysiwyg", label: "ITWysiwyg" },
-      { id: "formbuilder", label: "ITFormBuilder" },
-    ],
-  },
-  {
-    id: "data",
-    label: "Visualización Datos",
-    icon: <FaTable />,
-    subitems: [
-      { id: "table", label: "ITTable" },
-      { id: "datatable", label: "ITDataTable" },
-      { id: "badget", label: "ITBadget" },
-      { id: "chip", label: "ITChip" },
-      { id: "image", label: "ITImage" },
-    ],
-  },
-  {
-    id: "nav",
-    label: "Navegación & Control",
-    icon: <FaSlidersH />,
-    subitems: [
-      { id: "tabs", label: "ITTabs" },
-      { id: "stepper", label: "ITStepper" },
-      { id: "pagination", label: "ITPagination" },
-      { id: "triplefilter", label: "ITTripleFilter" },
-      { id: "dropdownmenu", label: "ITDropdownMenu" },
-    ],
-  },
-  {
-    id: "feed",
-    label: "Feedback & Sistema",
-    icon: <FaRegBell />,
-    subitems: [
-      { id: "dialog", label: "ITDialog" },
-      { id: "toast", label: "ITToast" },
-      { id: "loader", label: "ITLoader" },
-      { id: "themeprovider", label: "ITThemeProvider" },
-    ],
-  },
-];
+// Icons per sandbox group (icons stay here; navigation.ts is plain data).
+const GROUP_ICONS: Record<string, React.ReactNode> = {
+  general: <FaHome />,
+  struc: <FaCreditCard />,
+  forms: <FaKeyboard />,
+  data: <FaTable />,
+  nav: <FaSlidersH />,
+  feed: <FaRegBell />,
+};
 
 function App() {
-  const [view, setView] = useState<ViewMode>(() => {
-    const hash = window.location.hash.replace("#", "");
-    return hash.startsWith("ui-system") ? "ui-system" : "home";
-  });
-  const [showroomActive, setShowroomActive] = useState("screen-form");
-  const [searchTerm] = useState("");
-  const [subitemConnector] = useState<
-    "dot" | "|" | "none"
-  >("dot");
+  const { route, goToItem, goToLanding, goToPortfolio } = useHashRoute();
+  const [subitemConnector] = useState<"dot" | "|" | "none">("dot");
 
-  useEffect(() => {
-    const onHashChange = () => {
-      const hash = window.location.hash.replace("#", "");
-      setView(hash.startsWith("ui-system") ? "ui-system" : "home");
-    };
-    window.addEventListener("hashchange", onHashChange);
-    return () => window.removeEventListener("hashchange", onHashChange);
-  }, []);
+  // Debounced term drives filtering; `searchValue` is the live input value.
+  const [debouncedTerm, setDebouncedTerm] = useState("");
+  const {
+    searchTerm: searchValue,
+    handleSearchChange,
+    handleClearSearch,
+  } = useDebouncedSearch({ debounceMs: 250, onSearch: setDebouncedTerm });
 
-  // Filter sidebar navigation items based on search term
-  const filteredNavigationItems = useMemo(() => {
-    return categories
-      .map((cat) => {
-        if (!cat.subitems) {
-          const matches =
-            cat.label.toLowerCase().includes(searchTerm.toLowerCase()) ||
-            cat.id.toLowerCase().includes(searchTerm.toLowerCase());
-          if (matches) {
-            return {
-              ...cat,
-              isActive: showroomActive === cat.id,
-              action: () => setShowroomActive(cat.id),
-            };
-          }
-          return null;
-        }
+  // The active component page (group-only routes fall back to the first item).
+  const showroomActive =
+    route.view === "ui-system" && route.valid
+      ? route.item ?? (route.group ? firstItemOf(route.group) : null)
+      : null;
 
-        const matchingSubitems = cat.subitems.filter(
-          (sub) =>
-            sub.label.toLowerCase().includes(searchTerm.toLowerCase()) ||
-            sub.id.toLowerCase().includes(searchTerm.toLowerCase()),
-        );
+  // Redirect `#ui-system/<group>` to the group's first item (replace, no history spam).
+  useEffect(() => {
+    if (route.view === "ui-system" && route.valid && route.group && !route.item) {
+      const first = firstItemOf(route.group);
+      if (first) goToItem(route.group, first, { replace: true });
+    }
+  }, [route, goToItem]);
 
-        const mappedSubitems = matchingSubitems.map((sub) => ({
+  // Sidebar navigation: grouped when idle, flat filtered leaves when searching.
+  const navigationItems = useMemo<ITNavigationItem[]>(() => {
+    const term = debouncedTerm.trim().toLowerCase();
+
+    if (!term) {
+      return SANDBOX_GROUPS.map((group) => {
+        const subitems = group.subitems.map((sub) => ({
           id: sub.id,
           label: sub.label,
           isActive: showroomActive === sub.id,
-          action: () => setShowroomActive(sub.id),
+          action: () => goToItem(group.id, sub.id),
         }));
-
-        const isAnySubitemActive = mappedSubitems.some((sub) => sub.isActive);
-
         return {
-          ...cat,
-          isActive: isAnySubitemActive,
-          subitems: mappedSubitems,
+          id: group.id,
+          label: group.label,
+          icon: GROUP_ICONS[group.id],
+          isActive: subitems.some((sub) => sub.isActive),
+          subitems,
         };
-      })
-      .filter((cat): cat is Exclude<typeof cat, null> => {
-        if (!cat) return false;
-        if (cat.subitems) return cat.subitems.length > 0;
-        return true;
       });
-  }, [searchTerm, showroomActive]);
+    }
+
+    const flat: ITNavigationItem[] = [];
+    SANDBOX_GROUPS.forEach((group) => {
+      const groupMatches =
+        group.label.toLowerCase().includes(term) ||
+        group.id.toLowerCase().includes(term);
+      const groupBadge = group.label.split(" ")[0];
+
+      group.subitems
+        .filter(
+          (sub) =>
+            groupMatches ||
+            sub.label.toLowerCase().includes(term) ||
+            sub.id.toLowerCase().includes(term),
+        )
+        .forEach((sub) => {
+          flat.push({
+            id: sub.id,
+            label: sub.label,
+            icon: GROUP_ICONS[group.id],
+            badge: groupBadge,
+            isActive: showroomActive === sub.id,
+            action: () => goToItem(group.id, sub.id),
+          });
+        });
+    });
+    return flat;
+  }, [debouncedTerm, showroomActive, goToItem]);
 
+  // Sidebar is UNCONTROLLED: ITLayout's internal default is the 88px rail and the
+  // rail expands automatically on hover. No toggle button — the hover is the control.
+  // The component search lives in the topbar because a hover-only rail can't host it.
   const sidebarProps = {
-    navigationItems: filteredNavigationItems,
+    navigationItems,
     subitemConnector,
   };
 
   const topBarProps = {
     logoText: "AXZY UI System",
+    centerContent: (
+      <TopbarSearch
+        value={searchValue}
+        onChange={handleSearchChange}
+        onClear={handleClearSearch}
+        resultCount={navigationItems.length}
+        pending={searchValue.trim() !== debouncedTerm.trim()}
+      />
+    ),
+    // The topbar places `children` in its right area, right before the user menu.
+    children: (
+      <button
+        type="button"
+        aria-label="Notificaciones"
+        title="Notificaciones"
+        className="relative flex items-center justify-center p-2.5 rounded-xl transition-colors duration-200 hover:bg-[var(--it-topbar-user-hover,#f1f5f9)] focus:outline-none focus-visible:ring-2 focus-visible:ring-inset focus-visible:ring-primary-400"
+        style={{ color: "var(--it-topbar-icon, #94a3b8)" }}
+      >
+        <FaRegBell className="w-5 h-5" aria-hidden="true" />
+        <span className="absolute top-1.5 right-1.5 w-2 h-2 rounded-full bg-red-500 ring-2 ring-white" />
+      </button>
+    ),
+    navItems: [
+      {
+        id: "ui-system",
+        label: "UI System",
+        action: () => goToLanding(),
+      },
+      {
+        id: "portfolio",
+        label: "Portafolio",
+        action: () => goToPortfolio(),
+      },
+    ],
+    onNavItemClick: (id: string) => {
+      if (id === "ui-system") goToLanding();
+      else if (id === "portfolio") goToPortfolio();
+    },
     userMenu: {
       userName: "Alex Dev",
       userEmail: "alex@axzy.dev",
       menuItems: [
         {
           label: "Ir al Portafolio",
-          onClick: () => {
-            window.location.hash = "home";
-          },
+          onClick: () => goToPortfolio(),
         },
       ],
     },
   };
 
   // Render correct component based on active showroom navigation
-  const renderShowcase = () => {
-    switch (showroomActive) {
+  const renderShowcase = (itemId: string | null) => {
+    switch (itemId) {
       case "getting-started":
         return <GettingStartedShowcase />;
       // Structure
@@ -294,6 +275,8 @@ function App() {
         return <DatePickerShowcase />;
       case "timepicker":
         return <TimePickerShowcase />;
+      case "maskedinput":
+        return <MaskedInputShowcase />;
       case "calendar":
         return <CalendarShowcase />;
       case "slidetoggle":
@@ -336,13 +319,19 @@ function App() {
       case "themeprovider":
         return <ThemeProviderShowcase />;
       default:
-        return <GettingStartedShowcase />;
+        return (
+          <NotFoundShowcase
+            attempted={route.raw}
+            onGoLanding={() => goToLanding()}
+            onGoPortfolio={goToPortfolio}
+          />
+        );
     }
   };
 
   return (
     <ITThemeProvider showFab={false} density={0.98} radius={10} shadow={2}>
-      {view === "home" ? (
+      {route.view === "home" ? (
         <div className="min-h-screen bg-slate-50 dark:bg-slate-950 py-10 px-4 sm:px-6 lg:px-8">
           <div className="max-w-6xl mx-auto">
             <HomeShowcase />
@@ -350,9 +339,20 @@ function App() {
         </div>
       ) : (
         <ITLayout sidebar={sidebarProps} topBar={topBarProps}>
-          <div className="max-w-7xl mx-auto">
-            {renderShowcase()}
-          </div>
+          {!route.valid ? (
+            <NotFoundShowcase
+              attempted={route.raw}
+              onGoLanding={() => goToLanding()}
+              onGoPortfolio={goToPortfolio}
+            />
+          ) : !route.group && !route.item ? (
+            <LandingShowcase
+              onOpenItem={goToItem}
+              onOpenPortfolio={goToPortfolio}
+            />
+          ) : (
+            renderShowcase(showroomActive)
+          )}
         </ITLayout>
       )}
     </ITThemeProvider>

package/src/components/molecules/calendar/calendar.doc.mdx

@@ -61,7 +61,8 @@ import { ITCalendar } from '@axzydev/axzy_ui_system';
 - **month** — Traditional month grid with date picker, single and range selection modes.
 - **week** — 7-column time grid from 6 AM to 10 PM with event overlays and drag-to-select range.
 - **day** — Single-column time grid for focused daily scheduling.
-- **years** — Click the month/year header to switch to a year selection view (12-year grid).
+- **years** — Click the year in the header to switch to a year selection view (12-year grid).
+- **months** — Click the month name in the header (or pick a year) to switch to a month selection view (12-month grid, same style as the year grid). Flow: header → year → month → days.
 - Uses `date-fns` with Spanish locale (`es`) for month and weekday names.
 - Month view supports `minDate`/`maxDate` boundaries — out-of-range dates are disabled and dimmed.
 - Events render as colored bars in week/day views with customizable `color` prop.

package/src/components/molecules/calendar/calendar.tsx

@@ -78,7 +78,7 @@ export const ITCalendar: React.FC<ITCalendarProps> = ({
   const mode = modeProp || (onChange ? 'month' : 'week');
   
   const [currentDate, setCurrentDate] = useState(value || new Date());
-  const [view, setView] = useState<'calendar' | 'years'>('calendar');
+  const [view, setView] = useState<'calendar' | 'years' | 'months'>('calendar');
 
   // Selection/Accent colors based on variant
   const getVariantStyles = () => {
@@ -96,6 +96,25 @@ export const ITCalendar: React.FC<ITCalendarProps> = ({
     if (value) setCurrentDate(value);
   }, [value]);
 
+  // Shift the view year while keeping the day-of-month safe (clamped to target month).
+  const shiftYear = (yearDelta: number) => {
+    setCurrentDate((d) => {
+      const year = d.getFullYear() + yearDelta;
+      const daysInTarget = new Date(year, d.getMonth() + 1, 0).getDate();
+      return new Date(year, d.getMonth(), Math.min(d.getDate(), daysInTarget));
+    });
+  };
+
+  // Jump to a month of the currently viewed year (day-of-month clamped).
+  const pickMonth = (monthIndex: number) => {
+    setCurrentDate((d) => {
+      const year = d.getFullYear();
+      const daysInTarget = new Date(year, monthIndex + 1, 0).getDate();
+      return new Date(year, monthIndex, Math.min(d.getDate(), daysInTarget));
+    });
+    setView('calendar');
+  };
+
   // Navigation handlers
   const handleNext = () => {
     if (view === 'years') {
@@ -104,6 +123,8 @@ export const ITCalendar: React.FC<ITCalendarProps> = ({
         newDate.setFullYear(d.getFullYear() + 12);
         return newDate;
       });
+    } else if (view === 'months') {
+      shiftYear(1);
     } else if (mode === 'month') {
       setCurrentDate((d) => addMonths(d, 1));
     } else if (mode === 'day') {
@@ -120,7 +141,9 @@ export const ITCalendar: React.FC<ITCalendarProps> = ({
         newDate.setFullYear(d.getFullYear() - 12);
         return newDate;
       });
-     } else if (mode === 'month') {
+     } else if (view === 'months') {
+      shiftYear(-1);
+    } else if (mode === 'month') {
       setCurrentDate((d) => addMonths(d, -1));
     } else if (mode === 'day') {
       setCurrentDate((d) => addDays(d, -1));
@@ -249,6 +272,7 @@ export const ITCalendar: React.FC<ITCalendarProps> = ({
   // ----------------------------------------------------------------------
   const startYear = currentDate.getFullYear() - 6;
   const years = Array.from({ length: 12 }, (_, i) => startYear + i);
+  const months = Array.from({ length: 12 }, (_, i) => i);
 
   // ----------------------------------------------------------------------
   // Render
@@ -277,25 +301,50 @@ export const ITCalendar: React.FC<ITCalendarProps> = ({
           borderBottomColor: 'var(--it-calendar-border, #e2e8f0)'
         }}
       >
-        <ITText
-            as="h2"
-            className="text-sm font-bold capitalize cursor-pointer transition-colors select-none px-2 py-1 rounded"
-            style={{ 
-              color: 'var(--it-calendar-header-text, #1e293b)',
-            }}
-             onClick={() => setView(view === 'calendar' ? 'years' : 'calendar')}
-             onMouseEnter={(e) => {
-               e.currentTarget.style.backgroundColor = 'var(--it-calendar-header-hover, #f1f5f9)';
-             }}
-             onMouseLeave={(e) => {
-               e.currentTarget.style.backgroundColor = 'transparent';
-             }}
-        >
-          {view === 'years' 
-            ? `${years[0]} - ${years[years.length - 1]}` 
-            : format(currentDate, 'MMMM yyyy', { locale: es })
-          }
-        </ITText>
+        {view === 'years' ? (
+          <ITText
+              as="h2"
+              className="text-sm font-bold select-none px-2 py-1"
+              style={{ 
+                color: 'var(--it-calendar-header-text, #1e293b)',
+              }}
+          >
+            {`${years[0]} - ${years[years.length - 1]}`}
+          </ITText>
+        ) : (
+          <div className="flex items-center">
+            {view !== 'months' && (
+              <button
+                type="button"
+                onClick={() => setView('months')}
+                className="text-sm font-bold capitalize select-none px-2 py-1 rounded transition-colors"
+                style={{ color: 'var(--it-calendar-header-text, #1e293b)' }}
+                onMouseEnter={(e) => {
+                  e.currentTarget.style.backgroundColor = 'var(--it-calendar-header-hover, #f1f5f9)';
+                }}
+                onMouseLeave={(e) => {
+                  e.currentTarget.style.backgroundColor = 'transparent';
+                }}
+              >
+                {format(currentDate, 'MMMM', { locale: es })}
+              </button>
+            )}
+            <button
+              type="button"
+              onClick={() => setView('years')}
+              className="text-sm font-bold select-none px-2 py-1 rounded transition-colors"
+              style={{ color: 'var(--it-calendar-header-text, #1e293b)' }}
+              onMouseEnter={(e) => {
+                e.currentTarget.style.backgroundColor = 'var(--it-calendar-header-hover, #f1f5f9)';
+              }}
+              onMouseLeave={(e) => {
+                e.currentTarget.style.backgroundColor = 'transparent';
+              }}
+            >
+              {format(currentDate, 'yyyy')}
+            </button>
+          </div>
+        )}
         <div className="flex items-center gap-1">
           <button 
             onClick={handlePrev} 
@@ -359,13 +408,41 @@ export const ITCalendar: React.FC<ITCalendarProps> = ({
                                   newDate.setFullYear(year);
                                   return newDate;
                               });
-                              setView('calendar');
+                              setView('months');
                           }}
                       >
                           <ITText as="span">{year}</ITText>
                       </button>
                   ))}
               </div>
+        ) : view === 'months' ? (
+              <div className="p-4 grid grid-cols-4 gap-2">
+                  {months.map(monthIndex => {
+                      const isActive = monthIndex === currentDate.getMonth();
+                      return (
+                          <button
+                              key={monthIndex}
+                              type="button"
+                              className={cn(
+                                  "h-10 rounded-md text-sm font-medium transition-colors border border-transparent",
+                                  isActive
+                                    ? "bg-[var(--it-calendar-selected-bg)] text-[var(--it-calendar-selected-text)]"
+                                    : "hover:bg-[var(--it-calendar-today-bg)] hover:text-[var(--it-calendar-today-text)]"
+                              )}
+                              style={{
+                                  color: isActive
+                                    ? 'var(--it-calendar-selected-text, #ffffff)'
+                                    : 'var(--it-calendar-days-text, #334155)'
+                              }}
+                              onClick={() => pickMonth(monthIndex)}
+                          >
+                              <ITText as="span" className="capitalize">
+                                  {format(new Date(2000, monthIndex, 1), 'MMM', { locale: es })}
+                              </ITText>
+                          </button>
+                      );
+                  })}
+              </div>
         ) : mode === 'month' ? (
            <div className="p-4">
              {/* Weekday Headers */}
@@ -396,6 +473,7 @@ export const ITCalendar: React.FC<ITCalendarProps> = ({
                       onClick={() => onChange && onChange(day)}
                       className={cn(
                         "h-10 w-full flex items-center justify-center rounded-md text-sm transition-colors relative",
+                        "text-[var(--it-calendar-days-text)] hover:bg-[var(--it-calendar-today-bg)] hover:text-[var(--it-calendar-today-text)]",
                         !isCurrentMonth && "opacity-40",
                         isDisabled && "opacity-20 cursor-not-allowed",
                       )}
@@ -406,12 +484,12 @@ export const ITCalendar: React.FC<ITCalendarProps> = ({
                             ? 'var(--it-calendar-range-bg, #eff6ff)'
                             : isToday(day)
                               ? 'var(--it-calendar-today-bg, #eff6ff)'
-                              : 'transparent',
+                              : undefined,
                         color: isSelected || isRangeStart || isRangeEnd
                           ? 'var(--it-calendar-selected-text, #ffffff)'
                           : isToday(day)
                             ? 'var(--it-calendar-today-text, #2563eb)'
-                            : 'var(--it-calendar-days-text, #334155)',
+                            : undefined,
                         fontWeight: isSelected || isRangeStart || isRangeEnd || isToday(day) ? '700' : '400',
                       }}
                     >