@ooneex/color 0.0.17 → 0.1.0

package/README.md

@@ -1 +1,37 @@
 # @ooneex/color
+
+Curated color palette with hex values and human-friendly names plus TypeScript types for UI theming.
+
+![Bun](https://img.shields.io/badge/Bun-Compatible-orange?style=flat-square&logo=bun)
+![TypeScript](https://img.shields.io/badge/TypeScript-Ready-blue?style=flat-square&logo=typescript)
+![MIT License](https://img.shields.io/badge/License-MIT-yellow?style=flat-square)
+
+## Features
+
+- **Simple Palette** - `SIMPLE_COLORS` — a curated set of 26 hex colors suitable for charts, avatars, and tags
+- **Human-Friendly Names** - `SIMPLE_COLOR_NAMES` maps each hex to a readable label (Blue, Emerald, Coral, …)
+- **Type-Safe** - `SimpleColorType` narrows to the exact hex values in the palette
+- **Zero Dependencies** - Pure constants, no runtime dependencies
+
+## Installation
+
+```bash
+bun add @ooneex/color
+```
+
+## Usage
+
+```ts
+import { SIMPLE_COLOR_NAMES, SIMPLE_COLORS, type SimpleColorType } from "@ooneex/color";
+
+const color: SimpleColorType = "#3B82F6";
+SIMPLE_COLOR_NAMES[color]; // "Blue"
+
+for (const hex of SIMPLE_COLORS) {
+  console.log(hex, SIMPLE_COLOR_NAMES[hex]);
+}
+```
+
+## License
+
+This project is licensed under the MIT License - see the [LICENSE](./LICENSE) file for details.

package/dist/index.d.ts

@@ -1,22 +1,5 @@
-import { IBase } from "@ooneex/types";
-type HexaType = `#${string}`;
-type RGBType = `rgb(${number}, ${number}, ${number})`;
-type RGBAType = `rgba(${number}, ${number}, ${number}, ${number})`;
-type HSLType = `hsl(${number}, ${number}%, ${number}%)`;
-type HSLAType = `hsla(${number}, ${number}%, ${number}%, ${number})`;
-type ColorType = HexaType | RGBType | RGBAType | HSLType | HSLAType;
-interface IColor extends IBase {
-	hex?: HexaType;
-	rgb?: RGBType;
-	rgba?: RGBAType;
-	hsl?: HSLType;
-	hsla?: HSLAType;
-	alpha?: number;
-	red?: number;
-	green?: number;
-	blue?: number;
-	hue?: number;
-	saturation?: number;
-	lightness?: number;
-}
-export { RGBType, RGBAType, IColor, HexaType, HSLType, HSLAType, ColorType };
+type SimpleColorType = (typeof SIMPLE_COLORS)[number];
+declare const SIMPLE_COLORS: readonly ["#3B82F6", "#10B981", "#8B5CF6", "#F59E0B", "#EC4899", "#F97316", "#6B7280", "#EF4444", "#14B8A6", "#6366F1", "#84CC16", "#06B6D4", "#A855F7", "#F43F5E", "#78716C", "#0EA5E9", "#22C55E", "#FACC15", "#E879F9", "#2DD4BF", "#FB923C", "#818CF8", "#F472B6", "#4ADE80", "#000000", "#FFFFFF"];
+declare const SIMPLE_COLOR_NAMES: Record<SimpleColorType, string>;
+declare const hexToRgba: (hex: string, alpha?: number) => string | null;
+export { hexToRgba, SimpleColorType, SIMPLE_COLOR_NAMES, SIMPLE_COLORS };

package/dist/index.js

@@ -1,2 +1,87 @@
+// src/constants.ts
+var SIMPLE_COLORS = [
+  "#3B82F6",
+  "#10B981",
+  "#8B5CF6",
+  "#F59E0B",
+  "#EC4899",
+  "#F97316",
+  "#6B7280",
+  "#EF4444",
+  "#14B8A6",
+  "#6366F1",
+  "#84CC16",
+  "#06B6D4",
+  "#A855F7",
+  "#F43F5E",
+  "#78716C",
+  "#0EA5E9",
+  "#22C55E",
+  "#FACC15",
+  "#E879F9",
+  "#2DD4BF",
+  "#FB923C",
+  "#818CF8",
+  "#F472B6",
+  "#4ADE80",
+  "#000000",
+  "#FFFFFF"
+];
+var SIMPLE_COLOR_NAMES = {
+  "#3B82F6": "Blue",
+  "#10B981": "Green",
+  "#8B5CF6": "Purple",
+  "#F59E0B": "Yellow",
+  "#EC4899": "Pink",
+  "#F97316": "Orange",
+  "#6B7280": "Gray",
+  "#EF4444": "Red",
+  "#14B8A6": "Teal",
+  "#6366F1": "Indigo",
+  "#84CC16": "Lime",
+  "#06B6D4": "Cyan",
+  "#A855F7": "Violet",
+  "#F43F5E": "Rose",
+  "#78716C": "Stone",
+  "#0EA5E9": "Sky",
+  "#22C55E": "Emerald",
+  "#FACC15": "Amber",
+  "#E879F9": "Fuchsia",
+  "#2DD4BF": "Mint",
+  "#FB923C": "Tangerine",
+  "#818CF8": "Periwinkle",
+  "#F472B6": "Coral",
+  "#4ADE80": "Spring",
+  "#000000": "Black",
+  "#FFFFFF": "White"
+};
+// src/hexToRgba.ts
+var hexToRgba = (hex, alpha) => {
+  const match = hex.trim().replace(/^#/, "");
+  if (!/^([0-9a-fA-F]{3}|[0-9a-fA-F]{4}|[0-9a-fA-F]{6}|[0-9a-fA-F]{8})$/.test(match)) {
+    return null;
+  }
+  const expand = (value) => value.length <= 4 ? value.split("").map((c) => c + c).join("") : value;
+  const full = expand(match);
+  const r = Number.parseInt(full.slice(0, 2), 16);
+  const g = Number.parseInt(full.slice(2, 4), 16);
+  const b = Number.parseInt(full.slice(4, 6), 16);
+  let a = 1;
+  if (alpha !== undefined) {
+    if (alpha < 0 || alpha > 1 || Number.isNaN(alpha)) {
+      return null;
+    }
+    a = alpha;
+  } else if (full.length === 8) {
+    a = Number.parseInt(full.slice(6, 8), 16) / 255;
+  }
+  const roundedAlpha = Math.round(a * 1000) / 1000;
+  return `rgba(${r}, ${g}, ${b}, ${roundedAlpha})`;
+};
+export {
+  hexToRgba,
+  SIMPLE_COLOR_NAMES,
+  SIMPLE_COLORS
+};
 
-//# debugId=BC4C8D5165931A0D64756E2164756E21
+//# debugId=2AEC7FA91EDDC8D564756E2164756E21

package/dist/index.js.map

@@ -1,9 +1,11 @@
 {
   "version": 3,
-  "sources": [],
+  "sources": ["src/constants.ts", "src/hexToRgba.ts"],
   "sourcesContent": [
+    "import type { SimpleColorType } from \"./types\";\n\nexport const SIMPLE_COLORS = [\n  \"#3B82F6\",\n  \"#10B981\",\n  \"#8B5CF6\",\n  \"#F59E0B\",\n  \"#EC4899\",\n  \"#F97316\",\n  \"#6B7280\",\n  \"#EF4444\",\n  \"#14B8A6\",\n  \"#6366F1\",\n  \"#84CC16\",\n  \"#06B6D4\",\n  \"#A855F7\",\n  \"#F43F5E\",\n  \"#78716C\",\n  \"#0EA5E9\",\n  \"#22C55E\",\n  \"#FACC15\",\n  \"#E879F9\",\n  \"#2DD4BF\",\n  \"#FB923C\",\n  \"#818CF8\",\n  \"#F472B6\",\n  \"#4ADE80\",\n  \"#000000\",\n  \"#FFFFFF\",\n] as const;\n\nexport const SIMPLE_COLOR_NAMES: Record<SimpleColorType, string> = {\n  \"#3B82F6\": \"Blue\",\n  \"#10B981\": \"Green\",\n  \"#8B5CF6\": \"Purple\",\n  \"#F59E0B\": \"Yellow\",\n  \"#EC4899\": \"Pink\",\n  \"#F97316\": \"Orange\",\n  \"#6B7280\": \"Gray\",\n  \"#EF4444\": \"Red\",\n  \"#14B8A6\": \"Teal\",\n  \"#6366F1\": \"Indigo\",\n  \"#84CC16\": \"Lime\",\n  \"#06B6D4\": \"Cyan\",\n  \"#A855F7\": \"Violet\",\n  \"#F43F5E\": \"Rose\",\n  \"#78716C\": \"Stone\",\n  \"#0EA5E9\": \"Sky\",\n  \"#22C55E\": \"Emerald\",\n  \"#FACC15\": \"Amber\",\n  \"#E879F9\": \"Fuchsia\",\n  \"#2DD4BF\": \"Mint\",\n  \"#FB923C\": \"Tangerine\",\n  \"#818CF8\": \"Periwinkle\",\n  \"#F472B6\": \"Coral\",\n  \"#4ADE80\": \"Spring\",\n  \"#000000\": \"Black\",\n  \"#FFFFFF\": \"White\",\n};\n",
+    "export const hexToRgba = (hex: string, alpha?: number): string | null => {\n  const match = hex.trim().replace(/^#/, \"\");\n\n  if (!/^([0-9a-fA-F]{3}|[0-9a-fA-F]{4}|[0-9a-fA-F]{6}|[0-9a-fA-F]{8})$/.test(match)) {\n    return null;\n  }\n\n  const expand = (value: string): string =>\n    value.length <= 4\n      ? value\n          .split(\"\")\n          .map((c) => c + c)\n          .join(\"\")\n      : value;\n\n  const full = expand(match);\n  const r = Number.parseInt(full.slice(0, 2), 16);\n  const g = Number.parseInt(full.slice(2, 4), 16);\n  const b = Number.parseInt(full.slice(4, 6), 16);\n\n  let a = 1;\n  if (alpha !== undefined) {\n    if (alpha < 0 || alpha > 1 || Number.isNaN(alpha)) {\n      return null;\n    }\n    a = alpha;\n  } else if (full.length === 8) {\n    a = Number.parseInt(full.slice(6, 8), 16) / 255;\n  }\n\n  const roundedAlpha = Math.round(a * 1000) / 1000;\n\n  return `rgba(${r}, ${g}, ${b}, ${roundedAlpha})`;\n};\n"
   ],
-  "mappings": "",
-  "debugId": "BC4C8D5165931A0D64756E2164756E21",
+  "mappings": ";AAEO,IAAM,gBAAgB;AAAA,EAC3B;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;AAEO,IAAM,qBAAsD;AAAA,EACjE,WAAW;AAAA,EACX,WAAW;AAAA,EACX,WAAW;AAAA,EACX,WAAW;AAAA,EACX,WAAW;AAAA,EACX,WAAW;AAAA,EACX,WAAW;AAAA,EACX,WAAW;AAAA,EACX,WAAW;AAAA,EACX,WAAW;AAAA,EACX,WAAW;AAAA,EACX,WAAW;AAAA,EACX,WAAW;AAAA,EACX,WAAW;AAAA,EACX,WAAW;AAAA,EACX,WAAW;AAAA,EACX,WAAW;AAAA,EACX,WAAW;AAAA,EACX,WAAW;AAAA,EACX,WAAW;AAAA,EACX,WAAW;AAAA,EACX,WAAW;AAAA,EACX,WAAW;AAAA,EACX,WAAW;AAAA,EACX,WAAW;AAAA,EACX,WAAW;AACb;;AC1DO,IAAM,YAAY,CAAC,KAAa,UAAkC;AAAA,EACvE,MAAM,QAAQ,IAAI,KAAK,EAAE,QAAQ,MAAM,EAAE;AAAA,EAEzC,IAAI,CAAC,kEAAkE,KAAK,KAAK,GAAG;AAAA,IAClF,OAAO;AAAA,EACT;AAAA,EAEA,MAAM,SAAS,CAAC,UACd,MAAM,UAAU,IACZ,MACG,MAAM,EAAE,EACR,IAAI,CAAC,MAAM,IAAI,CAAC,EAChB,KAAK,EAAE,IACV;AAAA,EAEN,MAAM,OAAO,OAAO,KAAK;AAAA,EACzB,MAAM,IAAI,OAAO,SAAS,KAAK,MAAM,GAAG,CAAC,GAAG,EAAE;AAAA,EAC9C,MAAM,IAAI,OAAO,SAAS,KAAK,MAAM,GAAG,CAAC,GAAG,EAAE;AAAA,EAC9C,MAAM,IAAI,OAAO,SAAS,KAAK,MAAM,GAAG,CAAC,GAAG,EAAE;AAAA,EAE9C,IAAI,IAAI;AAAA,EACR,IAAI,UAAU,WAAW;AAAA,IACvB,IAAI,QAAQ,KAAK,QAAQ,KAAK,OAAO,MAAM,KAAK,GAAG;AAAA,MACjD,OAAO;AAAA,IACT;AAAA,IACA,IAAI;AAAA,EACN,EAAO,SAAI,KAAK,WAAW,GAAG;AAAA,IAC5B,IAAI,OAAO,SAAS,KAAK,MAAM,GAAG,CAAC,GAAG,EAAE,IAAI;AAAA,EAC9C;AAAA,EAEA,MAAM,eAAe,KAAK,MAAM,IAAI,IAAI,IAAI;AAAA,EAE5C,OAAO,QAAQ,MAAM,MAAM,MAAM;AAAA;",
+  "debugId": "2AEC7FA91EDDC8D564756E2164756E21",
   "names": []
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@ooneex/color",
-  "description": "Color types and utilities for consistent theming and styling across Ooneex applications",
-  "version": "0.0.17",
+  "description": "Curated color palette with hex values and human-friendly names plus TypeScript types for UI theming",
+  "version": "0.1.0",
   "type": "module",
   "files": [
     "dist",
@@ -22,22 +22,20 @@
   },
   "license": "MIT",
   "scripts": {
+    "test": "bun test tests",
     "build": "bunup",
     "lint": "tsgo --noEmit && bunx biome lint",
-    "npm:publish": "bun publish --tolerate-republish --access public"
+    "npm:publish": "bun publish --tolerate-republish --force --production --access public"
   },
   "dependencies": {},
-  "devDependencies": {
-    "@ooneex/types": "0.0.16"
-  },
   "keywords": [
     "bun",
     "color",
-    "colors",
-    "css",
+    "hex",
     "ooneex",
     "palette",
-    "theming",
-    "typescript"
+    "theme",
+    "typescript",
+    "ui"
   ]
 }