siesa-ui-kit 1.0.3 → 1.0.4

package/src/views/RecoverPasswordView/RecoverPasswordView.tsx

@@ -0,0 +1,376 @@
+import React, { useState } from 'react';
+import type { FormEvent } from 'react';
+import type { RecoverPasswordViewProps } from './RecoverPasswordView.types';
+import { EnvelopeIcon } from './icons';
+
+/**
+ * RecoverPasswordView - Vista de recuperación de contraseña del sistema Siesa
+ *
+ * Vista completa para restablecer contraseña que incluye:
+ * - Logo de Siesa
+ * - Campo de email para enviar instrucciones
+ * - Botón para regresar al login
+ * - Fondo decorativo opcional
+ *
+ * Mejores prácticas implementadas:
+ * - Orden de modificadores: {responsive}:{dark}:{state}:{utility}
+ * - Dark mode con estrategia 'class' (darkMode: 'class')
+ * - Tokens de color consistentes con la documentación
+ * - Type safety con TypeScript estricto
+ * - Accesibilidad con ARIA labels y manejo de formulario semántico
+ * - Validación de email básica
+ *
+ * @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
+ *
+ * @example
+ * ```tsx
+ * <RecoverPasswordView
+ *   onSubmit={(email) => console.log('Recover password for', email)}
+ *   onBackToLogin={() => console.log('Back to login')}
+ * />
+ * ```
+ */
+export const RecoverPasswordView: React.FC<RecoverPasswordViewProps> = ({
+  onSubmit,
+  onBackToLogin,
+  isLoading = false,
+  errorMessage,
+  successMessage,
+  className = '',
+  showBackground = true,
+  variant = 'responsive',
+}) => {
+  // ===== ESTADO LOCAL =====
+  const [email, setEmail] = useState('');
+  const [emailError, setEmailError] = useState('');
+
+  // ===== HANDLERS =====
+  const handleSubmit = (e: FormEvent<HTMLFormElement>) => {
+    e.preventDefault();
+
+    // Validación básica de email
+    const emailRegex = /^[^\s@]+@[^\s@]+\.[^\s@]+$/;
+    if (!emailRegex.test(email)) {
+      setEmailError('Por favor ingresa un email válido');
+      return;
+    }
+
+    setEmailError('');
+    onSubmit?.(email);
+  };
+
+  const handleEmailChange = (e: React.ChangeEvent<HTMLInputElement>) => {
+    setEmail(e.target.value);
+    if (emailError) setEmailError('');
+  };
+
+  return (
+    <div
+      className={[
+        'relative',
+        'min-h-screen',
+        'w-full',
+        'flex',
+        'flex-col',
+        'items-center',
+        'justify-center',
+        'box-border',
+        // Mobile: sin padding en el wrapper (el padding está en el contenedor)
+        'p-0',
+        // Desktop: padding para centrar el card
+        'md:p-4',
+        className,
+      ].join(' ')}
+    >
+      {/* ===== FONDO DECORATIVO (solo desktop) ===== */}
+      {showBackground && (
+        <div className="hidden md:block absolute inset-0 pointer-events-none" aria-hidden="true">
+          <div className="absolute inset-0 bg-[#dbeefe] dark:bg-[#112d57]" />
+          <img
+            src="/bg_siesa.jpg"
+            alt=""
+            className="absolute inset-0 w-full h-full object-cover opacity-10"
+          />
+        </div>
+      )}
+
+      {/* ===== CONTENEDOR PRINCIPAL ===== */}
+      <div
+        className={[
+          // Clases base comunes
+          'relative',
+          'box-border',
+          'flex',
+          'flex-col',
+          'items-center',
+          'justify-center',
+          'gap-4',
+          'p-16',
+          'shrink-0',
+          'bg-bg-primary',
+          'dark:bg-zinc-700',
+
+          // Clases específicas según variant
+          ...(variant === 'mobile' ? [
+            // Forzar mobile: sin efectos de card
+            'w-full',
+            'h-full',
+            'shadow-none',
+            'rounded-none',
+            'border-0',
+          ] : variant === 'desktop' ? [
+            // Forzar desktop: con efectos de card
+            'w-[400px]',
+            'h-auto',
+            'rounded-2xl',
+            'shadow-lg',
+            'dark:shadow-2xl',
+            'overflow-clip',
+            'border',
+            'border-transparent',
+            'dark:border-dark-border-primary',
+          ] : [
+            // Responsive: cambia según viewport
+            'w-full',
+            'h-full',
+            'shadow-none',
+            'rounded-none',
+            'border-0',
+            'md:w-[400px]',
+            'md:h-auto',
+            'md:rounded-2xl',
+            'md:shadow-lg',
+            'md:dark:shadow-2xl',
+            'md:overflow-clip',
+            'md:border',
+            'md:border-transparent',
+            'md:dark:border-dark-border-primary',
+          ]),
+        ].join(' ')}
+      >
+        {/* ===== LOGO ===== */}
+        <div className="w-full flex flex-col items-center pb-4">
+          <img
+            src="/.Siesa Logo.png"
+            alt="Siesa"
+            className="w-[200px] h-[50px] object-contain"
+          />
+        </div>
+
+        {/* ===== HEADING ===== */}
+        <div className="w-full text-center">
+          <h1
+            className={[
+              'text-[20px]',
+              'leading-[28px]',
+              'font-bold',
+              'tracking-[-0.5px]',
+              'text-content-primary',
+              'dark:text-dark-content-primary',
+            ].join(' ')}
+          >
+            Restablecer Contraseña
+          </h1>
+          <p
+            className={[
+              'text-[12px]',
+              'leading-[16px]',
+              'font-normal',
+              'text-content-primary',
+              'dark:text-dark-content-primary',
+            ].join(' ')}
+          >
+            Reestablece tu contraseña ingresando con tu correo electrónico.
+          </p>
+        </div>
+
+        {/* ===== MENSAJE DE ERROR GENERAL ===== */}
+        {errorMessage && (
+          <div
+            className={[
+              'w-full',
+              'p-3',
+              'bg-error-bg',
+              'dark:bg-error-bg',
+              'border',
+              'border-error-border',
+              'dark:border-error-border',
+              'rounded-md',
+              'text-error-content',
+              'dark:text-error-content',
+              'text-sm',
+            ].join(' ')}
+            role="alert"
+          >
+            {errorMessage}
+          </div>
+        )}
+
+        {/* ===== MENSAJE DE ÉXITO ===== */}
+        {successMessage && (
+          <div
+            className={[
+              'w-full',
+              'p-3',
+              'bg-[#d1fae5]',
+              'dark:bg-[#064e3b]',
+              'border',
+              'border-[#a7f3d0]',
+              'dark:border-[#065f46]',
+              'rounded-md',
+              'text-[#065f46]',
+              'dark:text-[#a7f3d0]',
+              'text-sm',
+            ].join(' ')}
+            role="status"
+          >
+            {successMessage}
+          </div>
+        )}
+
+        {/* ===== FORMULARIO ===== */}
+        <form onSubmit={handleSubmit} className="w-full flex flex-col gap-2">
+          {/* Email Input */}
+          <div className="flex flex-col gap-2 w-full">
+            <label
+              htmlFor="email-input"
+              className="font-bold text-sm leading-5 text-content-primary dark:text-dark-content-primary"
+            >
+              Correo Electrónico <span className="text-red-600">*</span>
+            </label>
+            <div className="relative">
+              <div className="absolute left-3 top-1/2 -translate-y-1/2 pointer-events-none opacity-50">
+                <EnvelopeIcon className="w-4 h-4 text-content-tertiary dark:text-dark-content-tertiary" />
+              </div>
+              <input
+                id="email-input"
+                type="email"
+                placeholder="ejemplo@miempresa.com"
+                value={email}
+                onChange={handleEmailChange}
+                disabled={isLoading}
+                required
+                autoComplete="email"
+                className={[
+                  'w-full',
+                  'pl-9',
+                  'pr-3',
+                  'py-1.5',
+                  'text-base',
+                  'leading-6',
+                  'bg-bg-primary',
+                  'dark:bg-zinc-700',
+                  'border',
+                  'border-[#e4e4e7]',
+                  'dark:border-dark-border-primary',
+                  'rounded-lg',
+                  'placeholder:text-content-tertiary',
+                  'dark:placeholder:text-dark-content-tertiary',
+                  'text-content-primary',
+                  'dark:text-dark-content-primary',
+                  'focus:outline-none',
+                  'focus:border-primary-custom-600',
+                  'dark:focus:border-dark-border-custom',
+                  'focus:ring-2',
+                  'focus:ring-primary-custom-400',
+                  'dark:focus:ring-dark-border-custom',
+                  'transition-all',
+                  'duration-150',
+                  emailError ? '!border-error-border' : '',
+                ].filter(Boolean).join(' ')}
+              />
+            </div>
+            {emailError && (
+              <p className="text-xs text-error-content dark:text-error-content">
+                {emailError}
+              </p>
+            )}
+          </div>
+
+          {/* Submit Button */}
+          <button
+            type="submit"
+            disabled={isLoading || !email}
+            className={[
+              'relative',
+              'w-full',
+              'px-[10px]',
+              'py-[6px]',
+              'flex',
+              'items-center',
+              'justify-center',
+              'gap-2',
+              'font-bold',
+              'text-sm',
+              'leading-5',
+              'text-[#eff8ff]',
+              'dark:text-[#0e79fd]',
+              'bg-[#0e79fd]',
+              'dark:bg-[#bfe2fe]',
+              'border',
+              'border-[#3c9bf6]',
+              'dark:border-[#93d1fd]',
+              'rounded-md',
+              'shadow-inner',
+              'hover:bg-primary-custom-500',
+              'dark:hover:bg-[#93d1fd]',
+              'active:scale-95',
+              'transition-all',
+              'duration-150',
+              'focus:outline-none',
+              'focus:ring-2',
+              'focus:ring-primary-custom-400',
+              'dark:focus:ring-[#93d1fd]',
+              'focus:ring-offset-2',
+              'dark:focus:ring-offset-[#3f3f46]',
+              'disabled:opacity-50',
+              'disabled:cursor-not-allowed',
+            ].join(' ')}
+          >
+            {isLoading ? 'Enviando...' : 'Reestablecer Contraseña'}
+          </button>
+        </form>
+
+        {/* ===== BACK TO LOGIN BUTTON ===== */}
+        <button
+          type="button"
+          onClick={onBackToLogin}
+          className={[
+            'w-full',
+            'px-[10px]',
+            'py-[6px]',
+            'flex',
+            'items-center',
+            'justify-center',
+            'gap-2',
+            'font-bold',
+            'text-sm',
+            'leading-5',
+            'text-[#0e79fd]',
+            'dark:text-[#93d1fd]',
+            'bg-transparent',
+            'border',
+            'border-[#93d1fd]',
+            'dark:border-[#93d1fd]',
+            'rounded-md',
+            'hover:bg-primary-custom-100',
+            'dark:hover:bg-[#93d1fd]/10',
+            'transition-all',
+            'duration-150',
+            'focus:outline-none',
+            'focus:ring-2',
+            'focus:ring-primary-custom-400',
+            'dark:focus:ring-[#93d1fd]',
+            'focus:ring-offset-2',
+            'dark:focus:ring-offset-[#3f3f46]',
+          ].join(' ')}
+        >
+          Iniciar Sesión
+        </button>
+      </div>
+    </div>
+  );
+};

