@carto/ps-utils 1.7.1 → 2.0.0-canary.0

package/LICENSE.md

@@ -0,0 +1,29 @@
+BSD 3-Clause License
+
+Copyright (c) 2023, CARTO
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+
+1. Redistributions of source code must retain the above copyright notice, this
+   list of conditions and the following disclaimer.
+
+2. Redistributions in binary form must reproduce the above copyright notice,
+   this list of conditions and the following disclaimer in the documentation
+   and/or other materials provided with the distribution.
+
+3. Neither the name of the copyright holder nor the names of its
+   contributors may be used to endorse or promote products derived from
+   this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
+FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
+CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

package/README.md

@@ -1,21 +1,24 @@
-# CARTO PS Library - Utils
+# The CARTO PS Utils Library
 
-This repository contains the packages with utils helpers.
+<a aria-label="NPM version" href="https://www.npmjs.com/package/@carto/ps-utils">
+  <img alt="" src="https://img.shields.io/npm/v/@carto/ps-utils.svg?style=flat-square&labelColor=000000">
+</a>
+<a aria-label="License" href="https://github.com/CartoDB/carto-ps-lib/blob/canary/LICENSE.md">
+  <img alt="" src="https://img.shields.io/npm/l/@carto/ps-utils.svg?style=flat-square&labelColor=000000">
+</a>
+<a aria-label="CI status" href="https://github.com/carto/ps-helpers/actions/workflows/pull-request.yml?query=event%3Apush+branch%3Amain">
+  <img alt="" src="https://img.shields.io/github/actions/workflow/status/carto/ps-helpers/pull-request.yml?event=push&branch=main&style=flat-square&labelColor=000000">
+</a>
 
-## Installation
+## Introduction
 
-Install @carto/ps-utils like dependence:
+This package includes utility functions for JavaScript and TypeScript.
 
-```bash
-  npm install --save @carto/ps-utils
-```
+The following helpers are available:
 
