bord-frontend-utils

Utilidades y hooks de React para proyectos frontend de Bord.

Instalación

npm install bord-frontend-utils

Uso

import { removeAccents, useDebounce } from "bord-frontend-utils";

API

removeAccents(str)

Elimina los acentos de una cadena de texto.

| Parámetro | Tipo | Descripción | | --------- | -------- | ---------------------------- | | str | string | Texto con posibles acentos |

Retorna: string — el texto sin acentos.

removeAccents("ángel García"); // → "angel Garcia"
removeAccents("niño");         // → "nino"

useDebounce<T>(value, delay)

Hook de React que retrasa la actualización de un valor hasta que haya pasado el tiempo indicado sin cambios. Útil para inputs de búsqueda.

| Parámetro | Tipo | Descripción | | --------- | -------- | ------------------------------------ | | value | T | Valor a debouncear | | delay | number | Tiempo de espera en milisegundos |

Retorna: T — el valor debounceado.

const [search, setSearch] = useState("");
const debouncedSearch = useDebounce(search, 300);

useEffect(() => {
  // Solo se ejecuta 300ms después del último cambio
  fetchResults(debouncedSearch);
}, [debouncedSearch]);

Desarrollo

npm run build   # genera el bundle en dist/
npm run dev     # modo watch
npm run lint    # corre ESLint

Pre-commit

Este proyecto usa Husky y lint-staged para correr ESLint automáticamente sobre los archivos .ts y .tsx staged antes de cada commit.

Si el linting falla, el commit se cancela hasta corregir los errores.

Los mensajes de commit deben seguir el formato Conventional Commits:

type: descripción corta

| Tipo | Cuándo usarlo | Ejemplo | |------|--------------|---------| | feat | Nueva funcionalidad | feat: add search filter | | fix | Corrección de bug | fix: resolve null pointer on login | | refactor | Cambio de código sin nueva funcionalidad ni bug | refactor: simplify date formatting | | chore | Tareas de mantenimiento, dependencias, config | chore: update eslint to v9 | | docs | Cambios en documentación | docs: add pre-commit setup to readme | | style | Formato, espacios, comas — sin cambio de lógica | style: fix indentation in utils | | test | Agregar o modificar tests | test: add unit tests for removeAccents | | build | Cambios en el sistema de build | build: update tsup config | | ci | Cambios en pipelines de CI/CD | ci: add lint step to github actions |

Licencia

MIT