package/src/views/RecoverPasswordView/RecoverPasswordView.types.ts

@@ -0,0 +1,56 @@
+/**
+ * Props del componente RecoverPasswordView
+ *
+ * @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 RecoverPasswordViewProps {
+  /**
+   * Función que se ejecuta al enviar el formulario
+   * @param email - Email ingresado por el usuario
+   */
+  onSubmit?: (email: string) => void;
+
+  /**
+   * Función que se ejecuta al hacer clic en "Iniciar Sesión"
+   */
+  onBackToLogin?: () => void;
+
+  /**
+   * Si el formulario está en estado de carga
+   * @default false
+   */
+  isLoading?: boolean;
+
+  /**
+   * Mensaje de error general a mostrar
+   */
+  errorMessage?: string;
+
+  /**
+   * Mensaje de éxito a mostrar (cuando el email fue enviado)
+   */
+  successMessage?: string;
+
+  /**
+   * Clases CSS adicionales para el contenedor principal
+   */
+  className?: string;
+
+  /**
+   * Si se muestra el fondo decorativo (imagen de fondo)
+   * @default true
+   */
+  showBackground?: boolean;
+
+  /**
+   * Variante de visualización
+   * - responsive: Adapta automáticamente según viewport (default)
+   * - mobile: Fuerza visualización móvil (full width, sin card)
+   * - desktop: Fuerza visualización desktop (card centrado)
+   * @default 'responsive'
+   */
+  variant?: 'responsive' | 'mobile' | 'desktop';
+}

