bord-frontend-utils 0.0.1

package/README.md

@@ -0,0 +1,70 @@
+# bord-frontend-utils
+
+Utilidades y hooks de React para proyectos frontend de Bord.
+
+## Instalación
+
+```bash
+npm install bord-frontend-utils
+```
+
+## Uso
+
+```ts
+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.
+
+```ts
+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.
+
+```tsx
+const [search, setSearch] = useState("");
+const debouncedSearch = useDebounce(search, 300);
+
+useEffect(() => {
+  // Solo se ejecuta 300ms después del último cambio
+  fetchResults(debouncedSearch);
+}, [debouncedSearch]);
+```
+
+---
+
+## Desarrollo
+
+```bash
+npm run build   # genera el bundle en dist/
+npm run dev     # modo watch
+```
+
+## Licencia
+
+MIT

package/dist/index.d.mts

@@ -0,0 +1,11 @@
+/**
+ * Elimina los acentos de una cadena de texto
+ * Usa normalize NFD para descomponer los caracteres y luego elimina los diacríticos
+ * @param {string} str - Cadena de texto con posibles acentos
+ * @returns {string} Cadena de texto sin acentos
+ */
+declare const removeAccents: (str: string) => string;
+
+declare const useDebounce: <T>(value: T, delay: number) => T;
+
+export { removeAccents, useDebounce };

package/dist/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Elimina los acentos de una cadena de texto
+ * Usa normalize NFD para descomponer los caracteres y luego elimina los diacríticos
+ * @param {string} str - Cadena de texto con posibles acentos
+ * @returns {string} Cadena de texto sin acentos
+ */
+declare const removeAccents: (str: string) => string;
+
+declare const useDebounce: <T>(value: T, delay: number) => T;
+
+export { removeAccents, useDebounce };

package/dist/index.js

@@ -0,0 +1,53 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  removeAccents: () => removeAccents,
+  useDebounce: () => useDebounce
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/utils/removeAccents.ts
+var removeAccents = (str) => {
+  if (!str) return str;
+  return str.normalize("NFD").replace(/[\u0300-\u036f]/g, "");
+};
+
+// src/hooks/useDebounce.ts
+var import_react = require("react");
+var useDebounce = (value, delay) => {
+  const [debouncedValue, setDebouncedValue] = (0, import_react.useState)(value);
+  (0, import_react.useEffect)(() => {
+    const handler = setTimeout(() => {
+      setDebouncedValue(value);
+    }, delay);
+    return () => {
+      clearTimeout(handler);
+    };
+  }, [value, delay]);
+  return debouncedValue;
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  removeAccents,
+  useDebounce
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/utils/removeAccents.ts","../src/hooks/useDebounce.ts"],"sourcesContent":["export { removeAccents } from \"./utils/removeAccents\";\nexport { useDebounce } from \"./hooks/useDebounce\";\n","/**\n * Elimina los acentos de una cadena de texto\n * Usa normalize NFD para descomponer los caracteres y luego elimina los diacríticos\n * @param {string} str - Cadena de texto con posibles acentos\n * @returns {string} Cadena de texto sin acentos\n */\nexport const removeAccents = (str: string): string => {\n  if (!str) return str;\n  return str.normalize(\"NFD\").replace(/[\\u0300-\\u036f]/g, \"\");\n};\n","import { useState, useEffect } from \"react\";\n\nexport const useDebounce = <T>(value: T, delay: number): T => {\n  const [debouncedValue, setDebouncedValue] = useState<T>(value);\n\n  useEffect(() => {\n    const handler = setTimeout(() => {\n      setDebouncedValue(value);\n    }, delay);\n    return () => {\n      clearTimeout(handler);\n    };\n  }, [value, delay]);\n\n  return debouncedValue;\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACMO,IAAM,gBAAgB,CAAC,QAAwB;AACpD,MAAI,CAAC,IAAK,QAAO;AACjB,SAAO,IAAI,UAAU,KAAK,EAAE,QAAQ,oBAAoB,EAAE;AAC5D;;;ACTA,mBAAoC;AAE7B,IAAM,cAAc,CAAI,OAAU,UAAqB;AAC5D,QAAM,CAAC,gBAAgB,iBAAiB,QAAI,uBAAY,KAAK;AAE7D,8BAAU,MAAM;AACd,UAAM,UAAU,WAAW,MAAM;AAC/B,wBAAkB,KAAK;AAAA,IACzB,GAAG,KAAK;AACR,WAAO,MAAM;AACX,mBAAa,OAAO;AAAA,IACtB;AAAA,EACF,GAAG,CAAC,OAAO,KAAK,CAAC;AAEjB,SAAO;AACT;","names":[]}

