@axzydev/axzy_ui_system 1.3.0 → 1.3.1

package/package.json

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

package/src/App.tsx

@@ -44,6 +44,7 @@ import {
   FormBuilderShowcase,
   WysiwygShowcase,
   FieldShowcase,
+  MaskedInputShowcase,
   MultiSelectShowcase,
   ChipInputShowcase,
 } from "./showcases/FormShowcases";
@@ -114,6 +115,7 @@ const categories = [
       { id: "field", label: "ITField" },
       { id: "datepicker", label: "ITDatePicker" },
       { id: "timepicker", label: "ITTimePicker" },
+      { id: "maskedinput", label: "ITMaskedInput" },
       { id: "calendar", label: "ITCalendar" },
       { id: "slidetoggle", label: "ITSlideToggle" },
       { id: "dropfile", label: "ITDropfile" },
@@ -294,6 +296,8 @@ function App() {
         return <DatePickerShowcase />;
       case "timepicker":
         return <TimePickerShowcase />;
+      case "maskedinput":
+        return <MaskedInputShowcase />;
       case "calendar":
         return <CalendarShowcase />;
       case "slidetoggle":

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',
                       }}
                     >

package/src/components/molecules/masked-input/masked-input.doc.mdx

@@ -0,0 +1,78 @@
+import { Meta, Title, Description, Primary, Controls, Stories } from '@storybook/blocks';
+import * as StoriesData from './masked-input.stories';
+
+<Meta of={StoriesData} />
+
+# ITMaskedInput
+
+Input con máscara de formato: defines un patrón y el usuario solo escribe los caracteres útiles; los separadores se insertan solos y los huecos se pintan con un carácter de relleno.
+
+## Props
+
+| Prop | Type | Default | Description |
+|------|------|---------|-------------|
+| `name` | `string` | required | Nombre del campo para formularios. |
+| `mask` | `string` | required | Patrón: `9`=dígito, `A`=letra (mayúscula), `a`=letra, `x`=alfanumérico, `*`=cualquiera. Cualquier otro carácter es un separador literal auto-insertado. |
+| `value` | `string` | — | Valor limpio (raw): solo caracteres útiles, sin separadores ni relleno. |
+| `onChange` | `(e) => void` | required | `e.target.value` es el valor raw. |
+| `onBlur` | `(e) => void` | — | Blur del input. |
+| `onComplete` | `(value) => void` | — | Dispara cuando la máscara queda llena. |
+| `pattern` | `RegExp` | — | Regex validada con full-match contra el raw en blur; si no cumple muestra error. |
+| `placeholderChar` | `string` | `"_"` | Carácter pintado en slots vacíos. |
+| `variant` | `ColorsTypes` | `"primary"` | Color de acento del tema. |
+| `size` | `"sm" \| "md" \| "lg"` | `"md"` | Tamaño del input. |
+| `label` | `string` | — | Etiqueta sobre el input. |
+| `disabled` | `boolean` | `false` | Desactiva el input. |
+| `required` | `boolean` | `false` | Marca el campo como requerido. |
+| `touched` | `boolean` | `false` | Indica si el campo fue tocado. |
+| `error` | `string \| boolean` | — | Estado de error. |
+| `className` | `string` | — | Clases del wrapper externo. |
+| `containerClassName` | `string` | — | Clases del contenedor del input. |
+| `iconLeft` / `iconRight` | `ReactNode` | — | Iconos laterales. |
+| `autoFocus` | `boolean` | `false` | Enfoca al montar. |
+
+## Tokens del mask
+
+| Token | Acepta |
+|-------|--------|
+| `9` | un dígito |
+| `A` | una letra (se guarda en mayúsculas) |
+| `a` | una letra (tal cual) |
+| `x` | un carácter alfanumérico |
+| `*` | cualquier carácter |
+| cualquier otro | literal insertado solo (p.ej. `-`, `/`, `(`, `)`, espacio) |
+
+## Usage
+
+```tsx
+import { ITMaskedInput } from '@axzydev/axzy_ui_system';
+
+// Código de activación
+<ITMaskedInput
+  name="code"
+  mask="xxxx-xxxx-xxxx"
+  label="Código"
+  onChange={(e) => setCode(e.target.value)}
+/>
+
+// Teléfono con validación regex sobre el valor limpio
+<ITMaskedInput
+  name="phone"
+  mask="(999) 999-9999"
+  pattern={/^\d{10}$/}
+  onChange={(e) => setPhone(e.target.value)}
+/>
+```
+
+## Notes
+
+- ¿El valor? **Solo caracteres útiles**: escribir `ABC1-2345-6789` devuelve `ABC123456789` en `onChange`.
+- El cursor salta a huecos vacíos con selección automática; borrar un separador lo vuelve a insertar.
+- `pattern` valida contra el raw completo (full-match); el mensaje de error genérico es "Formato inválido" salvo que pases `error` como string.
+- `onComplete` es ideal para tarjetas, CVV o códigos de un solo uso.
+
+## Stories
+
+<Primary />
+<Controls />
+<Stories />

