siesa-ui-kit 1.0.3 → 1.0.5

package/src/components/Input/Input.tsx

@@ -0,0 +1,204 @@
+import React, { forwardRef, cloneElement } from 'react';
+import type { InputProps } from './Input.types';
+
+/**
+ * Input - Componente de campo de entrada del sistema de diseño Siesa
+ * Basado en especificaciones de Figma con Tailwind CSS
+ *
+ * Mejores prácticas implementadas:
+ * - Orden de modificadores: {responsive}:{dark}:{state}:{utility}
+ * - Dark mode con estrategia 'class' (darkMode: 'class')
+ * - Focus rings adaptativos para light y dark mode
+ * - Tokens de color consistentes con la documentación
+ * - Sombra base para inputs con focus
+ * - Estados hover, focus, disabled y error completos
+ * - Typography: Paragraph Regular para texto, Label Bold para labels
+ *
+ * Campo de entrada de texto con soporte para:
+ * - Estados: default, hover, focus, filled, disabled
+ * - Validación con mensajes de error
+ * - Iconos izquierdo y derecho
+ * - Label y helper text
+ * - Dark mode completo
+ * - Accesibilidad completa
+ *
+ * @see docs/colors.md - Sistema de colores
+ * @see docs/shadows.md - Sistema de sombras
+ * @see docs/typography.md - Sistema tipográfico (Paragraph, Label)
+ * @see docs/spacing.md - Sistema de espaciado
+ *
+ * @example
+ * ```tsx
+ * <Input
+ *   label="Email"
+ *   placeholder="tu@email.com"
+ *   leftIcon={<EnvelopeIcon />}
+ *   helperText="Ingresa tu correo electrónico"
+ * />
+ * ```
+ */
+export const Input = forwardRef<HTMLInputElement, InputProps>(
+  (
+    {
+      label,
+      labelSecondary,
+      helperText,
+      error = false,
+      errorMessage,
+      leftIcon,
+      rightIcon,
+      fullWidth = false,
+      className = '',
+      disabled = false,
+      id,
+      ...props
+    },
+    ref
+  ) => {
+    // Generar ID único si no se proporciona
+    const inputId = id || `input-${Math.random().toString(36).substr(2, 9)}`;
+
+    // ===== CLASES BASE DEL INPUT =====
+    // Usando el sistema tipográfico Paragraph Regular (14px = text-sm)
+    // Border radius rounded-md (6px) consistente con Button
+    const baseInputClasses = `
+      w-full
+      px-3
+      py-1.5
+      text-sm
+      leading-6
+      font-normal
+      text-content-primary
+      bg-bg-primary
+      border
+      border-border-primary
+      rounded-md
+      outline-none
+      transition-all
+      duration-150
+      placeholder:text-content-tertiary
+      dark:bg-dark-bg-primary
+      dark:border-dark-border-primary
+      dark:text-dark-content-primary
+      dark:placeholder:text-dark-content-tertiary
+    `;
+
+    // ===== CLASES PARA ESTADOS INTERACTIVOS =====
+    // Orden de modificadores: {responsive}:{dark}:{state}:{utility}
+    // Focus rings adaptativos siguiendo el patrón de Button
+    const interactiveClasses = !disabled
+      ? `
+        hover:border-primary-custom-600
+        focus:border-primary-custom-600
+        focus:ring-2
+        focus:ring-primary-custom-400
+        focus:ring-offset-2
+        dark:hover:border-dark-border-custom
+        dark:focus:border-dark-border-custom
+        dark:focus:ring-dark-border-custom
+        dark:focus:ring-offset-dark-bg-primary
+      `
+      : `
+        opacity-50
+        cursor-not-allowed
+        bg-bg-secondary
+        dark:bg-dark-bg-secondary
+      `;
+
+    // ===== CLASES PARA ESTADO DE ERROR =====
+    // Los colores de error son los mismos en light y dark mode
+    const errorClasses = error
+      ? `
+        !border-error-border
+        focus:!ring-error-border/30
+        focus:!ring-offset-2
+        dark:!border-error-border
+        dark:focus:!ring-error-border/30
+        dark:focus:!ring-offset-dark-bg-primary
+      `
+      : '';
+
+    // ===== CLASES DEL CONTENEDOR =====
+    const containerClasses = fullWidth ? 'w-full' : 'w-[265px]';
+
+    // ===== RENDERIZAR ICONOS =====
+    // Clonar iconos con estilos apropiados y dark mode completo
+    const renderIcon = (icon: React.ReactElement | undefined) => {
+      if (!icon) return null;
+      const existingClassName = (icon.props as any).className || '';
+      return cloneElement(icon as React.ReactElement<any>, {
+        className: `w-4 h-4 text-content-tertiary dark:text-dark-content-tertiary ${existingClassName}`,
+      });
+    };
+
+    return (
+      <div className={`flex flex-col gap-2 ${containerClasses} ${className}`}>
+        {/* Label */}
+        {label && (
+          <label
+            htmlFor={inputId}
+            className="flex items-center w-full font-bold text-sm leading-5 text-content-primary dark:text-dark-content-primary"
+          >
+            <span className="flex-1">{label}</span>
+            {labelSecondary && (
+              <span className="text-xs leading-4 text-primary-custom-600 dark:text-primary-custom-600">
+                {labelSecondary}
+              </span>
+            )}
+          </label>
+        )}
+
+        {/* Input Container */}
+        <div className="relative flex items-center">
+          {/* Left Icon */}
+          {leftIcon && (
+            <div className="absolute left-3 pointer-events-none">
+              {renderIcon(leftIcon)}
+            </div>
+          )}
+
+          {/* Input Field */}
+          <input
+            ref={ref}
+            id={inputId}
+            disabled={disabled}
+            className={`
+              ${baseInputClasses}
+              ${interactiveClasses}
+              ${errorClasses}
+              ${leftIcon ? 'pl-9' : ''}
+              ${rightIcon ? 'pr-9' : ''}
+            `.trim().replace(/\s+/g, ' ')}
+            {...props}
+          />
+
+          {/* Right Icon */}
+          {rightIcon && (
+            <div className="absolute right-3 pointer-events-none">
+              {renderIcon(rightIcon)}
+            </div>
+          )}
+        </div>
+
+        {/* Helper Text or Error Message */}
+        {(helperText || errorMessage) && (
+          <p
+            className={`
+              text-xs
+              leading-5
+              ${
+                error
+                  ? 'text-error-content dark:text-error-content'
+                  : 'text-content-tertiary dark:text-dark-content-tertiary'
+              }
+            `.trim().replace(/\s+/g, ' ')}
+          >
+            {error && errorMessage ? errorMessage : helperText}
+          </p>
+        )}
+      </div>
+    );
+  }
+);
+
+Input.displayName = 'Input';

