Utils: llibreria d'utilitats TS tree-shakeable

@polgubau/utils és un paquet d’npm que recull més de 50 utilitats de JavaScript fetes a mà i amb tipat, creades per millorar els teus projectes. 🚀

També he programat una pàgina de documentació amb tots els detalls i exemples de les utilitats perquè les puguis integrar fàcilment al teu projecte.

📦 Instal·lació

Instal·la la llibreria mitjançant npm o pnpm:

npm install @polgubau/utils
# or
pnpm add @polgubau/utils

Què i per què

Durant els darrers anys, TypeScript s’ha convertit gairebé en la meva segona llengua materna després del castellà. Em vaig adonar de quantes vegades reescrivia les mateixes utilitats com “debounce”, “throttle” o “copy to clipboard” en diferents projectes. En lloc de reinventar la roda cada vegada, vaig decidir construir una petita llibreria amb les utilitats que més utilitzo en el meu dia a dia.

@polgubau/utils és una llibreria d’utilitats lleugera dissenyada per simplificar les tasques comunes de JavaScript i TypeScript. És modular, independent del framework, tree-shakable i optimitzada per al rendiment.

Què NO és ⚠️

Una llibreria per a tot que resol tots els problemes.
Un substitut de Lodash o Underscore.
Un paquet que inflarà innecessàriament la mida del teu bundle.

Què ÉS ✅

Una col·lecció de funcions d’utilitat petites i enfocades.
Modular, tree-shakable i lleugera tant per a CJS com per a ESM.
Dissenyada per ser senzilla, eficient i fàcil d’utilitzar.
Totalment tipada, amb definicions de TypeScript incloses.

Instal·lació

Instal·la la llibreria utilitzant el teu gestor de paquets preferit:

pnpm add @polgubau/utils

Ús

Importa les utilitats que necessitis del paquet:

import { copyToClipboard } from "@polgubau/utils";

Per a una optimització encara millor, pots importar mòduls o funcions específiques segons sigui necessari:

import { copyToClipboard } from "@polgubau/utils/functions";
import { shuffle } from "@polgubau/utils/arrays";

Mòduls disponibles

Storage: Utilitats per treballar amb localStorage i sessionStorage.
Accessibility: Ajudes per millorar l’accessibilitat web.
Arrays: Funcions per manipular arrays de manera eficient.
Comparators: Funcions d’utilitat per ordenar i comparar dades.
Functions: Funcions d’ordre superior i mètodes d’utilitat.
Numbers: Utilitats matemàtiques i relacionades amb números.
Objects: Ajudes per a la manipulació i transformació d’objectes.
Parsers: Funcions per analitzar diferents tipus de dades com JSON.
Texts: Utilitats de processament de cadenes i text.

Exemple

Utilitzant el mòdul d’arrays:

import { limitArray } from "@polgubau/utils/arrays";
const { limitedArray } = limitArray([1, 2, 3, 4, 5]);
console.log(limitedArray); // [1, 2]

Suport de TypeScript

Com hauria de ser sempre, aquesta llibreria inclou suport complet de TypeScript amb definicions de tipus incloses.

🛠 Desenvolupament

Construcció del projecte

La manera més fàcil de treballar amb el monorepo del projecte és executar

pnpm dev

al directori arrel. Això iniciarà una compilació en mode watch per al paquet i iniciarà un servidor local per previsualitzar la pàgina de documentació.