package/src/views/RecoverPasswordView/icons.tsx

@@ -0,0 +1,17 @@
+import React from 'react';
+
+/**
+ * Icono de sobre (envelope) para el campo de email
+ * @see https://heroicons.com/
+ */
+export const EnvelopeIcon: React.FC<{ className?: string }> = ({ className = 'w-4 h-4' }) => (
+  <svg
+    xmlns="http://www.w3.org/2000/svg"
+    viewBox="0 0 16 16"
+    fill="currentColor"
+    className={className}
+  >
+    <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>
+);

package/src/views/RecoverPasswordView/index.ts

@@ -0,0 +1,2 @@
+export { RecoverPasswordView } from './RecoverPasswordView';
+export type { RecoverPasswordViewProps } from './RecoverPasswordView.types';

package/src/views/SignUpView/SignUpView.stories.tsx

@@ -0,0 +1,129 @@
+import type { Meta, StoryObj } from '@storybook/react';
+import { SignUpView } from './SignUpView';
+
+const meta = {
+  title: 'Siesa UI Kit/Views/SignUpView',
+  component: SignUpView,
+  parameters: {
+    layout: 'fullscreen',
+    docs: {
+      description: {
+        component: 'Vista completa de registro con formulario para crear una nueva cuenta. Incluye campos de nombre, email y contraseña, botón de registro, enlace para iniciar sesión, y aceptación de términos y condiciones.',
+      },
+    },
+  },
+  tags: ['autodocs'],
+  argTypes: {
+    onSubmit: {
+      action: 'submitted',
+      description: 'Handler para el submit del formulario de registro',
+    },
+    onSignIn: {
+      action: 'signInClicked',
+      description: 'Handler para el click en "Ya tengo una cuenta"',
+    },
+    onTermsClick: {
+      action: 'termsClicked',
+      description: 'Handler para el click en "Condiciones de Uso"',
+    },
+    onPrivacyClick: {
+      action: 'privacyClicked',
+      description: 'Handler para el click en "Políticas de Privacidad"',
+    },
+    isLoading: {
+      control: 'boolean',
+      description: 'Estado de carga del botón de submit',
+    },
+    errorMessage: {
+      control: 'text',
+      description: 'Mensaje de error general para mostrar en el formulario',
+    },
+    showBackground: {
+      control: 'boolean',
+      description: 'Si se muestra el fondo decorativo con imagen',
+    },
+    variant: {
+      control: 'select',
+      options: ['responsive', 'mobile', 'desktop'],
+      description: 'Variante de visualización',
+    },
+  },
+} satisfies Meta<typeof SignUpView>;
+
+export default meta;
+type Story = StoryObj<typeof meta>;
+
+// ============================================
+// 1. DESKTOP (DEFAULT)
+// ============================================
+export const Desktop: Story = {
+  render: () => (
+    <div className="min-h-screen w-full">
+      <SignUpView
+        onSubmit={(name, email, password) => {
+          console.log('Sign up:', { name, email, password });
+        }}
+        onSignIn={() => console.log('Go to sign in')}
+        onTermsClick={() => console.log('View terms')}
+        onPrivacyClick={() => console.log('View privacy')}
+      />
+    </div>
+  ),
+};
+
+// ============================================
+// 2. LOADING STATE
+// ============================================
+export const Loading: Story = {
+  render: () => (
+    <div className="min-h-screen w-full">
+      <SignUpView
+        isLoading={true}
+        onSubmit={(name, email, password) => {
+          console.log('Sign up:', { name, email, password });
+        }}
+        onSignIn={() => console.log('Go to sign in')}
+        onTermsClick={() => console.log('View terms')}
+        onPrivacyClick={() => console.log('View privacy')}
+      />
+    </div>
+  ),
+};
+
+// ============================================
+// 3. WITH ERROR
+// ============================================
+export const WithError: Story = {
+  render: () => (
+    <div className="min-h-screen w-full">
+      <SignUpView
+        errorMessage="El email ya está registrado. Por favor usa otro email o inicia sesión."
+        onSubmit={(name, email, password) => {
+          console.log('Sign up:', { name, email, password });
+        }}
+        onSignIn={() => console.log('Go to sign in')}
+        onTermsClick={() => console.log('View terms')}
+        onPrivacyClick={() => console.log('View privacy')}
+      />
+    </div>
+  ),
+};
+
+// ============================================
+// 4. WITHOUT BACKGROUND
+// ============================================
+export const WithoutBackground: Story = {
+  render: () => (
+    <div className="min-h-screen w-full bg-gray-100 dark:bg-gray-900">
+      <SignUpView
+        showBackground={false}
+        onSubmit={(name, email, password) => {
+          console.log('Sign up:', { name, email, password });
+        }}
+        onSignIn={() => console.log('Go to sign in')}
+        onTermsClick={() => console.log('View terms')}
+        onPrivacyClick={() => console.log('View privacy')}
+      />
+    </div>
+  ),
+};