package/src/components/Input/Input.types.ts

@@ -0,0 +1,80 @@
+import type { ReactElement, InputHTMLAttributes } from 'react';
+
+/**
+ * Estados visuales del Input
+ * @description Tipo de referencia para documentar los estados posibles del Input.
+ * Los estados se manejan automáticamente mediante props (disabled) y pseudo-clases CSS (:hover, :focus)
+ */
+export type InputState = 'default' | 'hover' | 'focus' | 'filled' | 'disabled';
+
+/**
+ * Props del componente Input
+ *
+ * @see docs/colors.md - Sistema de colores
+ * @see docs/typography.md - Sistema tipográfico
+ * @see docs/spacing.md - Sistema de espaciado
+ * @see docs/shadows.md - Sistema de sombras
+ */
+export interface InputProps extends Omit<InputHTMLAttributes<HTMLInputElement>, 'size'> {
+  /**
+   * Etiqueta del campo de entrada
+   * @description Texto descriptivo que se muestra encima del input
+   * @example "Email", "Nombre completo", "Contraseña"
+   */
+  label?: string;
+
+  /**
+   * Texto secundario junto al label (opcional)
+   * @description Se muestra alineado a la derecha del label, útil para indicar campos opcionales
+   * @example "Optional", "Opcional"
+   */
+  labelSecondary?: string;
+
+  /**
+   * Texto de ayuda debajo del input
+   * @description Proporciona información adicional o instrucciones para el usuario
+   * @example "Ingresa tu correo electrónico", "Mínimo 8 caracteres"
+   */
+  helperText?: string;
+
+  /**
+   * Indica si hay un error de validación
+   * @description Cambia el estilo del input para indicar error (borde rojo)
+   * @default false
+   */
+  error?: boolean;
+
+  /**
+   * Mensaje de error a mostrar (reemplaza helperText cuando error=true)
+   * @description Se muestra en rojo debajo del input cuando hay un error
+   * @example "Este campo es requerido", "Formato de email inválido"
+   */
+  errorMessage?: string;
+
+  /**
+   * Icono a mostrar a la izquierda del input
+   * @description Ayuda a identificar el tipo de campo visualmente
+   * @example <EnvelopeIcon />, <UserIcon />, <LockClosedIcon />
+   */
+  leftIcon?: ReactElement;
+
+  /**
+   * Icono a mostrar a la derecha del input
+   * @description Útil para acciones como mostrar/ocultar contraseña o limpiar campo
+   * @example <EyeIcon />, <XMarkIcon />, <CheckIcon />
+   */
+  rightIcon?: ReactElement;
+
+  /**
+   * Si el input ocupa todo el ancho del contenedor
+   * @description Por defecto usa w-[265px], con fullWidth usa w-full
+   * @default false
+   */
+  fullWidth?: boolean;
+
+  /**
+   * Clases CSS adicionales para personalizar el componente
+   * @description Se aplican al contenedor principal del input
+   */
+  className?: string;
+}

