Utils es un paquete npm que reúne más de 50 utilidades Javascript tipadas y hechas a mano, diseñadas para potenciar tus proyectos. 🚀
También he desarrollado una página de documentación con todos los detalles y ejemplos de las utilidades para que puedas integrarlas fácilmente en tu proyecto.
📦 Instalación
Instala la librería via npm o pnpm:
npm install @polgubau/utils
# o
pnpm add @polgubau/utilsQué es y por qué existe
Durante los últimos años, TypeScript se ha convertido casi en mi segunda lengua materna después del español. Me fui dando cuenta de con qué frecuencia reescribía las mismas utilidades —“debounce”, “throttle” o “copiar al portapapeles”— en distintos proyectos. En lugar de reinventar la rueda cada vez, decidí construir una pequeña librería con las utilidades que más uso en mi trabajo diario.
@polgubau/utils es una librería de utilidades ligera diseñada para simplificar tareas comunes de JavaScript y TypeScript. Es modular, agnóstica al framework, tree-shakable y optimizada para el rendimiento.
Lo que NO es ⚠️
- Una librería que resuelve todos los problemas.
- Un reemplazo de Lodash o Underscore.
- Un paquete que inflará innecesariamente el tamaño de tu bundle.
Lo que SÍ es ✅
- Una colección de funciones de utilidad pequeñas y enfocadas.
- Modular, tree-shakable y ligera tanto para CJS como ESM.
- Diseñada para ser simple, eficiente y fácil de usar.
- Completamente tipada, con definiciones TypeScript incluidas.
Instalación
Instala la librería usando el gestor de paquetes de tu elección:
pnpm add @polgubau/utilsUso
Importa las utilidades que necesites del paquete:
import { copyToClipboard } from "@polgubau/utils";Para una optimización aún mayor, puedes importar módulos o funciones específicos según sea necesario:
import { copyToClipboard } from "@polgubau/utils/functions";
import { shuffle } from "@polgubau/utils/arrays";Módulos disponibles
- Storage: Utilidades para trabajar con localStorage y sessionStorage.
- Accessibility: Helpers para mejorar la accesibilidad web.
- Arrays: Funciones para manipular arrays de forma eficiente.
- Comparators: Funciones de utilidad para ordenar y comparar datos.
- Functions: Funciones de orden superior y métodos de utilidad.
- Numbers: Utilidades matemáticas y relacionadas con números.
- Objects: Helpers para manipular y transformar objetos.
- Parsers: Funciones para analizar diferentes tipos de datos como JSON.
- Texts: Utilidades para el procesamiento de cadenas y texto.
Ejemplo
Usando el módulo de arrays:
import { limitArray } from "@polgubau/utils/arrays";
const { limitedArray } = limitArray([1, 2, 3, 4, 5]);
console.log(limitedArray); // [1, 2]Soporte para TypeScript
Como siempre debería ser, esta librería incluye soporte completo para TypeScript con definiciones de tipos incluidas.
🛠 Desarrollo
Compilar el proyecto
La forma más sencilla de trabajar con el monorepo del proyecto es ejecutar
pnpm deven el directorio raíz. Esto iniciará un build en modo watch para el paquete y un servidor local para previsualizar la página de documentación.
📜 Licencia
Este proyecto está licenciado bajo la licencia MIT.
💡 Más información
Badges
Enlaces