package/src/components/molecules/masked-input/masked-input.props.ts

@@ -0,0 +1,58 @@
+import { ColorsTypes } from "@/types/colors.types";
+import { SizesTypes } from "@/types/sizes.types";
+import { ReactNode } from "react";
+
+export interface ITMaskedInputProps {
+  /** Unique name attribute for the underlying input element. */
+  name: string;
+  /**
+   * Mask pattern. Tokens are filled by the user and everything else is an
+   * auto-inserted literal.
+   * - `9` — digit
+   * - `A` — letter (stored uppercase)
+   * - `a` — letter
+   * - `x` — alphanumeric
+   * - `*` — any character
+   * - any other character ( `-`, `/`, `(`, `)`, ` `, `.` ) is a literal separator
+   * @example "xxxx-xxxx-xxxx"
+   * @example "(999) 999-9999"
+   * @example "9999-9999-9999-9999"
+   */
+  mask: string;
+  /** Clean value containing only the useful characters (no separators, no placeholders). */
+  value?: string;
+  /** Called when the masked value changes. `event.target.value` is the raw value without separators. */
+  onChange: (event: { target: { name: string; value: string } }) => void;
+  /** Called when the input loses focus. */
+  onBlur?: (event: React.FocusEvent<HTMLInputElement>) => void;
+  /** Fired when all token slots are filled with valid characters. */
+  onComplete?: (value: string) => void;
+  /** Optional regex full-matched against the raw value to validate the field (e.g. `/^\\d{16}$/`). */
+  pattern?: RegExp;
+  /** Character shown for empty token slots. @default "_" */
+  placeholderChar?: string;
+  /** Color variant matching the design system (ColorsTypes). @default "primary" */
+  variant?: ColorsTypes;
+  /** Size preset: "sm" | "md" | "lg". @default "md" */
+  size?: SizesTypes;
+  /** Label displayed above the input. */
+  label?: string;
+  /** Disables the input. @default false */
+  disabled?: boolean;
+  /** Marks the field as required. */
+  required?: boolean;
+  /** Visually indicates the field has been interacted with. */
+  touched?: boolean;
+  /** Error state — pass a string message or `true` for default styling. */
+  error?: string | boolean;
+  /** Additional CSS classes for the outer wrapper element. */
+  className?: string;
+  /** Additional CSS classes for the underlying input container. */
+  containerClassName?: string;
+  /** Icon element rendered on the left side of the input. */
+  iconLeft?: ReactNode;
+  /** Icon element rendered on the right side of the input. */
+  iconRight?: ReactNode;
+  /** Auto-focus the input on mount. @default false */
+  autoFocus?: boolean;
+}

package/src/components/molecules/masked-input/masked-input.stories.tsx