package/src/components/Input/icons.tsx

@@ -0,0 +1,145 @@
+/**
+ * Icons para Input Component
+ * Basado en Heroicons Micro
+ */
+
+export const EnvelopeIcon = () => (
+  <svg
+    xmlns="http://www.w3.org/2000/svg"
+    viewBox="0 0 16 16"
+    fill="currentColor"
+    className="w-4 h-4"
+  >
+    <path d="M2.5 3A1.5 1.5 0 0 0 1 4.5v.793c.026.009.051.02.076.032L7.674 8.51c.206.1.446.1.652 0l6.598-3.185A.755.755 0 0 1 15 5.293V4.5A1.5 1.5 0 0 0 13.5 3h-11Z" />
+    <path d="M15 6.954 8.978 9.86a2.25 2.25 0 0 1-1.956 0L1 6.954V11.5A1.5 1.5 0 0 0 2.5 13h11a1.5 1.5 0 0 0 1.5-1.5V6.954Z" />
+  </svg>
+);
+
+export const QuestionMarkCircleIcon = () => (
+  <svg
+    xmlns="http://www.w3.org/2000/svg"
+    viewBox="0 0 16 16"
+    fill="currentColor"
+    className="w-4 h-4"
+  >
+    <path
+      fillRule="evenodd"
+      d="M15 8A7 7 0 1 1 1 8a7 7 0 0 1 14 0ZM6.75 6.5a1.25 1.25 0 1 1 2.5 0 .75.75 0 0 0 1.5 0 2.75 2.75 0 0 0-4.25-2.308.75.75 0 0 0 .75 1.298A1.25 1.25 0 0 1 6.75 6.5ZM8 10a.75.75 0 0 0-.75.75v.5a.75.75 0 0 0 1.5 0v-.5A.75.75 0 0 0 8 10Z"
+      clipRule="evenodd"
+    />
+  </svg>
+);
+
+export const UserIcon = () => (
+  <svg
+    xmlns="http://www.w3.org/2000/svg"
+    viewBox="0 0 16 16"
+    fill="currentColor"
+    className="w-4 h-4"
+  >
+    <path d="M8 8a3 3 0 1 0 0-6 3 3 0 0 0 0 6ZM12.735 14c.618 0 1.093-.561.872-1.139a6.002 6.002 0 0 0-11.215 0c-.22.578.254 1.139.872 1.139h9.47Z" />
+  </svg>
+);
+
+export const LockClosedIcon = () => (
+  <svg
+    xmlns="http://www.w3.org/2000/svg"
+    viewBox="0 0 16 16"
+    fill="currentColor"
+    className="w-4 h-4"
+  >
+    <path
+      fillRule="evenodd"
+      d="M8 1a3.5 3.5 0 0 0-3.5 3.5V7A1.5 1.5 0 0 0 3 8.5v5A1.5 1.5 0 0 0 4.5 15h7a1.5 1.5 0 0 0 1.5-1.5v-5A1.5 1.5 0 0 0 11.5 7V4.5A3.5 3.5 0 0 0 8 1Zm2 6V4.5a2 2 0 1 0-4 0V7h4Z"
+      clipRule="evenodd"
+    />
+  </svg>
+);
+
+export const MagnifyingGlassIcon = () => (
+  <svg
+    xmlns="http://www.w3.org/2000/svg"
+    viewBox="0 0 16 16"
+    fill="currentColor"
+    className="w-4 h-4"
+  >
+    <path
+      fillRule="evenodd"
+      d="M9.965 11.026a5 5 0 1 1 1.06-1.06l2.755 2.754a.75.75 0 1 1-1.06 1.06l-2.755-2.754ZM10.5 7a3.5 3.5 0 1 1-7 0 3.5 3.5 0 0 1 7 0Z"
+      clipRule="evenodd"
+    />
+  </svg>
+);
+
+export const EyeIcon = () => (
+  <svg
+    xmlns="http://www.w3.org/2000/svg"
+    viewBox="0 0 16 16"
+    fill="currentColor"
+    className="w-4 h-4"
+  >
+    <path d="M8 9.5a1.5 1.5 0 1 0 0-3 1.5 1.5 0 0 0 0 3Z" />
+    <path
+      fillRule="evenodd"
+      d="M1.38 8.28a.87.87 0 0 1 0-.566 7.003 7.003 0 0 1 13.238.006.87.87 0 0 1 0 .566A7.003 7.003 0 0 1 1.379 8.28ZM11 8a3 3 0 1 1-6 0 3 3 0 0 1 6 0Z"
+      clipRule="evenodd"
+    />
+  </svg>
+);
+
+export const EyeSlashIcon = () => (
+  <svg
+    xmlns="http://www.w3.org/2000/svg"
+    viewBox="0 0 16 16"
+    fill="currentColor"
+    className="w-4 h-4"
+  >
+    <path
+      fillRule="evenodd"
+      d="M3.28 2.22a.75.75 0 0 0-1.06 1.06l10.5 10.5a.75.75 0 1 0 1.06-1.06l-1.322-1.323a7.012 7.012 0 0 0 2.16-3.11.87.87 0 0 0 0-.567A7.003 7.003 0 0 0 4.82 3.76l-1.54-1.54Zm3.196 3.195 1.135 1.136A1.502 1.502 0 0 1 9.45 8.389l1.136 1.135a3 3 0 0 0-4.109-4.109Z"
+      clipRule="evenodd"
+    />
+    <path d="m7.812 10.994 1.816 1.816A7.003 7.003 0 0 1 1.38 8.28a.87.87 0 0 1 0-.566 6.985 6.985 0 0 1 1.113-2.039l2.513 2.513a3 3 0 0 0 2.806 2.806Z" />
+  </svg>
+);
+
+export const XMarkIcon = () => (
+  <svg
+    xmlns="http://www.w3.org/2000/svg"
+    viewBox="0 0 16 16"
+    fill="currentColor"
+    className="w-4 h-4"
+  >
+    <path d="M5.28 4.22a.75.75 0 0 0-1.06 1.06L6.94 8l-2.72 2.72a.75.75 0 1 0 1.06 1.06L8 9.06l2.72 2.72a.75.75 0 1 0 1.06-1.06L9.06 8l2.72-2.72a.75.75 0 0 0-1.06-1.06L8 6.94 5.28 4.22Z" />
+  </svg>
+);
+
+export const CheckIcon = () => (
+  <svg
+    xmlns="http://www.w3.org/2000/svg"
+    viewBox="0 0 16 16"
+    fill="currentColor"
+    className="w-4 h-4"
+  >
+    <path
+      fillRule="evenodd"
+      d="M12.416 3.376a.75.75 0 0 1 .208 1.04l-5 7.5a.75.75 0 0 1-1.154.114l-3-3a.75.75 0 0 1 1.06-1.06l2.353 2.353 4.493-6.74a.75.75 0 0 1 1.04-.207Z"
+      clipRule="evenodd"
+    />
+  </svg>
+);
+
+export const ExclamationCircleIcon = () => (
+  <svg
+    xmlns="http://www.w3.org/2000/svg"
+    viewBox="0 0 16 16"
+    fill="currentColor"
+    className="w-4 h-4"
+  >
+    <path
+      fillRule="evenodd"
+      d="M8 15A7 7 0 1 0 8 1a7 7 0 0 0 0 14ZM8 4a.75.75 0 0 1 .75.75v3a.75.75 0 0 1-1.5 0v-3A.75.75 0 0 1 8 4Zm0 8a1 1 0 1 0 0-2 1 1 0 0 0 0 2Z"
+      clipRule="evenodd"
+    />
+  </svg>
+);