-## Usage
-
-The see what helpers are available, the functions and examples, see [docs](https://github.com/CartoDB/carto-ps-lib/blob/main/docs/modules/carto_ps_utils.md) section.
+_To_develop_
 
 ## Contributing
 
-See [the contributing guide](https://github.com/CartoDB/carto-ps-lib/blob/main/CONTRIBUTING.md) for detailed instructions on how to get started with our project.
-
-If you're looking for a way to contribute, you can scan through our [existing issues](https://github.com/github/docs/issues) for something to work on. When ready, check out [Getting Started with Contributing](https://github.com/CartoDB/carto-ps-lib/blob/main/CONTRIBUTING.md) for detailed instructions.
+Please read our [contributing](https://github.com/carto/carto-ps-lib/blob/main/CONTRIBUTING.md)
+guide before creating a pull request.

package/dist/index.js

@@ -1,5 +1,11 @@
-import { geomReduce as b } from "@turf/meta";
-function A(t, n = 1) {
+async function l(t) {
+  try {
+    await navigator.clipboard.writeText(t);
+  } catch (n) {
+    throw new Error(n);
+  }
+}
+function p(t, n = 1) {
   if (!t) {
     console.warn(`hexToRgba: ${t} invalid hexadecimal format`);
     return;
@@ -8,117 +14,42 @@ function A(t, n = 1) {
     console.warn(`hexToRgba: ${n} invalid alpha format`);
     return;
   }
-  if (t?.includes("#") && (t = t.slice(1)), !/[0-9A-Fa-f]{6}/g.test(t) && !/[0-9A-Fa-f]{3}/g.test(t) && !/[0-9A-Fa-f]{2}/g.test(t)) {
+  if (t != null && t.includes("#") && (t = t.slice(1)), !/[0-9A-Fa-f]{6}/g.test(t) && !/[0-9A-Fa-f]{3}/g.test(t) && !/[0-9A-Fa-f]{2}/g.test(t)) {
     console.warn(`hexToRgba: ${t} invalid hexadecimal format`);
     return;
   }
-  const e = t.length;
-  e < 6 && (t = t.slice(0, 6 - e).repeat(6 / e));
-  const o = parseInt(
+  const r = t.length;
+  r < 6 && (t = t.slice(0, 6 - r).repeat(6 / r));
+  const e = parseInt(
     t.length === 3 ? t.slice(0, 1).repeat(2) : t.slice(0, 2),
     16
-  ), r = parseInt(
+  ), o = parseInt(
     t.length === 3 ? t.slice(1, 2).repeat(2) : t.slice(2, 4),
     16
   ), i = parseInt(
     t.length === 3 ? t.slice(2, 3).repeat(2) : t.slice(4, 6),
     16
   );
-  return [o, r, i, n * 255];
+  return [e, o, i, n * 255];
 }
-function E(t, { withPrefix: n = !0 } = {}) {
-  if (!t || !t.length) {
-    console.warn("rgbaDeckGLToHex: invalid array or empty values");
+function y(t, { withPrefix: n = !0 } = {}) {
+  if (!(t != null && t.length)) {
+    console.warn("rgbaToHex: invalid array or empty values");
     return;
   }
-  if (t.some((r) => r < 0 || r > 255)) {
-    console.warn(
-      `rgbaDeckGLToHex: [${t.toString()}] invalid array value format`
-    );
+  if (t.some((o) => o < 0 || o > 255)) {
+    console.warn(`rgbaToHex: [${t.toString()}] invalid array value format`);
     return;
   }
-  const o = t.map((r) => r.toString(16).padStart(2, "0")).join("");
-  return `${n ? "#" : ""}${o}`;
+  const e = t.map((o) => o.toString(16).padStart(2, "0")).join("");
+  return `${n ? "#" : ""}${e}`;
 }
-function C(t, n) {
-  return (...r) => {
-    clearTimeout(0), setTimeout(() => t(...r), n);
+function T(t, n) {
+  return (...o) => {
+    clearTimeout(0), setTimeout(() => t(...o), n);
   };
 }
-const g = 63710088e-1;
-function I(t) {
-  return b(
-    t,
-    function(n, e) {
-      return n + R(e);
-    },
-    0
-  );
-}
-function R(t) {
-  let n = 0, e;
-  switch (t.type) {
-    case "Polygon":
-      return p(t.coordinates);
-    case "MultiPolygon":
-      for (e = 0; e < t.coordinates.length; e++)
-        n += p(t.coordinates[e]);
-      return n;
-    case "Point":
-    case "MultiPoint":
-    case "LineString":
-    case "MultiLineString":
-      return 0;
-  }
-  return 0;
-}
-function p(t) {
-  let n = 0;
-  if (t && t.length > 0) {
-    n += Math.abs(m(t[0]));
-    for (let e = 1; e < t.length; e++)
-      n -= Math.abs(m(t[e]));
-  }
-  return n;
-}
-function m(t) {
-  let n, e, o, r, i, a, c, u = 0;
-  const s = t.length;
-  if (s > 2) {
-    for (c = 0; c < s; c++)
-      c === s - 2 ? (r = s - 2, i = s - 1, a = 0) : c === s - 1 ? (r = s - 1, i = 0, a = 1) : (r = c, i = c + 1, a = c + 2), n = t[r], e = t[i], o = t[a], u += (l(o[0]) - l(n[0])) * Math.sin(l(e[1]));
-    u = u * g * g / 2;
-  }
-  return u;
-}
-function l(t) {
-  return t * Math.PI / 180;
-}
-function v(t) {
-  try {
-    if (navigator.clipboard)
-      navigator.clipboard.writeText(t);
-    else {
-      const n = document.createElement("input");
-      n.innerHTML = t, T(n);
-    }
-  } catch (n) {
-    throw new Error(n);
-  }
-}
-function T(t) {
-  const n = t.contentEditable, e = t.readOnly;
-  try {
-    t.contentEditable = "true", t.readOnly = !1, D(t);
-  } finally {
-    t.contentEditable = n, t.readOnly = e;
-  }
-}
-function D(t) {
-  const n = document.createRange(), e = window.getSelection();
-  n.selectNodeContents(t), e?.removeAllRanges(), e?.addRange(n), t.setSelectionRange(0, 999999), document.execCommand("copy");
-}
-const y = {
+const f = {
   NUMBER: {
     style: "decimal",
     maximumFractionDigits: 1,
@@ -140,60 +71,61 @@ const y = {
     day: "2-digit"
   }
 };
-function F(t, n, e) {
-  return Intl.DateTimeFormat(n, e).format(t);
-}
-function d(t, n, e) {
-  return Intl.NumberFormat(n, e).format(t);
-}
-function M(t, n, e = {}) {
-  return d(t, n, { ...y.NUMBER, ...e });
-}
-function N(t, n, e = {}) {
-  return d(t, n, { ...y.CURRENCY, ...e });
-}
-const w = /:+[a-z]+/gi;
-function S(t, n = []) {
-  let e = t;
-  const o = e.match(w) || [], r = Array.isArray(n);
-  return o.forEach((i, a) => {
-    let c;
-    if (r)
-      c = n[a];
+function R(t, n, r) {
+  return Intl.DateTimeFormat(n, r).format(t);
+}
+function a(t, n, r) {
+  return Intl.NumberFormat(n, r).format(t);
+}
+function w(t, n, r = {}) {
+  return a(t, n, {
+    ...f.NUMBER,
+    ...r
+  });
+}
+function D(t, n, r = {}) {
+  return a(t, n, {
+    ...f.CURRENCY,
+    ...r
+  });
+}
+function u(t, { format: n = "NFD", replaceUnicode: r = "[̀-ͯ]" } = {}) {
+  const e = new RegExp(r, "g");
+  return t.normalize(n).replace(e, "");
+}
+function F(t, n, { matchFn: r, normalizeOptions: e } = {}) {
+  let o = t;
+  return typeof t == "string" && (o = new RegExp(u(t.toLowerCase(), e), "gi")), Array.isArray(n) ? n.filter((i) => {
+    const c = r ? r(i) : i;
+    return u(c).match(o);
+  }) : u(n).match(o) ? n : null;
+}
+const m = /:+[a-z]+/gi;
+function A(t, n = []) {
+  let r = t;
+  const e = r.match(m) ?? [], o = Array.isArray(n);
+  return e.forEach((i, c) => {
+    let s;
+    if (o)
+      s = n[c];
     else {
-      const u = i.substring(1);
-      c = n[u];
+      const g = i.substring(1);
+      s = n[g];
     }
-    e = e.replace(i, c?.toString());
-  }), e;
-}
-function f(t, { format: n = "NFD", replaceUnicode: e = "[̀-ͯ]" } = {}) {
-  const o = new RegExp(e, "g");
-  return t.normalize(n).replace(o, "");
-}
-function L(t, n, { matchFn: e, normalizeOptions: o } = {}) {
-  const r = new RegExp(
-    f(t.toLowerCase(), o),
-    "gi"
-  );
-  return Array.isArray(n) ? n.filter((i) => {
-    const a = e ? e(i) : i;
-    return f(a).match(r);
-  }) : f(n).match(r) ? n : null;
+    r = r.replace(i, (s == null ? void 0 : s.toString()) ?? "");
+  }), r;
 }
 export {
-  y as CONFIG,
-  I as area,
-  v as copy,
-  C as debounce,
-  N as formatCurrency,
-  F as formatDate,
-  M as formatNumber,
-  A as hexToRgba,
-  A as hexToRgbaDeckGL,
-  L as matchText,
-  f as normalize,
-  S as replaceRoute,
-  E as rgbaDeckGLToHex,
-  E as rgbaToHex
+  f as DEFAULT_FORMATTERS_CONFIG,
+  l as copy,
+  T as debounce,
+  D as formatCurrency,
+  R as formatDate,
+  w as formatNumber,
+  p as hexToRgba,
+  F as matchText,
+  u as normalize,
+  A as replaceRoute,
+  y as rgbaToHex
 };
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sources":["../src/clipboard/copy.ts","../src/colors/hex-to-rgba/hex-to-rgba.ts","../src/colors/rgba-to-hex/rgba-to-hex.ts","../src/debounce/debounce.ts","../src/formatters/constants.ts","../src/formatters/date/format-date.ts","../src/formatters/number/format-number.ts","../src/strings/normalize/normalize.ts","../src/strings/match-text/match-text.ts","../src/strings/routes/replace-route.ts"],"sourcesContent":["/**\n * This function is a helper function to copy text to the clipboard.\n *\n * @param {string} text - The text to copy to the clipboard.\n *\n * @returns {void}\n *\n *\n * @example\n * ```ts\n * copy('Hello world!')\n * ```\n */\nexport async function copy(text: string): Promise<void> {\n  try {\n    await navigator.clipboard.writeText(text)\n  } catch (e: unknown) {\n    throw new Error(e as string) // copy failed.\n  }\n}\n","/**\n * It converts a hexadecimal color to an array of numbers\n *\n * @param {string} hexadecimal - hexadecimal string, including # or not\n * @param {number} alpha - opacity of final color, value must be between 0-1\n *\n * @returns An array of numbers.\n *\n * @example\n *\n * 6 digits hexadecimal:\n * ```ts\n * hexToRgba('#d1d1d1', 1)\n * ```\n * 3 digits hexadecimal:\n * ```ts\n * hexToRgba('#d1d', 1)\n * ```\n * 2 digits hexadecimal:\n * ```ts\n * hexToRgba('#d1', 1)\n * ```\n */\nexport function hexToRgba(\n  hexadecimal: string,\n  alpha = 1,\n): [number, number, number, number] | undefined {\n  if (!hexadecimal) {\n    // eslint-disable-next-line no-console\n    console.warn(`hexToRgba: ${hexadecimal} invalid hexadecimal format`)\n    return\n  }\n  if (alpha < 0 || alpha > 1) {\n    // eslint-disable-next-line no-console\n    console.warn(`hexToRgba: ${alpha} invalid alpha format`)\n    return\n  }\n  if (hexadecimal?.includes('#')) {\n    hexadecimal = hexadecimal.slice(1)\n  }\n  if (\n    !/[0-9A-Fa-f]{6}/g.test(hexadecimal) &&\n    !/[0-9A-Fa-f]{3}/g.test(hexadecimal) &&\n    !/[0-9A-Fa-f]{2}/g.test(hexadecimal)\n  ) {\n    // eslint-disable-next-line no-console\n    console.warn(`hexToRgba: ${hexadecimal} invalid hexadecimal format`)\n    return\n  }\n\n  const length = hexadecimal.length\n\n  if (length < 6) {\n    hexadecimal = hexadecimal.slice(0, 6 - length).repeat(6 / length)\n  }\n\n  const r = parseInt(\n    hexadecimal.length === 3\n      ? hexadecimal.slice(0, 1).repeat(2)\n      : hexadecimal.slice(0, 2),\n    16,\n  )\n  const g = parseInt(\n    hexadecimal.length === 3\n      ? hexadecimal.slice(1, 2).repeat(2)\n      : hexadecimal.slice(2, 4),\n    16,\n  )\n  const b = parseInt(\n    hexadecimal.length === 3\n      ? hexadecimal.slice(2, 3).repeat(2)\n      : hexadecimal.slice(4, 6),\n    16,\n  )\n  return [r, g, b, alpha * 255]\n}\n","import type { RgbaToHexOptions } from './types'\n\n/**\n * It converts an array of RGBA values to a hexadecimal string.\n *\n * @param {number[]} rgba - rgba array, including alpha or not\n * @param {RgbaToHexOptions} options - options to parse\n *\n * @returns A string\n *\n * @example\n *\n * Without alpha value:\n * ```ts\n * rgbaDeckGLToHex([0, 0, 0]) // => '#000000'\n * ```\n *\n * With alpha value:\n * ```ts\n * rgbaDeckGLToHex([0, 0, 0, 1]) // => '#000000FF'\n * ```\n *\n * Without prefix:\n * ```ts\n * rgbaDeckGLToHex([0, 0, 0], { withPrefix: false }) // => '000000'\n * ```\n *\n */\nexport function rgbaToHex(\n  rgba: number[] | undefined,\n  { withPrefix = true }: RgbaToHexOptions = {},\n): string | undefined {\n  if (!rgba?.length) {\n    // eslint-disable-next-line no-console\n    console.warn(`rgbaToHex: invalid array or empty values`)\n    return\n  }\n\n  const hasInvalidValue = rgba.some((value) => value < 0 || value > 255)\n  if (hasInvalidValue) {\n    // eslint-disable-next-line no-console\n    console.warn(`rgbaToHex: [${rgba.toString()}] invalid array value format`)\n    return\n  }\n\n  const hexadecimal = rgba\n    .map((value) => {\n      const hex = value.toString(16)\n      return hex.padStart(2, '0')\n    })\n    .join('')\n\n  return `${withPrefix ? '#' : ''}${hexadecimal}`\n}\n","/**\n * Returns a debounced version of the provided function.\n * @param func - The function to debounce.\n * @param {number} waitFor - The number of milliseconds to wait before invoking the debounced function.\n * @returns A debounced version of the provided function.\n */\nexport function debounce<F extends (...args: unknown[]) => unknown>(\n  func: F,\n  waitFor: number,\n): (...args: Parameters<F>) => ReturnType<F> {\n  const timeout = 0\n\n  const debounced = (...args: Parameters<F>) => {\n    clearTimeout(timeout)\n    setTimeout(() => func(...args), waitFor)\n  }\n\n  return debounced as (...args: Parameters<F>) => ReturnType<F>\n}\n","export const DEFAULT_FORMATTERS_CONFIG: Record<\n  string,\n  Intl.NumberFormatOptions | Intl.DateTimeFormatOptions\n> = {\n  NUMBER: {\n    style: 'decimal',\n    maximumFractionDigits: 1,\n    minimumFractionDigits: 0,\n    notation: 'compact',\n    compactDisplay: 'short',\n  },\n\n  CURRENCY: {\n    style: 'currency',\n    currency: 'USD',\n    maximumFractionDigits: 2,\n    minimumFractionDigits: 2,\n    notation: 'compact',\n    compactDisplay: 'short',\n  },\n  DATE: {\n    year: 'numeric',\n    month: '2-digit',\n    day: '2-digit',\n  },\n} as const\n","/**\n * Formats a Date or number to a string based on the given options.\n * This function could be used to format a Date, in Date format or miliseconds, in specific locale and options.\n * @public\n *\n * @export\n * @param {number | Date} value\n * @param {string | string[]} locales\n * @param {Intl.DateTimeFormatOptions} [options]\n * @return {string}\n */\nexport function formatDate(\n  value: number | Date,\n  locales: string | string[],\n  options?: Intl.DateTimeFormatOptions,\n): string {\n  return Intl.DateTimeFormat(locales, options).format(value)\n}\n","import { DEFAULT_FORMATTERS_CONFIG } from '../constants'\n\n/**\n * Formats a number to a string based on the given options.\n * This function could be used to format a number as a percentage, currency or unit in specific locale.\n * @public\n *\n * @example\n *\n * Without specific locale:\n * ```ts\n * format(3001) // => '3,001'\n * ```\n *\n * With specific locale:\n * ```ts\n * format(3001, 'es-ES') // => '3001'\n * ```\n *\n * With specific style:\n * ```ts\n * format(45, 'es-ES', {\n *    style: 'unit',\n *    unit: 'liter',\n *    unitDisplay: 'long',\n *  }) // => '45 litros'\n * ```\n *\n * @export\n * @param {number} value - The number to be formatted.\n * @param {string} [locale] - The locale to be used.\n * @param {Intl.NumberFormatOptions} [options] - The options to be used.\n * @return {string}\n */\nfunction format(\n  value: number,\n  locale: string,\n  options?: Intl.NumberFormatOptions,\n): string {\n  return Intl.NumberFormat(locale, options).format(value)\n}\n\n/**\n * Formats a number to a string.\n * @public\n *\n * @example\n *\n * ```ts\n * formatNumber(3001, 'es-ES') // => '3 mil'\n * ```\n *\n * @export\n * @param {number} value - The number to be formatted.\n * @param {string} locale - The locale to be used.\n * @param {Intl.NumberFormatOptions} [options] - The options to be used.\n * @return {string}\n */\nexport function formatNumber(\n  value: number,\n  locale: string,\n  options: Intl.NumberFormatOptions = {},\n): string {\n  return format(value, locale, {\n    ...DEFAULT_FORMATTERS_CONFIG.NUMBER,\n    ...options,\n  })\n}\n\n/**\n * Formats a number to a currency string.\n * @public\n *\n * @example\n *\n * ```ts\n * formatCurrency(3001, 'en-US') // => '$3.00K'\n * ```\n *\n * @export\n * @param {number} value - The number to be formatted.\n * @param {string} locale - The locale to be used.\n * @param {Intl.NumberFormatOptions} [options] - The options to be used.\n * @return {string}\n */\nexport function formatCurrency(\n  value: number,\n  locale: string,\n  options: Intl.NumberFormatOptions = {},\n): string {\n  return format(value, locale, {\n    ...DEFAULT_FORMATTERS_CONFIG.CURRENCY,\n    ...options,\n  })\n}\n","import type { NormalizeOptions } from './types'\n\n/**\n * It takes a string and returns a string normalized.\n * @param {string} data - The data to be normalized.\n * @param {NormalizeOptions} options  - data - The string to be normalized.\n * @returns A string\n *\n * @remarks\n * The normalization by default is NFD\n *\n * @example\n *\n * ```ts\n * normalize('foo bar')\n * ```\n *\n */\nexport function normalize(\n  data: string,\n  { format = 'NFD', replaceUnicode = '[\\u0300-\\u036f]' }: NormalizeOptions = {},\n): string {\n  const unicode = new RegExp(replaceUnicode, 'g')\n  return data.normalize(format).replace(unicode, '')\n}\n","import type { MatchTextOptions } from './types'\nimport { normalize } from '../normalize/normalize'\n\n/**\n * It takes a string, an array of strings, and an optional object of options, and returns an\n * array of strings that match the input string\n * @param {string | RegExp} text - The text to match against.\n * @param {T[] | string} data - The data to match against.\n * @param {MatchTextOptions} options - The options to use.\n *\n * @returns {T[] | string | null} - The matched data or null.\n *\n */\nexport function matchText<T>(\n  value: string | RegExp,\n  data: T[] | string,\n  { matchFn, normalizeOptions }: MatchTextOptions<T> = {},\n): T[] | string | null {\n  let regex = value\n  if (typeof value === 'string') {\n    regex = new RegExp(normalize(value.toLowerCase(), normalizeOptions), 'gi')\n  }\n\n  if (!Array.isArray(data)) {\n    return normalize(data).match(regex) ? data : null\n  }\n\n  return data.filter((match) => {\n    const newData = (matchFn ? matchFn(match) : match) as string\n    return normalize(newData).match(regex)\n  })\n}\n","import type { Route, Values } from './types'\n\nconst regex = /:+[a-z]+/gi\n\n/**\n * Replace route with values from array or object.\n * @param {Route} data\n * @param {Values} values\n *\n * @returns {Route}\n *\n * @example\n * ```ts\n * replaceRoute('/user/:id', { id: 1 }) // /user/1\n * replaceRoute('/user/:id/:name', [1, 'John']) // /user/1/John\n * ```\n *\n * @remarks\n * This function is used to replace the route with the values from the array or object. If the values are not found, it will replace it with `undefined`.\n *\n * ```ts\n *  replaceRoute('/user/:id/:name', [1]) // /user/1/undefined\n * ```\n *\n **/\nexport function replaceRoute(data: Route, values: Values = []): Route {\n  let _data = data\n  const templates = _data.match(regex) ?? []\n  const isArray = Array.isArray(values)\n\n  templates.forEach((template, index) => {\n    let value\n    if (!isArray) {\n      const key = template.substring(1)\n      value = values[key]\n    } else {\n      value = values[index]\n    }\n    _data = _data.replace(template, value?.toString() ?? '')\n  })\n\n  return _data\n}\n"],"names":["copy","text","e","hexToRgba","hexadecimal","alpha","length","r","g","b","rgbaToHex","rgba","withPrefix","value","debounce","func","waitFor","args","DEFAULT_FORMATTERS_CONFIG","formatDate","locales","options","format","locale","formatNumber","formatCurrency","normalize","data","replaceUnicode","unicode","matchText","matchFn","normalizeOptions","regex","match","newData","replaceRoute","values","_data","templates","isArray","template","index","key"],"mappings":"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"}

package/dist/types/clipboard/copy.d.ts

@@ -8,9 +8,7 @@
  *
  * @example
  * ```ts
- * import { copy } from '@carto/ps-utils'
- *
  * copy('Hello world!')
  * ```
  */
-export declare function copy(text: string): void;
+export declare function copy(text: string): Promise<void>;

package/dist/types/clipboard/copy.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/types/colors/hex-to-rgba/hex-to-rgba.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/types/colors/rgba-to-hex/rgba-to-hex.d.ts

@@ -1,9 +1,9 @@
-import { RgbaDeckGLToHexOptions } from './types';
+import { RgbaToHexOptions } from './types';
 /**
  * It converts an array of RGBA values to a hexadecimal string.
  *
  * @param {number[]} rgba - rgba array, including alpha or not
- * @param {RgbaDeckGLToHexOptions} options - options to parse
+ * @param {RgbaToHexOptions} options - options to parse
  *
  * @returns A string
  *
@@ -25,4 +25,4 @@ import { RgbaDeckGLToHexOptions } from './types';
  * ```
  *
  */
-export declare function rgbaToHex(rgba: number[], { withPrefix }?: RgbaDeckGLToHexOptions): string | undefined;
+export declare function rgbaToHex(rgba: number[] | undefined, { withPrefix }?: RgbaToHexOptions): string | undefined;

package/dist/types/colors/rgba-to-hex/rgba-to-hex.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/types/colors/rgba-to-hex/types.d.ts

@@ -1,9 +1,9 @@
 /**
- * `RgbaDeckGLToHexOptions` is an object with an optional property `withPrefix` of type
+ * `RgbaToHexOptions` is an object with an optional property `withPrefix` of type
  * `boolean`.
  * @property {boolean} withPrefix - boolean - Whether to include the '#' prefix in the hex
  * string.
  */
-export type RgbaDeckGLToHexOptions = {
+export interface RgbaToHexOptions {
     withPrefix?: boolean;
-};
+}

package/dist/types/debounce/debounce.d.ts

@@ -4,4 +4,4 @@
  * @param {number} waitFor - The number of milliseconds to wait before invoking the debounced function.
  * @returns A debounced version of the provided function.
  */
-export declare function debounce<F extends (...args: any[]) => any>(func: F, waitFor: number): (...args: Parameters<F>) => ReturnType<F>;
+export declare function debounce<F extends (...args: unknown[]) => unknown>(func: F, waitFor: number): (...args: Parameters<F>) => ReturnType<F>;

package/dist/types/debounce/debounce.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/types/formatters/constants.d.ts

@@ -1 +1 @@
-export declare const CONFIG: Record<string, Intl.NumberFormatOptions | Intl.DateTimeFormatOptions>;
+export declare const DEFAULT_FORMATTERS_CONFIG: Record<string, Intl.NumberFormatOptions | Intl.DateTimeFormatOptions>;

package/dist/types/formatters/date/format-date.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/types/formatters/number/format-number.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/types/index.d.ts

@@ -1,14 +1,11 @@
-export * from './colors';
-export * from './debounce/debounce';
-export { area } from './features/area';
-export * from './features/types';
 export { copy } from './clipboard/copy';
-export * from './formatters/constants';
+export { hexToRgba } from './colors/hex-to-rgba/hex-to-rgba';
+export { rgbaToHex } from './colors/rgba-to-hex/rgba-to-hex';
+export { debounce } from './debounce/debounce';
+export { DEFAULT_FORMATTERS_CONFIG } from './formatters/constants';
 export { formatDate } from './formatters/date/format-date';
-export { formatNumber, formatCurrency } from './formatters/number/format-number';
-export * from './routes/replace-route';
-export * from './routes/types';
+export { formatCurrency, formatNumber } from './formatters/number/format-number';
 export { matchText } from './strings/match-text/match-text';
 export { normalize } from './strings/normalize/normalize';
-export * from './strings/match-text/types';
-export * from './strings/normalize/types';
+export type { Route, Values } from './strings/routes/types';
+export { replaceRoute } from './strings/routes/replace-route';

package/dist/types/strings/match-text/match-text.d.ts

@@ -2,11 +2,11 @@ import { MatchTextOptions } from './types';
 /**
  * It takes a string, an array of strings, and an optional object of options, and returns an
  * array of strings that match the input string
- * @param {string} text - The text to match against.
+ * @param {string | RegExp} text - The text to match against.
  * @param {T[] | string} data - The data to match against.
  * @param {MatchTextOptions} options - The options to use.
  *
  * @returns {T[] | string | null} - The matched data or null.
  *
  */
-export declare function matchText<T>(text: string, data: T[] | string, { matchFn, normalizeOptions }?: MatchTextOptions<T>): T[] | string | null;
+export declare function matchText<T>(value: string | RegExp, data: T[] | string, { matchFn, normalizeOptions }?: MatchTextOptions<T>): T[] | string | null;

package/dist/types/strings/match-text/match-text.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/types/strings/match-text/types.d.ts

@@ -8,7 +8,7 @@ import { NormalizeOptions } from '../normalize/types';
  * @property {NormalizeOptions} normalizeOptions - This is an object that contains the
  * options for the normalize function.
  */
-export type MatchTextOptions<T> = {
+export interface MatchTextOptions<T> {
     matchFn?: (data: T) => string;
     normalizeOptions?: NormalizeOptions;
-};
+}

package/dist/types/strings/normalize/normalize.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/types/strings/normalize/types.d.ts

@@ -9,7 +9,7 @@
  * @property {string} replaceUnicode - The unicode character to replace the unicode
  * characters with. By default is `[\u0300-\u036f]`.
  */
-export type NormalizeOptions = {
+export interface NormalizeOptions {
     format?: 'NFD' | 'NFKD' | 'NFC' | 'NFKC';
     replaceUnicode?: string;
-};
+}

package/dist/types/{routes → strings/routes}/replace-route.d.ts

@@ -20,4 +20,4 @@ import { Route, Values } from './types';
  * ```
  *
  **/
-export declare function replaceRoute(data: Route, values?: Values): string;
+export declare function replaceRoute(data: Route, values?: Values): Route;

package/dist/types/strings/routes/replace-route.test.d.ts

@@ -0,0 +1 @@
+export {};

package/package.json

@@ -1,38 +1,47 @@
 {
   "name": "@carto/ps-utils",
-  "version": "1.7.1",
-  "description": "CARTO's Professional Service Utils library",
-  "files": [
-    "dist"
-  ],
+  "version": "2.0.0-canary.0",
+  "description": "CARTO's Professional Service Helpers library",
   "type": "module",
-  "types": "./dist/types/index.d.ts",
-  "main": "./dist/index.cjs",
-  "module": "./dist/index.js",
+  "dependencies": {},
+  "devDependencies": {},
+  "peerDependencies": {},
   "exports": {
     ".": {
-      "types": "./dist/types/index.d.ts",
       "import": "./dist/index.js",
-      "require": "./dist/index.cjs"
+      "require": "./dist/index.cjs",
+      "types": "./dist/types/index.d.ts"
     }
   },
-  "scripts": {
-    "prebuild": "npm exec rimraf dist",
-    "build": "tsc && vite build",
-    "lint": "eslint src --ext ts,tsx,js,jsx,json --ignore-path ../../.gitignore --fix",
-    "format": "prettier --write . --ignore-path ../../.gitignore",
-    "test:watch": "vitest",
-    "test:related": "vitest --run --passWithNoTests",
-    "test:coverage": "vitest run --coverage"
+  "publishConfig": {
+    "access": "public"
   },
-  "dependencies": {
-    "@turf/meta": "6.5.0"
+  "files": [
+    "dist"
+  ],
+  "keywords": [
+    "carto",
+    "ps",
+    "helpers"
+  ],
+  "eslintConfig": {},
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/CartoDB/carto-ps-lib.git"
   },
-  "devDependencies": {
-    "@turf/helpers": "6.5.0",
-    "@types/geojson": "7946.0.13"
+  "author": "CARTO frontend PS team <frontend-ps@carto.com>",
+  "license": "MIT",
+  "bugs": {
+    "url": "https://github.com/CartoDB/carto-ps-lib/issues"
   },
-  "peerDependencies": {
-    "@turf/meta": ">= 6.x < 7.x"
+  "homepage": "https://github.com/CartoDB/carto-ps-lib#readme",
+  "scripts": {
+    "dev": "vite build --watch --emptyOutDir=false",
+    "build": "vite build",
+    "lint": "eslint",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "clean": "rm -rf .turbo && rm -rf node_modules && rm -rf dist"
   }
-}
+}

package/dist/index.cjs

@@ -1 +0,0 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const T=require("@turf/meta");function d(t,e=1){if(!t){console.warn(`hexToRgba: ${t} invalid hexadecimal format`);return}if(e<0||e>1){console.warn(`hexToRgba: ${e} invalid alpha format`);return}if(t?.includes("#")&&(t=t.slice(1)),!/[0-9A-Fa-f]{6}/g.test(t)&&!/[0-9A-Fa-f]{3}/g.test(t)&&!/[0-9A-Fa-f]{2}/g.test(t)){console.warn(`hexToRgba: ${t} invalid hexadecimal format`);return}const n=t.length;n<6&&(t=t.slice(0,6-n).repeat(6/n));const o=parseInt(t.length===3?t.slice(0,1).repeat(2):t.slice(0,2),16),r=parseInt(t.length===3?t.slice(1,2).repeat(2):t.slice(2,4),16),i=parseInt(t.length===3?t.slice(2,3).repeat(2):t.slice(4,6),16);return[o,r,i,e*255]}function b(t,{withPrefix:e=!0}={}){if(!t||!t.length){console.warn("rgbaDeckGLToHex: invalid array or empty values");return}if(t.some(r=>r<0||r>255)){console.warn(`rgbaDeckGLToHex: [${t.toString()}] invalid array value format`);return}const o=t.map(r=>r.toString(16).padStart(2,"0")).join("");return`${e?"#":""}${o}`}function D(t,e){return(...r)=>{clearTimeout(0),setTimeout(()=>t(...r),e)}}const m=63710088e-1;function h(t){return T.geomReduce(t,function(e,n){return e+w(n)},0)}function w(t){let e=0,n;switch(t.type){case"Polygon":return p(t.coordinates);case"MultiPolygon":for(n=0;n<t.coordinates.length;n++)e+=p(t.coordinates[n]);return e;case"Point":case"MultiPoint":case"LineString":case"MultiLineString":return 0}return 0}function p(t){let e=0;if(t&&t.length>0){e+=Math.abs(y(t[0]));for(let n=1;n<t.length;n++)e-=Math.abs(y(t[n]))}return e}function y(t){let e,n,o,r,i,c,a,s=0;const u=t.length;if(u>2){for(a=0;a<u;a++)a===u-2?(r=u-2,i=u-1,c=0):a===u-1?(r=u-1,i=0,c=1):(r=a,i=a+1,c=a+2),e=t[r],n=t[i],o=t[c],s+=(f(o[0])-f(e[0]))*Math.sin(f(n[1]));s=s*m*m/2}return s}function f(t){return t*Math.PI/180}function C(t){try{if(navigator.clipboard)navigator.clipboard.writeText(t);else{const e=document.createElement("input");e.innerHTML=t,A(e)}}catch(e){throw new Error(e)}}function A(t){const e=t.contentEditable,n=t.readOnly;try{t.contentEditable="true",t.readOnly=!1,E(t)}finally{t.contentEditable=e,t.readOnly=n}}function E(t){const e=document.createRange(),n=window.getSelection();e.selectNodeContents(t),n?.removeAllRanges(),n?.addRange(e),t.setSelectionRange(0,999999),document.execCommand("copy")}const g={NUMBER:{style:"decimal",maximumFractionDigits:1,minimumFractionDigits:0,notation:"compact",compactDisplay:"short"},CURRENCY:{style:"currency",currency:"USD",maximumFractionDigits:2,minimumFractionDigits:2,notation:"compact",compactDisplay:"short"},DATE:{year:"numeric",month:"2-digit",day:"2-digit"}};function I(t,e,n){return Intl.DateTimeFormat(e,n).format(t)}function R(t,e,n){return Intl.NumberFormat(e,n).format(t)}function N(t,e,n={}){return R(t,e,{...g.NUMBER,...n})}function S(t,e,n={}){return R(t,e,{...g.CURRENCY,...n})}const v=/:+[a-z]+/gi;function F(t,e=[]){let n=t;const o=n.match(v)||[],r=Array.isArray(e);return o.forEach((i,c)=>{let a;if(r)a=e[c];else{const s=i.substring(1);a=e[s]}n=n.replace(i,a?.toString())}),n}function l(t,{format:e="NFD",replaceUnicode:n="[̀-ͯ]"}={}){const o=new RegExp(n,"g");return t.normalize(e).replace(o,"")}function M(t,e,{matchFn:n,normalizeOptions:o}={}){const r=new RegExp(l(t.toLowerCase(),o),"gi");return Array.isArray(e)?e.filter(i=>{const c=n?n(i):i;return l(c).match(r)}):l(e).match(r)?e:null}exports.CONFIG=g;exports.area=h;exports.copy=C;exports.debounce=D;exports.formatCurrency=S;exports.formatDate=I;exports.formatNumber=N;exports.hexToRgba=d;exports.hexToRgbaDeckGL=d;exports.matchText=M;exports.normalize=l;exports.replaceRoute=F;exports.rgbaDeckGLToHex=b;exports.rgbaToHex=b;

package/dist/types/colors/index.d.ts

@@ -1,5 +0,0 @@
-export { hexToRgba } from './hex-to-rgba/hex-to-rgba';
-export { hexToRgba as hexToRgbaDeckGL } from './hex-to-rgba/hex-to-rgba';
-export { rgbaToHex } from './rgba-to-hex/rgba-to-hex';
-export { rgbaToHex as rgbaDeckGLToHex } from './rgba-to-hex/rgba-to-hex';
-export * from './rgba-to-hex/types';

package/dist/types/features/area.d.ts

@@ -1,17 +0,0 @@
-import type { GeojsonAreaProps } from './types';
-/**
- * Takes one or more features and returns their area in square meters paying attention to earth radius.
- * It's fixed in turf.js v7.0.0+ for previous versions of turf use this function instead turf.area
- * @name area
- * @param {GeojsonAreaProps>} geojson {GeoJSON} input GeoJSON feature(s)
- * @returns {number} area in square meters
- * @example
- * let polygon = turf.polygon([[[125, -15], [113, -22], [154, -27], [144, -15], [125, -15]]]);
- *
- * let area = turf.area(polygon);
- *
- * //addToMap
- * let addToMap = [polygon]
- * polygon.properties.area = area
- */
-export declare function area(geojson: GeojsonAreaProps): any;

package/dist/types/features/types.d.ts

@@ -1,4 +0,0 @@
-import type { Geometries } from '@turf/helpers';
-import type { Feature, FeatureCollection, LineString, GeoJsonProperties, MultiLineString, MultiPoint, MultiPolygon, Point, Polygon } from 'geojson';
-export type GeomAreaProps = Point | LineString | Polygon | MultiPoint | MultiLineString | MultiPolygon;
-export type GeojsonAreaProps = Geometries | FeatureCollection<Geometries, GeoJsonProperties> | Feature<Geometries, GeoJsonProperties>;