@carto/ps-utils 0.0.2-alpha.18

package/README.md

@@ -0,0 +1,11 @@
+# CARTO PS Library - Utils
+
+This repository contains the packages with utils helpers.
+
+The see what helpers are available, the functions and examples, see [docs](https://github.com/CartoDB/carto-ps-lib/blob/main/packages/utils/docs/README.md) section.
+
+## 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.

package/dist/ps-utils.es.js

@@ -0,0 +1,26 @@
+function hexToRgbaDeckGL(hexadecimal, alpha = 1) {
+  if (!hexadecimal) {
+    console.warn(`hexToRgbaDeckGL: ${hexadecimal} invalid hexadecimal format`);
+    return;
+  }
+  if (alpha < 0 || alpha > 1) {
+    console.warn(`hexToRgbaDeckGL: ${alpha} invalid alpha format`);
+    return;
+  }
+  if (hexadecimal == null ? void 0 : hexadecimal.includes("#")) {
+    hexadecimal = hexadecimal.slice(1);
+  }
+  if (!/[0-9A-Fa-f]{6}/g.test(hexadecimal) && !/[0-9A-Fa-f]{3}/g.test(hexadecimal) && !/[0-9A-Fa-f]{2}/g.test(hexadecimal)) {
+    console.warn(`hexToRgbaDeckGL: ${hexadecimal} invalid hexadecimal format`);
+    return;
+  }
+  const length = hexadecimal.length;
+  if (length < 6) {
+    hexadecimal = hexadecimal.slice(0, 6 - length).repeat(6 / length);
+  }
+  const r = parseInt(hexadecimal.length === 3 ? hexadecimal.slice(0, 1).repeat(2) : hexadecimal.slice(0, 2), 16);
+  const g = parseInt(hexadecimal.length === 3 ? hexadecimal.slice(1, 2).repeat(2) : hexadecimal.slice(2, 4), 16);
+  const b = parseInt(hexadecimal.length === 3 ? hexadecimal.slice(2, 3).repeat(2) : hexadecimal.slice(4, 6), 16);
+  return [r, g, b, alpha * 255];
+}
+export { hexToRgbaDeckGL };

package/dist/ps-utils.umd.js

@@ -0,0 +1 @@
+(function(n,s){typeof exports=="object"&&typeof module!="undefined"?s(exports):typeof define=="function"&&define.amd?define(["exports"],s):(n=typeof globalThis!="undefined"?globalThis:n||self,s(n.PsUtils={}))})(this,function(n){"use strict";function s(t,o=1){if(!t){console.warn(`hexToRgbaDeckGL: ${t} invalid hexadecimal format`);return}if(o<0||o>1){console.warn(`hexToRgbaDeckGL: ${o} invalid alpha format`);return}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(`hexToRgbaDeckGL: ${t} invalid hexadecimal format`);return}const e=t.length;e<6&&(t=t.slice(0,6-e).repeat(6/e));const r=parseInt(t.length===3?t.slice(0,1).repeat(2):t.slice(0,2),16),f=parseInt(t.length===3?t.slice(1,2).repeat(2):t.slice(2,4),16),u=parseInt(t.length===3?t.slice(2,3).repeat(2):t.slice(4,6),16);return[r,f,u,o*255]}n.hexToRgbaDeckGL=s,Object.defineProperties(n,{__esModule:{value:!0},[Symbol.toStringTag]:{value:"Module"}})});

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

@@ -0,0 +1,24 @@
+/**
+ * Function to parse hexadecimal string to deck.gl colors format.
+ *
+ * @param {string} hexadecimal - hexadecimal string, including # or not
+ * @param {number} alpha - opacity of final color, value must be between 0-1
+ *
+ * @example
+ *
+ * 6 digits hexadecimal:
+ * ```ts
+ * hexToRgbaDeckGL('#d1d1d1', 1)
+ * ```
+ * 3 digits hexadecimal:
+ * ```ts
+ * hexToRgbaDeckGL('#d1d', 1)
+ * ```
+ * 2 digits hexadecimal:
+ * ```ts
+ * hexToRgbaDeckGL('#d1', 1)
+ * ```
+ *
+ * @alpha
+ */
+export declare function hexToRgbaDeckGL(hexadecimal: string, alpha?: number): number[] | undefined;

package/dist/types/index.d.ts

@@ -0,0 +1 @@
+export { hexToRgbaDeckGL } from './colors/hexToRgbaDeckGL';

package/package.json

@@ -0,0 +1,27 @@
+{
+  "name": "@carto/ps-utils",
+  "version": "0.0.2-alpha.18",
+  "description": "CARTO's Professional Service Utils library",
+  "files": [
+    "dist"
+  ],
+  "type": "module",
+  "types": "./dist/types/index.d.ts",
+  "main": "./dist/ps-utils.umd.js",
+  "module": "./dist/ps-utils.es.js",
+  "exports": {
+    ".": {
+      "import": "./dist/ps-utils.es.js",
+      "require": "./dist/ps-utils.umd.js"
+    }
+  },
+  "scripts": {
+    "build": "vite build && mv dist/src dist/types",
+    "lint": "eslint './**/*.{ts,tsx}' --ignore-path ../../.gitignore",
+    "format": "prettier --write . --ignore-path ../../.gitignore",
+    "docs:generate": "typedoc --options ../../typedoc.json src/index.ts",
+    "test:watch": "vitest",
+    "test:coverage": "vitest --coverage"
+  },
+  "dependencies": {}
+}