package/{dist/components/Input/index.d.ts → src/components/Input/index.ts}

@@ -1,3 +1,2 @@
-export { Input } from './Input';
-export type { InputProps, InputState } from './Input.types';
-//# sourceMappingURL=index.d.ts.map
+export { Input } from './Input';
+export type { InputProps, InputState } from './Input.types';

package/src/components/LoginView/LoginView.stories.tsx

@@ -0,0 +1,148 @@
+import type { Meta, StoryObj } from '@storybook/react';
+import { LoginView } from './LoginView';
+
+const meta = {
+  title: 'Siesa UI Kit/LoginView',
+  component: LoginView,
+  parameters: {
+    layout: 'fullscreen',
+    docs: {
+      description: {
+        component: 'Vista completa de inicio de sesión del sistema Siesa.',
+      },
+    },
+  },
+  tags: ['autodocs'],
+  argTypes: {
+    onSubmit: {
+      action: 'submit',
+      description: 'Handler cuando se envía el formulario con (email, password)',
+    },
+    onForgotPassword: {
+      action: 'forgot-password',
+      description: 'Handler cuando se hace click en "Olvidé mi Contraseña"',
+    },
+    onSignUp: {
+      action: 'sign-up',
+      description: 'Handler cuando se hace click en "¿No tienes una cuenta?"',
+    },
+    isLoading: {
+      control: 'boolean',
+      description: 'Si el formulario está en estado de carga',
+    },
+    errorMessage: {
+      control: 'text',
+      description: 'Mensaje de error general a mostrar',
+    },
+    showBackground: {
+      control: 'boolean',
+      description: 'Si se muestra el fondo decorativo con imagen',
+    },
+    variant: {
+      control: 'select',
+      options: ['responsive', 'mobile', 'desktop'],
+      description: 'Variante de visualización: responsive (adapta al viewport), mobile (siempre mobile), desktop (siempre desktop)',
+      defaultValue: 'responsive',
+    },
+  },
+} satisfies Meta<typeof LoginView>;
+
+export default meta;
+type Story = StoryObj<typeof meta>;
+
+// ============================================
+// 1. DESKTOP
+// ============================================
+export const Desktop: Story = {
+  render: () => (
+    <div className="min-h-screen w-full">
+      <LoginView
+        onSubmit={(email, password) => {
+          console.log('Login:', { email, password });
+          alert(`Login con:\nEmail: ${email}\nPassword: ${password}`);
+        }}
+        onForgotPassword={() => {
+          console.log('Forgot password clicked');
+          alert('Redirigiendo a recuperación de contraseña...');
+        }}
+        onSignUp={() => {
+          console.log('Sign up clicked');
+          alert('Redirigiendo a registro...');
+        }}
+      />
+    </div>
+  ),
+};
+
+// ============================================
+// 2. CON ESTADO DE CARGA
+// ============================================
+export const Loading: Story = {
+  render: () => (
+    <div className="min-h-screen w-full">
+      <LoginView
+        isLoading={true}
+        onSubmit={(email, password) => {
+          console.log('Login:', { email, password });
+        }}
+        onForgotPassword={() => {
+          console.log('Forgot password clicked');
+        }}
+        onSignUp={() => {
+          console.log('Sign up clicked');
+        }}
+      />
+    </div>
+  ),
+};
+
+// ============================================
+// 3. CON MENSAJE DE ERROR
+// ============================================
+export const WithError: Story = {
+  render: () => (
+    <div className="min-h-screen w-full">
+      <LoginView
+        errorMessage="Credenciales incorrectas. Por favor verifica tu email y contraseña."
+        onSubmit={(email, password) => {
+          console.log('Login:', { email, password });
+          alert(`Login con:\nEmail: ${email}\nPassword: ${password}`);
+        }}
+        onForgotPassword={() => {
+          console.log('Forgot password clicked');
+          alert('Redirigiendo a recuperación de contraseña...');
+        }}
+        onSignUp={() => {
+          console.log('Sign up clicked');
+          alert('Redirigiendo a registro...');
+        }}
+      />
+    </div>
+  ),
+};
+
+// ============================================
+// 4. SIN FONDO DECORATIVO
+// ============================================
+export const WithoutBackground: Story = {
+  render: () => (
+    <div className="min-h-screen w-full bg-gray-100 dark:bg-gray-900">
+      <LoginView
+        showBackground={false}
+        onSubmit={(email, password) => {
+          console.log('Login:', { email, password });
+          alert(`Login con:\nEmail: ${email}\nPassword: ${password}`);
+        }}
+        onForgotPassword={() => {
+          console.log('Forgot password clicked');
+          alert('Redirigiendo a recuperación de contraseña...');
+        }}
+        onSignUp={() => {
+          console.log('Sign up clicked');
+          alert('Redirigiendo a registro...');
+        }}
+      />
+    </div>
+  ),
+};
+