@@ -0,0 +1,126 @@
+import type { Meta } from '@storybook/react';
+import { useState } from 'react';
+import ITMaskedInput from './masked-input';
+
+const meta = {
+  title: 'Components/Form Elements/ITMaskedInput',
+  component: ITMaskedInput,
+  parameters: { layout: 'padded' },
+  argTypes: {
+    mask: { control: 'text' },
+    placeholderChar: { control: 'text' },
+    onChange: { action: 'changed' },
+    onComplete: { action: 'completed' },
+    disabled: { control: 'boolean' },
+    error: { control: 'text' },
+    variant: {
+      control: 'select',
+      options: ['primary', 'secondary', 'success', 'danger', 'warning', 'info', 'purple', 'gray'],
+    },
+    size: { control: 'select', options: ['sm', 'md', 'lg'] },
+  },
+} satisfies Meta<typeof ITMaskedInput>;
+
+export default meta;
+
+function CodeMaskedWrapper(args: any) {
+  const [value, setValue] = useState<string>('');
+  return (
+    <div className="w-full max-w-xs">
+      <ITMaskedInput
+        {...args}
+        value={value}
+        onChange={(e) => {
+          setValue(e.target.value);
+          args.onChange(e);
+        }}
+      />
+      <p className="mt-2 text-xs font-mono text-slate-500">
+        raw: {value || '(vacío)'}
+      </p>
+    </div>
+  );
+}
+
+export const Alphanumeric: any = {
+  render: CodeMaskedWrapper,
+  args: {
+    name: 'code',
+    label: 'Código único',
+    mask: 'xxxx-xxxx-xxxx',
+  },
+};
+
+export const Phone: any = {
+  render: CodeMaskedWrapper,
+  args: {
+    name: 'phone',
+    label: 'Teléfono',
+    mask: '(999) 999-9999',
+  },
+};
+
+export const CreditCard: any = {
+  render: CodeMaskedWrapper,
+  args: {
+    name: 'card',
+    label: 'Número de tarjeta',
+    mask: '9999-9999-9999-9999',
+    onComplete: undefined,
+  },
+};
+
+const PhoneValidatedWrapper = (args: any) => {
+  const [value, setValue] = useState<string>('5512345678');
+  const [complete, setComplete] = useState<string | null>(null);
+  return (
+    <div className="w-full max-w-xs">
+      <ITMaskedInput
+        {...args}
+        value={value}
+        onChange={(e) => {
+          setValue(e.target.value);
+          args.onChange(e);
+          setComplete(null);
+        }}
+        onComplete={(v) => setComplete(v)}
+      />
+      {complete && (
+        <p className="mt-2 text-xs font-mono text-emerald-600">
+          ¡Completo! raw: {complete}
+        </p>
+      )}
+    </div>
+  );
+};
+
+export const WithPattern: any = {
+  render: PhoneValidatedWrapper,
+  args: {
+    name: 'validated_phone',
+    label: 'Teléfono válido (regex)',
+    mask: '999-999-9999',
+    pattern: /^\d{9}$/,
+  },
+};
+
+export const Sizes: any = {
+  render: () => (
+    <div className="flex flex-col gap-4 w-full max-w-xs">
+      <ITMaskedInput name="sz_sm" label="Small" mask="xxxx-xxxx" size="sm" onChange={() => {}} />
+      <ITMaskedInput name="sz_md" label="Medium" mask="xxxx-xxxx" size="md" onChange={() => {}} />
+      <ITMaskedInput name="sz_lg" label="Large" mask="xxxx-xxxx" size="lg" onChange={() => {}} />
+    </div>
+  ),
+};
+
+export const Disabled: any = {
+  args: {
+    name: 'disabled_code',
+    label: 'Deshabilitado',
+    mask: 'xxxx-xxxx',
+    value: 'abcd',
+    disabled: true,
+    onChange: () => {},
+  },
+};