package/dist/index.mjs

@@ -0,0 +1,25 @@
+// src/utils/removeAccents.ts
+var removeAccents = (str) => {
+  if (!str) return str;
+  return str.normalize("NFD").replace(/[\u0300-\u036f]/g, "");
+};
+
+// src/hooks/useDebounce.ts
+import { useState, useEffect } from "react";
+var useDebounce = (value, delay) => {
+  const [debouncedValue, setDebouncedValue] = useState(value);
+  useEffect(() => {
+    const handler = setTimeout(() => {
+      setDebouncedValue(value);
+    }, delay);
+    return () => {
+      clearTimeout(handler);
+    };
+  }, [value, delay]);
+  return debouncedValue;
+};
+export {
+  removeAccents,
+  useDebounce
+};
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/utils/removeAccents.ts","../src/hooks/useDebounce.ts"],"sourcesContent":["/**\n * Elimina los acentos de una cadena de texto\n * Usa normalize NFD para descomponer los caracteres y luego elimina los diacríticos\n * @param {string} str - Cadena de texto con posibles acentos\n * @returns {string} Cadena de texto sin acentos\n */\nexport const removeAccents = (str: string): string => {\n  if (!str) return str;\n  return str.normalize(\"NFD\").replace(/[\\u0300-\\u036f]/g, \"\");\n};\n","import { useState, useEffect } from \"react\";\n\nexport const useDebounce = <T>(value: T, delay: number): T => {\n  const [debouncedValue, setDebouncedValue] = useState<T>(value);\n\n  useEffect(() => {\n    const handler = setTimeout(() => {\n      setDebouncedValue(value);\n    }, delay);\n    return () => {\n      clearTimeout(handler);\n    };\n  }, [value, delay]);\n\n  return debouncedValue;\n};\n"],"mappings":";AAMO,IAAM,gBAAgB,CAAC,QAAwB;AACpD,MAAI,CAAC,IAAK,QAAO;AACjB,SAAO,IAAI,UAAU,KAAK,EAAE,QAAQ,oBAAoB,EAAE;AAC5D;;;ACTA,SAAS,UAAU,iBAAiB;AAE7B,IAAM,cAAc,CAAI,OAAU,UAAqB;AAC5D,QAAM,CAAC,gBAAgB,iBAAiB,IAAI,SAAY,KAAK;AAE7D,YAAU,MAAM;AACd,UAAM,UAAU,WAAW,MAAM;AAC/B,wBAAkB,KAAK;AAAA,IACzB,GAAG,KAAK;AACR,WAAO,MAAM;AACX,mBAAa,OAAO;AAAA,IACtB;AAAA,EACF,GAAG,CAAC,OAAO,KAAK,CAAC;AAEjB,SAAO;AACT;","names":[]}

package/package.json

@@ -0,0 +1,36 @@
+{
+  "name": "bord-frontend-utils",
+  "version": "0.0.1",
+  "description": "Bord frontend utilities: reusable React hooks and helper functions for building scalable web applications.",
+  "main": "dist/index.js",
+  "module": "dist/index.mjs",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "sideEffects": false,
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch"
+  },
+  "keywords": [
+    "react",
+    "hooks",
+    "utils",
+    "frontend",
+    "typescript"
+  ],
+  "author": "Bord",
+  "license": "MIT",
+  "engines": {
+    "node": ">=18"
+  },
+  "peerDependencies": {
+    "react": ">=18"
+  },
+  "devDependencies": {
+    "@types/react": "^19.2.14",
+    "tsup": "^8.5.1",
+    "typescript": "^6.0.3"
+  }
+}