CoreKit UI

CoreKit UI es una biblioteca de componentes de alto rendimiento desarrollada por PC Soluciones, optimizada para aplicaciones críticas en los sectores de salud ocupacional y epidemiología.

Características Principales

Interfaz y Experiencia de Usuario

• Arquitectura de Micro-Frontends: Diseñada para ser integrada en ecosistemas complejos con cero conflictos de estilos mediante CSS Modules.
• Componentes de Formulario Avanzados: Incluye controles especializados como InputNumeric con validación en tiempo real e InputDate optimizado.
• Firma Digital Integrada: Componente de firma manual nativo para flujos de trabajo legales y clínicos.
• Gestión de Datos Escalable: Tablas de datos de alto rendimiento con soporte para virtualización y filtrado complejo.

Accesibilidad y Tecnología

• Reconocimiento de Voz Nativo: Integración profunda con APIs de voz para permitir la entrada de datos manos libres y comandos auditivos.
• Cumplimiento WCAG 2.1: Todos los componentes se desarrollan siguiendo estrictos estándares de accesibilidad (A11y).
• Tipado Estricto: Escrito íntegramente en TypeScript para garantizar la robustez del código y facilitar la integración del desarrollador.

Arquitectura de UI

• Gestión de Modales en Stack: Sistema avanzado para manejar múltiples diálogos superpuestos de forma ordenada.
• Paneles de Filtros Dinámicos: Interfaz modular para la búsqueda y segmentación de datos en tiempo real.
• Diseño Responsivo: Adaptabilidad total a diferentes resoluciones y dispositivos.

Instalación

pnpm add corekit-ui
# o
npm install corekit-ui

Configuración de Estilos

Importe la hoja de estilos global en el punto de entrada de su aplicación:

import 'corekit-ui/styles.css';

Guía de Desarrollo

Desarrollo Local sin Publicar

Para probar cambios en corekit-ui en tu proyecto consumidor sin tener que publicar a NPM cada vez, puedes usar el File Protocol, que es la forma estándar y recomendada por la industria.

Paso 1: Instala la versión local en tu proyecto consumidor

En el directorio raíz de tu aplicación consumidora, ejecuta:

# Si usas npm
npm install d:\Repositorios\corekit-ui

# Si usas pnpm
pnpm add file:d:\Repositorios\corekit-ui

Esto actualiza tu package.json de la aplicación consumidora para que apunte a la ruta local:

"dependencies": {
  "corekit-ui": "file:D:/Repositorios/corekit-ui"
}

Paso 2: Genera los cambios en la librería

Cada vez que hagas cambios en corekit-ui y quieras verlos en tu app consumidora:

# En la terminal de corekit-ui
pnpm run build

Paso 3: Reinicia tu servidor con --force

En la terminal de tu aplicación consumidora, detén el servidor actual y reinicia:

# Presiona Ctrl+C para detener el servidor actual
pnpm dev --force

El flag --force limpia la caché de Vite y fuerza a que recargue todos los módulos desde cero, incluyendo la versión local de corekit-ui.

Volver a la versión de NPM

Cuando termines el desarrollo local y quieras usar la versión publicada:

# En tu aplicación consumidora
npm uninstall corekit-ui
npm install corekit-ui@latest

Scripts Disponibles

• pnpm dev: Inicia el servidor de desarrollo Vite.
• pnpm storybook: Ejecuta la documentación interactiva y el entorno de pruebas visuales.
• pnpm check: Realiza una validación completa (Typecheck, Linting y Tests).
• pnpm build: Genera el paquete de distribución optimizado.

Estándares de Código

El proyecto utiliza un stack de herramientas de calidad riguroso:

• ESLint y Prettier para la consistencia del código.
• Vitest para pruebas unitarias y de integración.
• Stylelint para garantizar la calidad del CSS.

Licencia

Este proyecto está bajo la Licencia MIT. Para más detalles, consulte el archivo LICENSE.

Desarrollado y mantenido por Soluciones PC.