@a_ng_d/utils-ui-color-palette 1.7.1 → 1.7.3

package/README.md

@@ -36,7 +36,7 @@ UI Color Palette is available for:
 
 - **Color Harmony Generation**:
 
-  - Generate analogous, complementary, triadic, tetradic, and square color harmonies
+  - Generate analogous, complementary, triadic, tetradic, square, and compound color harmonies
   - Configurable analogous spread angle
   - Automatic color relationship calculations
   - Support for all major color harmony types
@@ -184,6 +184,52 @@ dominantColors.updateOptions({
 const options = dominantColors.getOptions()
 ```
 
+#### Working with File Uploads (ArrayBuffer)
+
+For modern web applications that need to extract colors from uploaded image files:
+
+```typescript
+import { DominantColors } from '@a_ng_d/utils-ui-color-palette'
+
+// Handle file upload from user input
+const handleImageUpload = async (event: Event) => {
+  const file = (event.target as HTMLInputElement).files?.[0]
+  if (!file) return
+
+  // Convert file to ArrayBuffer
+  const arrayBuffer = await file.arrayBuffer()
+
+  try {
+    // Simple usage: extract 5 dominant colors
+    const colors = await DominantColors.extract(arrayBuffer, 5)
+    
+    console.log('Extracted colors:', colors)
+    // Each color object contains: { color, hex, percentage, count }
+    
+  } catch (error) {
+    console.error('Error extracting colors:', error)
+  }
+}
+
+// Advanced usage with custom options
+const extractColorsAdvanced = async (arrayBuffer: ArrayBuffer) => {
+  const colors = await DominantColors.fromArrayBuffer(arrayBuffer, {
+    colorCount: 8,
+    maxIterations: 100,
+    tolerance: 0.005,
+    skipTransparent: true,
+    maxImageSize: 300, // Resize large images for faster processing
+  })
+
+  return colors
+}
+
+// HTML file input example
+// <input type="file" accept="image/*" onChange={handleImageUpload} />
+```
+
+**Note**: ArrayBuffer extraction requires a browser environment with Canvas API support.
+
 ### Color Harmony Generation
 
 ```typescript
@@ -201,11 +247,12 @@ const complementary = colorHarmony.generateComplementary()
 const triadic = colorHarmony.generateTriadic()
 const tetradic = colorHarmony.generateTetradic()
 const square = colorHarmony.generateSquare()
+const compound = colorHarmony.generateCompound()
 
 // Generate harmony by type
-const harmony = colorHarmony.generateHarmony('triadic')
+const harmony = colorHarmony.generateHarmony('TRIADIC')
 
-// Generate all harmonies at once
+// Generate all harmonies at once (now includes 6 harmonies)
 const allHarmonies = colorHarmony.getAllHarmonies()
 
 // Results contain both RGB and hex values

package/dist/modules/color-harmony/color-harmony.d.ts

@@ -12,6 +12,7 @@ export default class ColorHarmony {
     generateTriadic: () => ColorHarmonyResult;
     generateTetradic: () => ColorHarmonyResult;
     generateSquare: () => ColorHarmonyResult;
+    generateCompound: () => ColorHarmonyResult;
     generateHarmony: (type: HarmonyType) => ColorHarmonyResult;
     getAllHarmonies: () => ColorHarmonyResult[];
     private normalizeHue;

package/dist/modules/color-harmony/color-harmony.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"color-harmony.d.ts","sourceRoot":"","sources":["../../../src/modules/color-harmony/color-harmony.ts"],"names":[],"mappings":"AACA,OAAO,EACL,OAAO,EAEP,WAAW,EACX,kBAAkB,EAClB,mBAAmB,EACpB,MAAM,kBAAkB,CAAA;AAEzB,MAAM,CAAC,OAAO,OAAO,YAAY;IAC/B,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,eAAe,CAAQ;IAC/B,OAAO,CAAC,YAAY,CAAwB;gBAEhC,EACV,SAAuB,EACvB,eAAoB,EACpB,YAAqB,GACtB,EAAE;QACD,SAAS,CAAC,EAAE,OAAO,CAAA;KACpB,GAAG,mBAAmB;IAMvB,iBAAiB,QAAO,kBAAkB,CAmBzC;IAED,qBAAqB,QAAO,kBAAkB,CAU7C;IAED,eAAe,QAAO,kBAAkB,CAWvC;IAED,gBAAgB,QAAO,kBAAkB,CAYxC;IAED,cAAc,QAAO,kBAAkB,CAYtC;IAED,eAAe,SAAU,WAAW,KAAG,kBAAkB,CAexD;IAED,eAAe,QAAO,kBAAkB,EAAE,CAQzC;IAED,OAAO,CAAC,YAAY,CAInB;IAED,OAAO,CAAC,QAAQ,CAOf;IAED,OAAO,CAAC,YAAY,CA8BnB;IAED,YAAY,UAAW,OAAO,KAAG,IAAI,CAEpC;IAED,kBAAkB,WAAY,MAAM,KAAG,IAAI,CAE1C;IAED,aAAa,YAAa,OAAO,CAAC,mBAAmB,CAAC,KAAG,IAAI,CAO5D;IAED,UAAU,QAAO,mBAAmB,CAGlC;CACH"}
+{"version":3,"file":"color-harmony.d.ts","sourceRoot":"","sources":["../../../src/modules/color-harmony/color-harmony.ts"],"names":[],"mappings":"AACA,OAAO,EACL,OAAO,EAEP,WAAW,EACX,kBAAkB,EAClB,mBAAmB,EACpB,MAAM,kBAAkB,CAAA;AAEzB,MAAM,CAAC,OAAO,OAAO,YAAY;IAC/B,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,eAAe,CAAQ;IAC/B,OAAO,CAAC,YAAY,CAAwB;gBAEhC,EACV,SAAuB,EACvB,eAAoB,EACpB,YAAqB,GACtB,EAAE;QACD,SAAS,CAAC,EAAE,OAAO,CAAA;KACpB,GAAG,mBAAmB;IAMvB,iBAAiB,QAAO,kBAAkB,CAmBzC;IAED,qBAAqB,QAAO,kBAAkB,CAU7C;IAED,eAAe,QAAO,kBAAkB,CAWvC;IAED,gBAAgB,QAAO,kBAAkB,CAYxC;IAED,cAAc,QAAO,kBAAkB,CAYtC;IAED,gBAAgB,QAAO,kBAAkB,CAYxC;IAED,eAAe,SAAU,WAAW,KAAG,kBAAkB,CAiBxD;IAED,eAAe,QAAO,kBAAkB,EAAE,CASzC;IAED,OAAO,CAAC,YAAY,CAInB;IAED,OAAO,CAAC,QAAQ,CAOf;IAED,OAAO,CAAC,YAAY,CA8BnB;IAED,YAAY,UAAW,OAAO,KAAG,IAAI,CAEpC;IAED,kBAAkB,WAAY,MAAM,KAAG,IAAI,CAE1C;IAED,aAAa,YAAa,OAAO,CAAC,mBAAmB,CAAC,KAAG,IAAI,CAO5D;IAED,UAAU,QAAO,mBAAmB,CAGlC;CACH"}

package/dist/modules/color-harmony/color-harmony.js

@@ -1,18 +1,18 @@
 var i = Object.defineProperty;
-var u = (n, e, t) => e in n ? i(n, e, { enumerable: !0, configurable: !0, writable: !0, value: t }) : n[e] = t;
-var r = (n, e, t) => u(n, typeof e != "symbol" ? e + "" : e, t);
-import { c as o } from "../../index-Beb8qoyd.js";
+var u = (h, e, t) => e in h ? i(h, e, { enumerable: !0, configurable: !0, writable: !0, value: t }) : h[e] = t;
+var o = (h, e, t) => u(h, typeof e != "symbol" ? e + "" : e, t);
+import { c as r } from "../../index-Beb8qoyd.js";
 class m {
   constructor({
     baseColor: e = [255, 0, 0],
     analogousSpread: t = 30,
     returnFormat: s = "both"
   }) {
-    r(this, "baseColor");
-    r(this, "analogousSpread");
-    r(this, "returnFormat");
-    r(this, "generateAnalogous", () => {
-      const e = o(this.baseColor).hsl(), t = e[0] || 0, s = [
+    o(this, "baseColor");
+    o(this, "analogousSpread");
+    o(this, "returnFormat");
+    o(this, "generateAnalogous", () => {
+      const e = r(this.baseColor).hsl(), t = e[0] || 0, s = [
         this.baseColor,
         this.hueToRgb(
           this.normalizeHue(t - this.analogousSpread),
@@ -25,82 +25,93 @@ class m {
           e[2]
         )
       ];
-      return this.formatResult("analogous", s);
+      return this.formatResult("ANALOGOUS", s);
     });
-    r(this, "generateComplementary", () => {
-      const e = o(this.baseColor).hsl(), t = e[0] || 0, s = [
+    o(this, "generateComplementary", () => {
+      const e = r(this.baseColor).hsl(), t = e[0] || 0, s = [
         this.baseColor,
         this.hueToRgb(this.normalizeHue(t + 180), e[1], e[2])
       ];
-      return this.formatResult("complementary", s);
+      return this.formatResult("COMPLEMENTARY", s);
     });
-    r(this, "generateTriadic", () => {
-      const e = o(this.baseColor).hsl(), t = e[0] || 0, s = [
+    o(this, "generateTriadic", () => {
+      const e = r(this.baseColor).hsl(), t = e[0] || 0, s = [
         this.baseColor,
         this.hueToRgb(this.normalizeHue(t + 120), e[1], e[2]),
         this.hueToRgb(this.normalizeHue(t + 240), e[1], e[2])
       ];
-      return this.formatResult("triadic", s);
+      return this.formatResult("TRIADIC", s);
     });
-    r(this, "generateTetradic", () => {
-      const e = o(this.baseColor).hsl(), t = e[0] || 0, s = [
+    o(this, "generateTetradic", () => {
+      const e = r(this.baseColor).hsl(), t = e[0] || 0, s = [
         this.baseColor,
         this.hueToRgb(this.normalizeHue(t + 90), e[1], e[2]),
         this.hueToRgb(this.normalizeHue(t + 180), e[1], e[2]),
         this.hueToRgb(this.normalizeHue(t + 270), e[1], e[2])
       ];
-      return this.formatResult("tetradic", s);
+      return this.formatResult("TETRADIC", s);
     });
-    r(this, "generateSquare", () => {
-      const e = o(this.baseColor).hsl(), t = e[0] || 0, s = [
+    o(this, "generateSquare", () => {
+      const e = r(this.baseColor).hsl(), t = e[0] || 0, s = [
         this.baseColor,
         this.hueToRgb(this.normalizeHue(t + 90), e[1], e[2]),
         this.hueToRgb(this.normalizeHue(t + 180), e[1], e[2]),
         this.hueToRgb(this.normalizeHue(t + 270), e[1], e[2])
       ];
-      return this.formatResult("square", s);
+      return this.formatResult("SQUARE", s);
     });
-    r(this, "generateHarmony", (e) => {
+    o(this, "generateCompound", () => {
+      const e = r(this.baseColor).hsl(), t = e[0] || 0, s = this.normalizeHue(t + 180), a = [
+        this.baseColor,
+        this.hueToRgb(this.normalizeHue(s - 30), e[1], e[2]),
+        this.hueToRgb(this.normalizeHue(s + 30), e[1], e[2])
+      ];
+      return this.formatResult("COMPOUND", a);
+    });
+    o(this, "generateHarmony", (e) => {
       switch (e) {
-        case "analogous":
+        case "ANALOGOUS":
           return this.generateAnalogous();
-        case "complementary":
+        case "COMPLEMENTARY":
           return this.generateComplementary();
-        case "triadic":
+        case "TRIADIC":
           return this.generateTriadic();
-        case "tetradic":
+        case "TETRADIC":
           return this.generateTetradic();
-        case "square":
+        case "SQUARE":
           return this.generateSquare();
+        case "COMPOUND":
+          return this.generateCompound();
         default:
           throw new Error(`Unknown harmony type: ${e}`);
       }
     });
-    r(this, "getAllHarmonies", () => [
+    o(this, "getAllHarmonies", () => [
       this.generateAnalogous(),
       this.generateComplementary(),
       this.generateTriadic(),
       this.generateTetradic(),
-      this.generateSquare()
+      this.generateSquare(),
+      this.generateCompound()
     ]);
-    r(this, "normalizeHue", (e) => {
+    o(this, "normalizeHue", (e) => {
       for (; e < 0; ) e += 360;
       for (; e >= 360; ) e -= 360;
       return e;
     });
-    r(this, "hueToRgb", (e, t, s) => {
-      const h = o.hsl(e, t, s).rgb();
-      return [Math.round(h[0]), Math.round(h[1]), Math.round(h[2])];
+    o(this, "hueToRgb", (e, t, s) => {
+      const a = r.hsl(e, t, s).rgb();
+      return [Math.round(a[0]), Math.round(a[1]), Math.round(a[2])];
     });
-    r(this, "formatResult", (e, t) => {
+    o(this, "formatResult", (e, t) => {
       const s = t.map(
-        (a) => [
-          Math.round(a[0]),
-          Math.round(a[1]),
-          Math.round(a[2])
+        (n) => [
+          Math.round(n[0]),
+          Math.round(n[1]),
+          Math.round(n[2])
         ]
-      ), h = s.map(
-        (a) => o.rgb(a[0], a[1], a[2]).hex()
+      ), a = s.map(
+        (n) => r.rgb(n[0], n[1], n[2]).hex()
       );
       return {
         type: e,
@@ -109,21 +120,21 @@ class m {
           Math.round(this.baseColor[1]),
           Math.round(this.baseColor[2])
         ],
-        baseHex: o.rgb(this.baseColor[0], this.baseColor[1], this.baseColor[2]).hex(),
+        baseHex: r.rgb(this.baseColor[0], this.baseColor[1], this.baseColor[2]).hex(),
         colors: s,
-        hexColors: h
+        hexColors: a
       };
     });
-    r(this, "setBaseColor", (e) => {
+    o(this, "setBaseColor", (e) => {
       this.baseColor = e;
     });
-    r(this, "setAnalogousSpread", (e) => {
+    o(this, "setAnalogousSpread", (e) => {
       this.analogousSpread = Math.max(1, Math.min(e, 180));
     });
-    r(this, "updateOptions", (e) => {
+    o(this, "updateOptions", (e) => {
       e.analogousSpread !== void 0 && this.setAnalogousSpread(e.analogousSpread), e.returnFormat !== void 0 && (this.returnFormat = e.returnFormat);
     });
-    r(this, "getOptions", () => ({
+    o(this, "getOptions", () => ({
       analogousSpread: this.analogousSpread,
       returnFormat: this.returnFormat
     }));

package/dist/modules/color-harmony/color-harmony.js.map

@@ -1 +1 @@
-{"version":3,"file":"color-harmony.js","sources":["../../../src/modules/color-harmony/color-harmony.ts"],"sourcesContent":["import chroma from 'chroma-js'\nimport {\n  Channel,\n  HexModel,\n  HarmonyType,\n  ColorHarmonyResult,\n  ColorHarmonyOptions,\n} from '@tps/color.types'\n\nexport default class ColorHarmony {\n  private baseColor: Channel\n  private analogousSpread: number\n  private returnFormat: 'rgb' | 'hex' | 'both'\n\n  constructor({\n    baseColor = [255, 0, 0],\n    analogousSpread = 30,\n    returnFormat = 'both',\n  }: {\n    baseColor?: Channel\n  } & ColorHarmonyOptions) {\n    this.baseColor = baseColor\n    this.analogousSpread = analogousSpread\n    this.returnFormat = returnFormat\n  }\n\n  generateAnalogous = (): ColorHarmonyResult => {\n    const hsl = chroma(this.baseColor).hsl()\n    const baseHue = hsl[0] || 0\n\n    const colors = [\n      this.baseColor,\n      this.hueToRgb(\n        this.normalizeHue(baseHue - this.analogousSpread),\n        hsl[1],\n        hsl[2]\n      ),\n      this.hueToRgb(\n        this.normalizeHue(baseHue + this.analogousSpread),\n        hsl[1],\n        hsl[2]\n      ),\n    ]\n\n    return this.formatResult('analogous', colors)\n  }\n\n  generateComplementary = (): ColorHarmonyResult => {\n    const hsl = chroma(this.baseColor).hsl()\n    const baseHue = hsl[0] || 0\n\n    const colors = [\n      this.baseColor,\n      this.hueToRgb(this.normalizeHue(baseHue + 180), hsl[1], hsl[2]),\n    ]\n\n    return this.formatResult('complementary', colors)\n  }\n\n  generateTriadic = (): ColorHarmonyResult => {\n    const hsl = chroma(this.baseColor).hsl()\n    const baseHue = hsl[0] || 0\n\n    const colors = [\n      this.baseColor,\n      this.hueToRgb(this.normalizeHue(baseHue + 120), hsl[1], hsl[2]),\n      this.hueToRgb(this.normalizeHue(baseHue + 240), hsl[1], hsl[2]),\n    ]\n\n    return this.formatResult('triadic', colors)\n  }\n\n  generateTetradic = (): ColorHarmonyResult => {\n    const hsl = chroma(this.baseColor).hsl()\n    const baseHue = hsl[0] || 0\n\n    const colors = [\n      this.baseColor,\n      this.hueToRgb(this.normalizeHue(baseHue + 90), hsl[1], hsl[2]),\n      this.hueToRgb(this.normalizeHue(baseHue + 180), hsl[1], hsl[2]),\n      this.hueToRgb(this.normalizeHue(baseHue + 270), hsl[1], hsl[2]),\n    ]\n\n    return this.formatResult('tetradic', colors)\n  }\n\n  generateSquare = (): ColorHarmonyResult => {\n    const hsl = chroma(this.baseColor).hsl()\n    const baseHue = hsl[0] || 0\n\n    const colors = [\n      this.baseColor,\n      this.hueToRgb(this.normalizeHue(baseHue + 90), hsl[1], hsl[2]),\n      this.hueToRgb(this.normalizeHue(baseHue + 180), hsl[1], hsl[2]),\n      this.hueToRgb(this.normalizeHue(baseHue + 270), hsl[1], hsl[2]),\n    ]\n\n    return this.formatResult('square', colors)\n  }\n\n  generateHarmony = (type: HarmonyType): ColorHarmonyResult => {\n    switch (type) {\n      case 'analogous':\n        return this.generateAnalogous()\n      case 'complementary':\n        return this.generateComplementary()\n      case 'triadic':\n        return this.generateTriadic()\n      case 'tetradic':\n        return this.generateTetradic()\n      case 'square':\n        return this.generateSquare()\n      default:\n        throw new Error(`Unknown harmony type: ${type}`)\n    }\n  }\n\n  getAllHarmonies = (): ColorHarmonyResult[] => {\n    return [\n      this.generateAnalogous(),\n      this.generateComplementary(),\n      this.generateTriadic(),\n      this.generateTetradic(),\n      this.generateSquare(),\n    ]\n  }\n\n  private normalizeHue = (hue: number): number => {\n    while (hue < 0) hue += 360\n    while (hue >= 360) hue -= 360\n    return hue\n  }\n\n  private hueToRgb = (\n    hue: number,\n    saturation: number,\n    lightness: number\n  ): Channel => {\n    const rgb = chroma.hsl(hue, saturation, lightness).rgb()\n    return [Math.round(rgb[0]), Math.round(rgb[1]), Math.round(rgb[2])]\n  }\n\n  private formatResult = (\n    type: HarmonyType,\n    colors: Channel[]\n  ): ColorHarmonyResult => {\n    const cleanColors = colors.map(\n      (color) =>\n        [\n          Math.round(color[0]),\n          Math.round(color[1]),\n          Math.round(color[2]),\n        ] as Channel\n    )\n\n    const hexColors = cleanColors.map(\n      (color) => chroma.rgb(color[0], color[1], color[2]).hex() as HexModel\n    )\n\n    return {\n      type,\n      baseColor: [\n        Math.round(this.baseColor[0]),\n        Math.round(this.baseColor[1]),\n        Math.round(this.baseColor[2]),\n      ],\n      baseHex: chroma\n        .rgb(this.baseColor[0], this.baseColor[1], this.baseColor[2])\n        .hex() as HexModel,\n      colors: cleanColors,\n      hexColors,\n    }\n  }\n\n  setBaseColor = (color: Channel): void => {\n    this.baseColor = color\n  }\n\n  setAnalogousSpread = (spread: number): void => {\n    this.analogousSpread = Math.max(1, Math.min(spread, 180))\n  }\n\n  updateOptions = (options: Partial<ColorHarmonyOptions>): void => {\n    if (options.analogousSpread !== undefined) {\n      this.setAnalogousSpread(options.analogousSpread)\n    }\n    if (options.returnFormat !== undefined) {\n      this.returnFormat = options.returnFormat\n    }\n  }\n\n  getOptions = (): ColorHarmonyOptions => ({\n    analogousSpread: this.analogousSpread,\n    returnFormat: this.returnFormat,\n  })\n}\n"],"names":["ColorHarmony","baseColor","analogousSpread","returnFormat","__publicField","hsl","chroma","baseHue","colors","type","hue","saturation","lightness","rgb","cleanColors","color","hexColors","spread","options"],"mappings":"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"}
+{"version":3,"file":"color-harmony.js","sources":["../../../src/modules/color-harmony/color-harmony.ts"],"sourcesContent":["import chroma from 'chroma-js'\nimport {\n  Channel,\n  HexModel,\n  HarmonyType,\n  ColorHarmonyResult,\n  ColorHarmonyOptions,\n} from '@tps/color.types'\n\nexport default class ColorHarmony {\n  private baseColor: Channel\n  private analogousSpread: number\n  private returnFormat: 'rgb' | 'hex' | 'both'\n\n  constructor({\n    baseColor = [255, 0, 0],\n    analogousSpread = 30,\n    returnFormat = 'both',\n  }: {\n    baseColor?: Channel\n  } & ColorHarmonyOptions) {\n    this.baseColor = baseColor\n    this.analogousSpread = analogousSpread\n    this.returnFormat = returnFormat\n  }\n\n  generateAnalogous = (): ColorHarmonyResult => {\n    const hsl = chroma(this.baseColor).hsl()\n    const baseHue = hsl[0] || 0\n\n    const colors = [\n      this.baseColor,\n      this.hueToRgb(\n        this.normalizeHue(baseHue - this.analogousSpread),\n        hsl[1],\n        hsl[2]\n      ),\n      this.hueToRgb(\n        this.normalizeHue(baseHue + this.analogousSpread),\n        hsl[1],\n        hsl[2]\n      ),\n    ]\n\n    return this.formatResult('ANALOGOUS', colors)\n  }\n\n  generateComplementary = (): ColorHarmonyResult => {\n    const hsl = chroma(this.baseColor).hsl()\n    const baseHue = hsl[0] || 0\n\n    const colors = [\n      this.baseColor,\n      this.hueToRgb(this.normalizeHue(baseHue + 180), hsl[1], hsl[2]),\n    ]\n\n    return this.formatResult('COMPLEMENTARY', colors)\n  }\n\n  generateTriadic = (): ColorHarmonyResult => {\n    const hsl = chroma(this.baseColor).hsl()\n    const baseHue = hsl[0] || 0\n\n    const colors = [\n      this.baseColor,\n      this.hueToRgb(this.normalizeHue(baseHue + 120), hsl[1], hsl[2]),\n      this.hueToRgb(this.normalizeHue(baseHue + 240), hsl[1], hsl[2]),\n    ]\n\n    return this.formatResult('TRIADIC', colors)\n  }\n\n  generateTetradic = (): ColorHarmonyResult => {\n    const hsl = chroma(this.baseColor).hsl()\n    const baseHue = hsl[0] || 0\n\n    const colors = [\n      this.baseColor,\n      this.hueToRgb(this.normalizeHue(baseHue + 90), hsl[1], hsl[2]),\n      this.hueToRgb(this.normalizeHue(baseHue + 180), hsl[1], hsl[2]),\n      this.hueToRgb(this.normalizeHue(baseHue + 270), hsl[1], hsl[2]),\n    ]\n\n    return this.formatResult('TETRADIC', colors)\n  }\n\n  generateSquare = (): ColorHarmonyResult => {\n    const hsl = chroma(this.baseColor).hsl()\n    const baseHue = hsl[0] || 0\n\n    const colors = [\n      this.baseColor,\n      this.hueToRgb(this.normalizeHue(baseHue + 90), hsl[1], hsl[2]),\n      this.hueToRgb(this.normalizeHue(baseHue + 180), hsl[1], hsl[2]),\n      this.hueToRgb(this.normalizeHue(baseHue + 270), hsl[1], hsl[2]),\n    ]\n\n    return this.formatResult('SQUARE', colors)\n  }\n\n  generateCompound = (): ColorHarmonyResult => {\n    const hsl = chroma(this.baseColor).hsl()\n    const baseHue = hsl[0] || 0\n    const complementaryHue = this.normalizeHue(baseHue + 180)\n\n    const colors = [\n      this.baseColor,\n      this.hueToRgb(this.normalizeHue(complementaryHue - 30), hsl[1], hsl[2]),\n      this.hueToRgb(this.normalizeHue(complementaryHue + 30), hsl[1], hsl[2]),\n    ]\n\n    return this.formatResult('COMPOUND', colors)\n  }\n\n  generateHarmony = (type: HarmonyType): ColorHarmonyResult => {\n    switch (type) {\n      case 'ANALOGOUS':\n        return this.generateAnalogous()\n      case 'COMPLEMENTARY':\n        return this.generateComplementary()\n      case 'TRIADIC':\n        return this.generateTriadic()\n      case 'TETRADIC':\n        return this.generateTetradic()\n      case 'SQUARE':\n        return this.generateSquare()\n      case 'COMPOUND':\n        return this.generateCompound()\n      default:\n        throw new Error(`Unknown harmony type: ${type}`)\n    }\n  }\n\n  getAllHarmonies = (): ColorHarmonyResult[] => {\n    return [\n      this.generateAnalogous(),\n      this.generateComplementary(),\n      this.generateTriadic(),\n      this.generateTetradic(),\n      this.generateSquare(),\n      this.generateCompound(),\n    ]\n  }\n\n  private normalizeHue = (hue: number): number => {\n    while (hue < 0) hue += 360\n    while (hue >= 360) hue -= 360\n    return hue\n  }\n\n  private hueToRgb = (\n    hue: number,\n    saturation: number,\n    lightness: number\n  ): Channel => {\n    const rgb = chroma.hsl(hue, saturation, lightness).rgb()\n    return [Math.round(rgb[0]), Math.round(rgb[1]), Math.round(rgb[2])]\n  }\n\n  private formatResult = (\n    type: HarmonyType,\n    colors: Channel[]\n  ): ColorHarmonyResult => {\n    const cleanColors = colors.map(\n      (color) =>\n        [\n          Math.round(color[0]),\n          Math.round(color[1]),\n          Math.round(color[2]),\n        ] as Channel\n    )\n\n    const hexColors = cleanColors.map(\n      (color) => chroma.rgb(color[0], color[1], color[2]).hex() as HexModel\n    )\n\n    return {\n      type,\n      baseColor: [\n        Math.round(this.baseColor[0]),\n        Math.round(this.baseColor[1]),\n        Math.round(this.baseColor[2]),\n      ],\n      baseHex: chroma\n        .rgb(this.baseColor[0], this.baseColor[1], this.baseColor[2])\n        .hex() as HexModel,\n      colors: cleanColors,\n      hexColors,\n    }\n  }\n\n  setBaseColor = (color: Channel): void => {\n    this.baseColor = color\n  }\n\n  setAnalogousSpread = (spread: number): void => {\n    this.analogousSpread = Math.max(1, Math.min(spread, 180))\n  }\n\n  updateOptions = (options: Partial<ColorHarmonyOptions>): void => {\n    if (options.analogousSpread !== undefined) {\n      this.setAnalogousSpread(options.analogousSpread)\n    }\n    if (options.returnFormat !== undefined) {\n      this.returnFormat = options.returnFormat\n    }\n  }\n\n  getOptions = (): ColorHarmonyOptions => ({\n    analogousSpread: this.analogousSpread,\n    returnFormat: this.returnFormat,\n  })\n}\n"],"names":["ColorHarmony","baseColor","analogousSpread","returnFormat","__publicField","hsl","chroma","baseHue","colors","complementaryHue","type","hue","saturation","lightness","rgb","cleanColors","color","hexColors","spread","options"],"mappings":"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"}

package/dist/modules/dominant-colors/dominant-colors.d.ts

@@ -1,15 +1,25 @@
 import { ImageData, DominantColorResult, DominantColorsOptions } from '../../types/color.types';
 
+interface DominantColorsInput extends DominantColorsOptions {
+    imageData?: ImageData;
+    arrayBuffer?: ArrayBuffer;
+    maxImageSize?: number;
+}
 export default class DominantColors {
     private imageData;
     private colorCount;
     private maxIterations;
     private tolerance;
     private skipTransparent;
-    constructor({ imageData, colorCount, maxIterations, tolerance, skipTransparent, }: {
-        imageData: ImageData;
-    } & DominantColorsOptions);
+    private maxImageSize;
+    constructor({ imageData, arrayBuffer, colorCount, maxIterations, tolerance, skipTransparent, maxImageSize, }: DominantColorsInput);
+    private arrayBuffer?;
+    private ensureImageData;
+    private decodeImageFromArrayBuffer;
+    /** Synchronous extraction for ImageData (backward compatibility) */
     extractDominantColors: () => DominantColorResult[];
+    /** Asynchronous extraction for ArrayBuffer */
+    extractDominantColorsAsync: () => Promise<DominantColorResult[]>;
     private extractPixels;
     private performKMeans;
     private initializeCentroids;
@@ -21,5 +31,10 @@ export default class DominantColors {
     setColorCount: (count: number) => void;
     updateOptions: (options: Partial<DominantColorsOptions>) => void;
     getOptions: () => DominantColorsOptions;
+    /** Static method for simplified ArrayBuffer usage */
+    static fromArrayBuffer(arrayBuffer: ArrayBuffer, options?: Omit<DominantColorsInput, 'arrayBuffer' | 'imageData'>): Promise<DominantColorResult[]>;
+    /** Simplified static method for quick color extraction */
+    static extract(arrayBuffer: ArrayBuffer, colorCount?: number): Promise<DominantColorResult[]>;
 }
+export {};
 //# sourceMappingURL=dominant-colors.d.ts.map

package/dist/modules/dominant-colors/dominant-colors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"dominant-colors.d.ts","sourceRoot":"","sources":["../../../src/modules/dominant-colors/dominant-colors.ts"],"names":[],"mappings":"AACA,OAAO,EAGL,SAAS,EACT,mBAAmB,EACnB,qBAAqB,EACtB,MAAM,kBAAkB,CAAA;AAEzB,MAAM,CAAC,OAAO,OAAO,cAAc;IACjC,OAAO,CAAC,SAAS,CAAW;IAC5B,OAAO,CAAC,UAAU,CAAQ;IAC1B,OAAO,CAAC,aAAa,CAAQ;IAC7B,OAAO,CAAC,SAAS,CAAQ;IACzB,OAAO,CAAC,eAAe,CAAS;gBAEpB,EACV,SAAS,EACT,UAAc,EACd,aAAkB,EAClB,SAAgB,EAChB,eAAsB,GACvB,EAAE;QACD,SAAS,EAAE,SAAS,CAAA;KACrB,GAAG,qBAAqB;IAQzB,qBAAqB,QAAO,mBAAmB,EAAE,CAQhD;IAED,OAAO,CAAC,aAAa,CAgBpB;IAED,OAAO,CAAC,aAAa,CA+BpB;IAED,OAAO,CAAC,mBAAmB,CA8B1B;IAED,OAAO,CAAC,mBAAmB,CAgB1B;IAED,OAAO,CAAC,iBAAiB,CAOxB;IAED,OAAO,CAAC,iBAAiB,CAWxB;IAED,OAAO,CAAC,YAAY,CAUnB;IAED,OAAO,CAAC,yBAAyB,CAmBhC;IAED,aAAa,UAAW,MAAM,KAAG,IAAI,CAEpC;IAED,aAAa,YAAa,OAAO,CAAC,qBAAqB,CAAC,KAAG,IAAI,CAO9D;IAED,UAAU,QAAO,qBAAqB,CAKpC;CACH"}
+{"version":3,"file":"dominant-colors.d.ts","sourceRoot":"","sources":["../../../src/modules/dominant-colors/dominant-colors.ts"],"names":[],"mappings":"AACA,OAAO,EAGL,SAAS,EACT,mBAAmB,EACnB,qBAAqB,EACtB,MAAM,kBAAkB,CAAA;AAEzB,UAAU,mBAAoB,SAAQ,qBAAqB;IACzD,SAAS,CAAC,EAAE,SAAS,CAAA;IACrB,WAAW,CAAC,EAAE,WAAW,CAAA;IACzB,YAAY,CAAC,EAAE,MAAM,CAAA;CACtB;AAED,MAAM,CAAC,OAAO,OAAO,cAAc;IACjC,OAAO,CAAC,SAAS,CAAyB;IAC1C,OAAO,CAAC,UAAU,CAAQ;IAC1B,OAAO,CAAC,aAAa,CAAQ;IAC7B,OAAO,CAAC,SAAS,CAAQ;IACzB,OAAO,CAAC,eAAe,CAAS;IAChC,OAAO,CAAC,YAAY,CAAQ;gBAEhB,EACV,SAAS,EACT,WAAW,EACX,UAAc,EACd,aAAkB,EAClB,SAAgB,EAChB,eAAsB,EACtB,YAAkB,GACnB,EAAE,mBAAmB;IAiBtB,OAAO,CAAC,WAAW,CAAC,CAAa;YAEnB,eAAe;YAMf,0BAA0B;IA2ExC,oEAAoE;IACpE,qBAAqB,QAAO,mBAAmB,EAAE,CAchD;IAED,8CAA8C;IAC9C,0BAA0B,QAAa,OAAO,CAAC,mBAAmB,EAAE,CAAC,CAgBpE;IAED,OAAO,CAAC,aAAa,CAoBpB;IAED,OAAO,CAAC,aAAa,CA+BpB;IAED,OAAO,CAAC,mBAAmB,CA8B1B;IAED,OAAO,CAAC,mBAAmB,CAgB1B;IAED,OAAO,CAAC,iBAAiB,CAOxB;IAED,OAAO,CAAC,iBAAiB,CAWxB;IAED,OAAO,CAAC,YAAY,CAUnB;IAED,OAAO,CAAC,yBAAyB,CAmBhC;IAED,aAAa,UAAW,MAAM,KAAG,IAAI,CAEpC;IAED,aAAa,YAAa,OAAO,CAAC,qBAAqB,CAAC,KAAG,IAAI,CAO9D;IAED,UAAU,QAAO,qBAAqB,CAKpC;IAEF,qDAAqD;WACxC,eAAe,CAC1B,WAAW,EAAE,WAAW,EACxB,OAAO,GAAE,IAAI,CAAC,mBAAmB,EAAE,aAAa,GAAG,WAAW,CAAM,GACnE,OAAO,CAAC,mBAAmB,EAAE,CAAC;IASjC,0DAA0D;WAC7C,OAAO,CAClB,WAAW,EAAE,WAAW,EACxB,UAAU,GAAE,MAAU,GACrB,OAAO,CAAC,mBAAmB,EAAE,CAAC;CAGlC"}

package/dist/modules/dominant-colors/dominant-colors.js

@@ -1,86 +1,108 @@
-var d = Object.defineProperty;
-var m = (l, t, e) => t in l ? d(l, t, { enumerable: !0, configurable: !0, writable: !0, value: e }) : l[t] = e;
-var o = (l, t, e) => m(l, typeof t != "symbol" ? t + "" : t, e);
-import { c as f } from "../../index-Beb8qoyd.js";
-class p {
+var C = Object.defineProperty;
+var x = (l, t, e) => t in l ? C(l, t, { enumerable: !0, configurable: !0, writable: !0, value: e }) : l[t] = e;
+var i = (l, t, e) => x(l, typeof t != "symbol" ? t + "" : t, e);
+import { c as p } from "../../index-Beb8qoyd.js";
+class f {
   constructor({
     imageData: t,
-    colorCount: e = 5,
-    maxIterations: n = 50,
-    tolerance: a = 0.01,
-    skipTransparent: r = !0
+    arrayBuffer: e,
+    colorCount: a = 5,
+    maxIterations: r = 50,
+    tolerance: s = 0.01,
+    skipTransparent: n = !0,
+    maxImageSize: o = 200
   }) {
-    o(this, "imageData");
-    o(this, "colorCount");
-    o(this, "maxIterations");
-    o(this, "tolerance");
-    o(this, "skipTransparent");
-    o(this, "extractDominantColors", () => {
+    i(this, "imageData", null);
+    i(this, "colorCount");
+    i(this, "maxIterations");
+    i(this, "tolerance");
+    i(this, "skipTransparent");
+    i(this, "maxImageSize");
+    i(this, "arrayBuffer");
+    /** Synchronous extraction for ImageData (backward compatibility) */
+    i(this, "extractDominantColors", () => {
+      if (!this.imageData)
+        throw new Error(
+          "No image data available. Use extractDominantColorsAsync() for ArrayBuffer."
+        );
+      const t = this.extractPixels();
+      if (t.length === 0) return [];
+      const e = this.performKMeans(t);
+      return this.calculateColorFrequencies(t, e).sort((r, s) => s.percentage - r.percentage);
+    });
+    /** Asynchronous extraction for ArrayBuffer */
+    i(this, "extractDominantColorsAsync", async () => {
+      if (await this.ensureImageData(), !this.imageData)
+        throw new Error(
+          "No image data available. Ensure ArrayBuffer was successfully decoded."
+        );
       const t = this.extractPixels();
       if (t.length === 0) return [];
       const e = this.performKMeans(t);
-      return this.calculateColorFrequencies(t, e).sort((a, r) => r.percentage - a.percentage);
+      return this.calculateColorFrequencies(t, e).sort((r, s) => s.percentage - r.percentage);
     });
-    o(this, "extractPixels", () => {
+    i(this, "extractPixels", () => {
+      if (!this.imageData)
+        throw new Error("No image data available");
       const t = [], e = this.imageData.data;
-      for (let n = 0; n < e.length; n += 4) {
-        const a = e[n], r = e[n + 1], s = e[n + 2], i = e[n + 3];
-        this.skipTransparent && i < 128 || t.push([a, r, s]);
+      for (let a = 0; a < e.length; a += 4) {
+        const r = e[a], s = e[a + 1], n = e[a + 2], o = e[a + 3];
+        this.skipTransparent && o < 128 || t.push([r, s, n]);
       }
       return t;
     });
-    o(this, "performKMeans", (t) => {
-      let e = this.initializeCentroids(t), n = [], a = 0;
-      for (; a < this.maxIterations && !this.hasConverged(e, n); ) {
-        n = e.map((s) => [...s]);
-        const r = Array.from(
+    i(this, "performKMeans", (t) => {
+      let e = this.initializeCentroids(t), a = [], r = 0;
+      for (; r < this.maxIterations && !this.hasConverged(e, a); ) {
+        a = e.map((n) => [...n]);
+        const s = Array.from(
           { length: this.colorCount },
           () => []
         );
-        t.forEach((s) => {
-          const i = this.findClosestCentroid(s, e);
-          r[i].push(s);
-        }), e = r.map((s) => s.length === 0 ? n[e.indexOf(e[0])] : this.calculateCentroid(s)), a++;
+        t.forEach((n) => {
+          const o = this.findClosestCentroid(n, e);
+          s[o].push(n);
+        }), e = s.map((n) => n.length === 0 ? a[e.indexOf(e[0])] : this.calculateCentroid(n)), r++;
       }
       return e;
     });
-    o(this, "initializeCentroids", (t) => {
+    i(this, "initializeCentroids", (t) => {
       const e = [];
       e.push(t[Math.floor(Math.random() * t.length)]);
-      for (let n = 1; n < this.colorCount; n++) {
-        const a = t.map((c) => {
+      for (let a = 1; a < this.colorCount; a++) {
+        const r = t.map((c) => {
           const h = Math.min(
             ...e.map(
-              (u) => this.calculateDistance(c, u)
+              (d) => this.calculateDistance(c, d)
             )
           );
           return h * h;
-        }), r = a.reduce((c, h) => c + h, 0), s = Math.random() * r;
-        let i = 0;
+        }), s = r.reduce((c, h) => c + h, 0), n = Math.random() * s;
+        let o = 0;
         for (let c = 0; c < t.length; c++)
-          if (i += a[c], i >= s) {
+          if (o += r[c], o >= n) {
             e.push(t[c]);
             break;
           }
       }
       return e;
     });
-    o(this, "findClosestCentroid", (t, e) => {
-      let n = 1 / 0, a = 0;
-      return e.forEach((r, s) => {
-        const i = this.calculateDistance(t, r);
-        i < n && (n = i, a = s);
-      }), a;
+    i(this, "findClosestCentroid", (t, e) => {
+      let a = 1 / 0, r = 0;
+      return e.forEach((s, n) => {
+        const o = this.calculateDistance(t, s);
+        o < a && (a = o, r = n);
+      }), r;
     });
-    o(this, "calculateDistance", (t, e) => {
-      const [n, a, r] = t, [s, i, c] = e;
+    i(this, "calculateDistance", (t, e) => {
+      const [a, r, s] = t, [n, o, c] = e;
       return Math.sqrt(
-        Math.pow(n - s, 2) + Math.pow(a - i, 2) + Math.pow(r - c, 2)
+        Math.pow(a - n, 2) + Math.pow(r - o, 2) + Math.pow(s - c, 2)
       );
     });
-    o(this, "calculateCentroid", (t) => {
+    i(this, "calculateCentroid", (t) => {
       const e = t.reduce(
-        (n, a) => [n[0] + a[0], n[1] + a[1], n[2] + a[2]],
+        (a, r) => [a[0] + r[0], a[1] + r[1], a[2] + r[2]],
         [0, 0, 0]
       );
       return [
@@ -89,37 +111,88 @@ class p {
         Math.round(e[2] / t.length)
       ];
     });
-    o(this, "hasConverged", (t, e) => e.length === 0 ? !1 : t.every((n, a) => this.calculateDistance(n, e[a]) < this.tolerance));
-    o(this, "calculateColorFrequencies", (t, e) => {
-      const n = new Array(e.length).fill(0);
-      t.forEach((r) => {
-        const s = this.findClosestCentroid(r, e);
-        n[s]++;
+    i(this, "hasConverged", (t, e) => e.length === 0 ? !1 : t.every((a, r) => this.calculateDistance(a, e[r]) < this.tolerance));
+    i(this, "calculateColorFrequencies", (t, e) => {
+      const a = new Array(e.length).fill(0);
+      t.forEach((s) => {
+        const n = this.findClosestCentroid(s, e);
+        a[n]++;
       });
-      const a = t.length;
-      return e.map((r, s) => ({
-        color: r,
-        hex: f.rgb(r[0], r[1], r[2]).hex(),
-        count: n[s],
-        percentage: parseFloat((n[s] / a * 100).toFixed(2))
+      const r = t.length;
+      return e.map((s, n) => ({
+        color: s,
+        hex: p.rgb(s[0], s[1], s[2]).hex(),
+        count: a[n],
+        percentage: parseFloat((a[n] / r * 100).toFixed(2))
       }));
     });
-    o(this, "setColorCount", (t) => {
+    i(this, "setColorCount", (t) => {
       this.colorCount = Math.max(1, Math.min(t, 20));
     });
-    o(this, "updateOptions", (t) => {
+    i(this, "updateOptions", (t) => {
       t.colorCount !== void 0 && this.setColorCount(t.colorCount), t.maxIterations !== void 0 && (this.maxIterations = t.maxIterations), t.tolerance !== void 0 && (this.tolerance = t.tolerance), t.skipTransparent !== void 0 && (this.skipTransparent = t.skipTransparent);
     });
-    o(this, "getOptions", () => ({
+    i(this, "getOptions", () => ({
       colorCount: this.colorCount,
       maxIterations: this.maxIterations,
       tolerance: this.tolerance,
       skipTransparent: this.skipTransparent
     }));
-    this.imageData = t, this.colorCount = e, this.maxIterations = n, this.tolerance = a, this.skipTransparent = r;
+    if (!t && !e)
+      throw new Error("Either imageData or arrayBuffer must be provided");
+    this.imageData = t || null, this.colorCount = a, this.maxIterations = r, this.tolerance = s, this.skipTransparent = n, this.maxImageSize = o, e && !t && (this.arrayBuffer = e);
+  }
+  async ensureImageData() {
+    !this.imageData && this.arrayBuffer && (this.imageData = await this.decodeImageFromArrayBuffer(this.arrayBuffer));
+  }
+  async decodeImageFromArrayBuffer(t) {
+    return new Promise((e, a) => {
+      const r = globalThis;
+      if (!r.document || !r.Image || !r.URL) {
+        a(new Error("Browser environment with Canvas API required"));
+        return;
+      }
+      const s = new r.Blob([t]), n = r.URL.createObjectURL(s), o = new r.Image();
+      o.onload = () => {
+        try {
+          const c = r.document.createElement("canvas"), h = c.getContext("2d");
+          if (!h)
+            throw new Error("Failed to create canvas context");
+          const d = o.width / o.height;
+          let u = o.width, m = o.height;
+          Math.max(o.width, o.height) > this.maxImageSize && (o.width > o.height ? (u = this.maxImageSize, m = Math.round(this.maxImageSize / d)) : (m = this.maxImageSize, u = Math.round(this.maxImageSize * d))), c.width = u, c.height = m, h.drawImage(o, 0, 0, u, m);
+          const g = h.getImageData(
+            0,
+            0,
+            u,
+            m
+          ), w = {
+            data: new Uint8ClampedArray(g.data),
+            width: g.width,
+            height: g.height
+          };
+          r.URL.revokeObjectURL(n), e(w);
+        } catch (c) {
+          r.URL.revokeObjectURL(n), a(c);
+        }
+      }, o.onerror = () => {
+        r.URL.revokeObjectURL(n), a(new Error("Failed to load image"));
+      }, o.src = n;
+    });
+  }
+  /** Static method for simplified ArrayBuffer usage */
+  static async fromArrayBuffer(t, e = {}) {
+    return new f({
+      arrayBuffer: t,
+      ...e
+    }).extractDominantColorsAsync();
+  }
+  /** Simplified static method for quick color extraction */
+  static async extract(t, e = 5) {
+    return this.fromArrayBuffer(t, { colorCount: e });
   }
 }
 export {
-  p as default
+  f as default
 };
 //# sourceMappingURL=dominant-colors.js.map

package/dist/modules/dominant-colors/dominant-colors.js.map

@@ -1 +1 @@
-{"version":3,"file":"dominant-colors.js","sources":["../../../src/modules/dominant-colors/dominant-colors.ts"],"sourcesContent":["import chroma from 'chroma-js'\nimport {\n  Channel,\n  HexModel,\n  ImageData,\n  DominantColorResult,\n  DominantColorsOptions,\n} from '@tps/color.types'\n\nexport default class DominantColors {\n  private imageData: ImageData\n  private colorCount: number\n  private maxIterations: number\n  private tolerance: number\n  private skipTransparent: boolean\n\n  constructor({\n    imageData,\n    colorCount = 5,\n    maxIterations = 50,\n    tolerance = 0.01,\n    skipTransparent = true,\n  }: {\n    imageData: ImageData\n  } & DominantColorsOptions) {\n    this.imageData = imageData\n    this.colorCount = colorCount\n    this.maxIterations = maxIterations\n    this.tolerance = tolerance\n    this.skipTransparent = skipTransparent\n  }\n\n  extractDominantColors = (): DominantColorResult[] => {\n    const pixels = this.extractPixels()\n    if (pixels.length === 0) return []\n\n    const clusters = this.performKMeans(pixels)\n    const results = this.calculateColorFrequencies(pixels, clusters)\n\n    return results.sort((a, b) => b.percentage - a.percentage)\n  }\n\n  private extractPixels = (): Channel[] => {\n    const pixels: Channel[] = []\n    const data = this.imageData.data\n\n    for (let i = 0; i < data.length; i += 4) {\n      const r = data[i]\n      const g = data[i + 1]\n      const b = data[i + 2]\n      const a = data[i + 3]\n\n      if (this.skipTransparent && a < 128) continue\n\n      pixels.push([r, g, b])\n    }\n\n    return pixels\n  }\n\n  private performKMeans = (pixels: Channel[]): Channel[] => {\n    let centroids = this.initializeCentroids(pixels)\n    let prevCentroids: Channel[] = []\n    let iteration = 0\n\n    while (\n      iteration < this.maxIterations &&\n      !this.hasConverged(centroids, prevCentroids)\n    ) {\n      prevCentroids = centroids.map((c) => [...c] as Channel)\n\n      const clusters: Channel[][] = Array.from(\n        { length: this.colorCount },\n        () => []\n      )\n\n      pixels.forEach((pixel) => {\n        const closestIndex = this.findClosestCentroid(pixel, centroids)\n        clusters[closestIndex].push(pixel)\n      })\n\n      centroids = clusters.map((cluster) => {\n        if (cluster.length === 0)\n          return prevCentroids[centroids.indexOf(centroids[0])]\n        return this.calculateCentroid(cluster)\n      })\n\n      iteration++\n    }\n\n    return centroids\n  }\n\n  private initializeCentroids = (pixels: Channel[]): Channel[] => {\n    const centroids: Channel[] = []\n\n    // K-means++ initialization\n    centroids.push(pixels[Math.floor(Math.random() * pixels.length)])\n\n    for (let i = 1; i < this.colorCount; i++) {\n      const distances = pixels.map((pixel) => {\n        const minDistance = Math.min(\n          ...centroids.map((centroid) =>\n            this.calculateDistance(pixel, centroid)\n          )\n        )\n        return minDistance * minDistance\n      })\n\n      const totalDistance = distances.reduce((sum, d) => sum + d, 0)\n      const threshold = Math.random() * totalDistance\n\n      let cumulative = 0\n      for (let j = 0; j < pixels.length; j++) {\n        cumulative += distances[j]\n        if (cumulative >= threshold) {\n          centroids.push(pixels[j])\n          break\n        }\n      }\n    }\n\n    return centroids\n  }\n\n  private findClosestCentroid = (\n    pixel: Channel,\n    centroids: Channel[]\n  ): number => {\n    let minDistance = Infinity\n    let closestIndex = 0\n\n    centroids.forEach((centroid, index) => {\n      const distance = this.calculateDistance(pixel, centroid)\n      if (distance < minDistance) {\n        minDistance = distance\n        closestIndex = index\n      }\n    })\n\n    return closestIndex\n  }\n\n  private calculateDistance = (color1: Channel, color2: Channel): number => {\n    const [r1, g1, b1] = color1\n    const [r2, g2, b2] = color2\n\n    return Math.sqrt(\n      Math.pow(r1 - r2, 2) + Math.pow(g1 - g2, 2) + Math.pow(b1 - b2, 2)\n    )\n  }\n\n  private calculateCentroid = (cluster: Channel[]): Channel => {\n    const sum = cluster.reduce(\n      (acc, pixel) => [acc[0] + pixel[0], acc[1] + pixel[1], acc[2] + pixel[2]],\n      [0, 0, 0] as Channel\n    )\n\n    return [\n      Math.round(sum[0] / cluster.length),\n      Math.round(sum[1] / cluster.length),\n      Math.round(sum[2] / cluster.length),\n    ]\n  }\n\n  private hasConverged = (\n    centroids: Channel[],\n    prevCentroids: Channel[]\n  ): boolean => {\n    if (prevCentroids.length === 0) return false\n\n    return centroids.every((centroid, index) => {\n      const distance = this.calculateDistance(centroid, prevCentroids[index])\n      return distance < this.tolerance\n    })\n  }\n\n  private calculateColorFrequencies = (\n    pixels: Channel[],\n    centroids: Channel[]\n  ): DominantColorResult[] => {\n    const counts = new Array(centroids.length).fill(0)\n\n    pixels.forEach((pixel) => {\n      const closestIndex = this.findClosestCentroid(pixel, centroids)\n      counts[closestIndex]++\n    })\n\n    const totalPixels = pixels.length\n\n    return centroids.map((centroid, index) => ({\n      color: centroid,\n      hex: chroma.rgb(centroid[0], centroid[1], centroid[2]).hex() as HexModel,\n      count: counts[index],\n      percentage: parseFloat(((counts[index] / totalPixels) * 100).toFixed(2)),\n    }))\n  }\n\n  setColorCount = (count: number): void => {\n    this.colorCount = Math.max(1, Math.min(count, 20))\n  }\n\n  updateOptions = (options: Partial<DominantColorsOptions>): void => {\n    if (options.colorCount !== undefined) this.setColorCount(options.colorCount)\n    if (options.maxIterations !== undefined)\n      this.maxIterations = options.maxIterations\n    if (options.tolerance !== undefined) this.tolerance = options.tolerance\n    if (options.skipTransparent !== undefined)\n      this.skipTransparent = options.skipTransparent\n  }\n\n  getOptions = (): DominantColorsOptions => ({\n    colorCount: this.colorCount,\n    maxIterations: this.maxIterations,\n    tolerance: this.tolerance,\n    skipTransparent: this.skipTransparent,\n  })\n}\n"],"names":["DominantColors","imageData","colorCount","maxIterations","tolerance","skipTransparent","__publicField","pixels","clusters","b","data","i","r","g","a","centroids","prevCentroids","iteration","c","pixel","closestIndex","cluster","distances","minDistance","centroid","totalDistance","sum","d","threshold","cumulative","j","index","distance","color1","color2","r1","g1","b1","r2","g2","b2","acc","counts","totalPixels","chroma","count","options"],"mappings":"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"}
+{"version":3,"file":"dominant-colors.js","sources":["../../../src/modules/dominant-colors/dominant-colors.ts"],"sourcesContent":["import chroma from 'chroma-js'\nimport {\n  Channel,\n  HexModel,\n  ImageData,\n  DominantColorResult,\n  DominantColorsOptions,\n} from '@tps/color.types'\n\ninterface DominantColorsInput extends DominantColorsOptions {\n  imageData?: ImageData\n  arrayBuffer?: ArrayBuffer\n  maxImageSize?: number\n}\n\nexport default class DominantColors {\n  private imageData: ImageData | null = null\n  private colorCount: number\n  private maxIterations: number\n  private tolerance: number\n  private skipTransparent: boolean\n  private maxImageSize: number\n\n  constructor({\n    imageData,\n    arrayBuffer,\n    colorCount = 5,\n    maxIterations = 50,\n    tolerance = 0.01,\n    skipTransparent = true,\n    maxImageSize = 200,\n  }: DominantColorsInput) {\n    if (!imageData && !arrayBuffer) {\n      throw new Error('Either imageData or arrayBuffer must be provided')\n    }\n\n    this.imageData = imageData || null\n    this.colorCount = colorCount\n    this.maxIterations = maxIterations\n    this.tolerance = tolerance\n    this.skipTransparent = skipTransparent\n    this.maxImageSize = maxImageSize\n\n    if (arrayBuffer && !imageData) {\n      this.arrayBuffer = arrayBuffer\n    }\n  }\n\n  private arrayBuffer?: ArrayBuffer\n\n  private async ensureImageData(): Promise<void> {\n    if (!this.imageData && this.arrayBuffer) {\n      this.imageData = await this.decodeImageFromArrayBuffer(this.arrayBuffer)\n    }\n  }\n\n  private async decodeImageFromArrayBuffer(\n    arrayBuffer: ArrayBuffer\n  ): Promise<ImageData> {\n    return new Promise((resolve, reject) => {\n      // eslint-disable-next-line @typescript-eslint/no-explicit-any\n      const globalWindow = globalThis as any\n\n      if (!globalWindow.document || !globalWindow.Image || !globalWindow.URL) {\n        reject(new Error('Browser environment with Canvas API required'))\n        return\n      }\n\n      const blob = new globalWindow.Blob([arrayBuffer])\n      const url = globalWindow.URL.createObjectURL(blob)\n      const img = new globalWindow.Image()\n\n      img.onload = () => {\n        try {\n          const canvas = globalWindow.document.createElement('canvas')\n          const ctx = canvas.getContext('2d')\n\n          if (!ctx) {\n            throw new Error('Failed to create canvas context')\n          }\n\n          // Resize image if needed\n          const aspectRatio = img.width / img.height\n          let targetWidth = img.width\n          let targetHeight = img.height\n\n          if (Math.max(img.width, img.height) > this.maxImageSize) {\n            if (img.width > img.height) {\n              targetWidth = this.maxImageSize\n              targetHeight = Math.round(this.maxImageSize / aspectRatio)\n            } else {\n              targetHeight = this.maxImageSize\n              targetWidth = Math.round(this.maxImageSize * aspectRatio)\n            }\n          }\n\n          canvas.width = targetWidth\n          canvas.height = targetHeight\n\n          ctx.drawImage(img, 0, 0, targetWidth, targetHeight)\n\n          const browserImageData = ctx.getImageData(\n            0,\n            0,\n            targetWidth,\n            targetHeight\n          )\n\n          const imageData: ImageData = {\n            data: new Uint8ClampedArray(browserImageData.data),\n            width: browserImageData.width,\n            height: browserImageData.height,\n          }\n\n          globalWindow.URL.revokeObjectURL(url)\n          resolve(imageData)\n        } catch (error) {\n          globalWindow.URL.revokeObjectURL(url)\n          reject(error)\n        }\n      }\n\n      img.onerror = () => {\n        globalWindow.URL.revokeObjectURL(url)\n        reject(new Error('Failed to load image'))\n      }\n\n      img.src = url\n    })\n  }\n\n  /** Synchronous extraction for ImageData (backward compatibility) */\n  extractDominantColors = (): DominantColorResult[] => {\n    if (!this.imageData) {\n      throw new Error(\n        'No image data available. Use extractDominantColorsAsync() for ArrayBuffer.'\n      )\n    }\n\n    const pixels = this.extractPixels()\n    if (pixels.length === 0) return []\n\n    const clusters = this.performKMeans(pixels)\n    const results = this.calculateColorFrequencies(pixels, clusters)\n\n    return results.sort((a, b) => b.percentage - a.percentage)\n  }\n\n  /** Asynchronous extraction for ArrayBuffer */\n  extractDominantColorsAsync = async (): Promise<DominantColorResult[]> => {\n    await this.ensureImageData()\n\n    if (!this.imageData) {\n      throw new Error(\n        'No image data available. Ensure ArrayBuffer was successfully decoded.'\n      )\n    }\n\n    const pixels = this.extractPixels()\n    if (pixels.length === 0) return []\n\n    const clusters = this.performKMeans(pixels)\n    const results = this.calculateColorFrequencies(pixels, clusters)\n\n    return results.sort((a, b) => b.percentage - a.percentage)\n  }\n\n  private extractPixels = (): Channel[] => {\n    if (!this.imageData) {\n      throw new Error('No image data available')\n    }\n\n    const pixels: Channel[] = []\n    const data = this.imageData.data\n\n    for (let i = 0; i < data.length; i += 4) {\n      const r = data[i]\n      const g = data[i + 1]\n      const b = data[i + 2]\n      const a = data[i + 3]\n\n      if (this.skipTransparent && a < 128) continue\n\n      pixels.push([r, g, b])\n    }\n\n    return pixels\n  }\n\n  private performKMeans = (pixels: Channel[]): Channel[] => {\n    let centroids = this.initializeCentroids(pixels)\n    let prevCentroids: Channel[] = []\n    let iteration = 0\n\n    while (\n      iteration < this.maxIterations &&\n      !this.hasConverged(centroids, prevCentroids)\n    ) {\n      prevCentroids = centroids.map((c) => [...c] as Channel)\n\n      const clusters: Channel[][] = Array.from(\n        { length: this.colorCount },\n        () => []\n      )\n\n      pixels.forEach((pixel) => {\n        const closestIndex = this.findClosestCentroid(pixel, centroids)\n        clusters[closestIndex].push(pixel)\n      })\n\n      centroids = clusters.map((cluster) => {\n        if (cluster.length === 0)\n          return prevCentroids[centroids.indexOf(centroids[0])]\n        return this.calculateCentroid(cluster)\n      })\n\n      iteration++\n    }\n\n    return centroids\n  }\n\n  private initializeCentroids = (pixels: Channel[]): Channel[] => {\n    const centroids: Channel[] = []\n\n    // K-means++ initialization\n    centroids.push(pixels[Math.floor(Math.random() * pixels.length)])\n\n    for (let i = 1; i < this.colorCount; i++) {\n      const distances = pixels.map((pixel) => {\n        const minDistance = Math.min(\n          ...centroids.map((centroid) =>\n            this.calculateDistance(pixel, centroid)\n          )\n        )\n        return minDistance * minDistance\n      })\n\n      const totalDistance = distances.reduce((sum, d) => sum + d, 0)\n      const threshold = Math.random() * totalDistance\n\n      let cumulative = 0\n      for (let j = 0; j < pixels.length; j++) {\n        cumulative += distances[j]\n        if (cumulative >= threshold) {\n          centroids.push(pixels[j])\n          break\n        }\n      }\n    }\n\n    return centroids\n  }\n\n  private findClosestCentroid = (\n    pixel: Channel,\n    centroids: Channel[]\n  ): number => {\n    let minDistance = Infinity\n    let closestIndex = 0\n\n    centroids.forEach((centroid, index) => {\n      const distance = this.calculateDistance(pixel, centroid)\n      if (distance < minDistance) {\n        minDistance = distance\n        closestIndex = index\n      }\n    })\n\n    return closestIndex\n  }\n\n  private calculateDistance = (color1: Channel, color2: Channel): number => {\n    const [r1, g1, b1] = color1\n    const [r2, g2, b2] = color2\n\n    return Math.sqrt(\n      Math.pow(r1 - r2, 2) + Math.pow(g1 - g2, 2) + Math.pow(b1 - b2, 2)\n    )\n  }\n\n  private calculateCentroid = (cluster: Channel[]): Channel => {\n    const sum = cluster.reduce(\n      (acc, pixel) => [acc[0] + pixel[0], acc[1] + pixel[1], acc[2] + pixel[2]],\n      [0, 0, 0] as Channel\n    )\n\n    return [\n      Math.round(sum[0] / cluster.length),\n      Math.round(sum[1] / cluster.length),\n      Math.round(sum[2] / cluster.length),\n    ]\n  }\n\n  private hasConverged = (\n    centroids: Channel[],\n    prevCentroids: Channel[]\n  ): boolean => {\n    if (prevCentroids.length === 0) return false\n\n    return centroids.every((centroid, index) => {\n      const distance = this.calculateDistance(centroid, prevCentroids[index])\n      return distance < this.tolerance\n    })\n  }\n\n  private calculateColorFrequencies = (\n    pixels: Channel[],\n    centroids: Channel[]\n  ): DominantColorResult[] => {\n    const counts = new Array(centroids.length).fill(0)\n\n    pixels.forEach((pixel) => {\n      const closestIndex = this.findClosestCentroid(pixel, centroids)\n      counts[closestIndex]++\n    })\n\n    const totalPixels = pixels.length\n\n    return centroids.map((centroid, index) => ({\n      color: centroid,\n      hex: chroma.rgb(centroid[0], centroid[1], centroid[2]).hex() as HexModel,\n      count: counts[index],\n      percentage: parseFloat(((counts[index] / totalPixels) * 100).toFixed(2)),\n    }))\n  }\n\n  setColorCount = (count: number): void => {\n    this.colorCount = Math.max(1, Math.min(count, 20))\n  }\n\n  updateOptions = (options: Partial<DominantColorsOptions>): void => {\n    if (options.colorCount !== undefined) this.setColorCount(options.colorCount)\n    if (options.maxIterations !== undefined)\n      this.maxIterations = options.maxIterations\n    if (options.tolerance !== undefined) this.tolerance = options.tolerance\n    if (options.skipTransparent !== undefined)\n      this.skipTransparent = options.skipTransparent\n  }\n\n  getOptions = (): DominantColorsOptions => ({\n    colorCount: this.colorCount,\n    maxIterations: this.maxIterations,\n    tolerance: this.tolerance,\n    skipTransparent: this.skipTransparent,\n  })\n\n  /** Static method for simplified ArrayBuffer usage */\n  static async fromArrayBuffer(\n    arrayBuffer: ArrayBuffer,\n    options: Omit<DominantColorsInput, 'arrayBuffer' | 'imageData'> = {}\n  ): Promise<DominantColorResult[]> {\n    const decoder = new DominantColors({\n      arrayBuffer,\n      ...options,\n    })\n\n    return decoder.extractDominantColorsAsync()\n  }\n\n  /** Simplified static method for quick color extraction */\n  static async extract(\n    arrayBuffer: ArrayBuffer,\n    colorCount: number = 5\n  ): Promise<DominantColorResult[]> {\n    return this.fromArrayBuffer(arrayBuffer, { colorCount })\n  }\n}\n"],"names":["DominantColors","imageData","arrayBuffer","colorCount","maxIterations","tolerance","skipTransparent","maxImageSize","__publicField","pixels","clusters","a","b","data","i","g","centroids","prevCentroids","iteration","c","pixel","closestIndex","cluster","distances","minDistance","centroid","totalDistance","sum","d","threshold","cumulative","j","index","distance","color1","color2","r1","g1","b1","r2","g2","b2","acc","counts","totalPixels","chroma","count","options","resolve","reject","globalWindow","blob","url","img","canvas","ctx","aspectRatio","targetWidth","targetHeight","browserImageData","error"],"mappings":"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"}

package/dist/types/color.types.d.ts

@@ -30,7 +30,7 @@ export interface DominantColorsOptions {
     tolerance?: number;
     skipTransparent?: boolean;
 }
-export type HarmonyType = 'analogous' | 'complementary' | 'triadic' | 'tetradic' | 'square';
+export type HarmonyType = 'ANALOGOUS' | 'COMPLEMENTARY' | 'TRIADIC' | 'TETRADIC' | 'SQUARE' | 'COMPOUND';
 export interface ColorHarmonyResult {
     type: HarmonyType;
     baseColor: Channel;

package/dist/types/color.types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"color.types.d.ts","sourceRoot":"","sources":["../../src/types/color.types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,QAAQ,GAAG,IAAI,MAAM,EAAE,GAAG,MAAM,CAAA;AAE5C,MAAM,WAAW,QAAQ;IACvB,CAAC,EAAE,MAAM,CAAA;IACT,CAAC,EAAE,MAAM,CAAA;IACT,CAAC,EAAE,MAAM,CAAA;IACT,CAAC,CAAC,EAAE,MAAM,CAAA;CACX;AAED,MAAM,WAAW,QAAQ;IACvB,CAAC,EAAE,MAAM,CAAA;IACT,CAAC,EAAE,MAAM,CAAA;IACT,CAAC,EAAE,MAAM,CAAA;IACT,CAAC,EAAE,MAAM,CAAA;CACV;AAED,MAAM,MAAM,OAAO,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAA;AAC9C,MAAM,MAAM,gBAAgB,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAA;AAE/D,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,iBAAiB,CAAA;IACvB,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,MAAM,CAAA;CACf;AAED,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,OAAO,CAAA;IACd,GAAG,EAAE,QAAQ,CAAA;IACb,UAAU,EAAE,MAAM,CAAA;IAClB,KAAK,EAAE,MAAM,CAAA;CACd;AAED,MAAM,WAAW,qBAAqB;IACpC,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,eAAe,CAAC,EAAE,OAAO,CAAA;CAC1B;AAED,MAAM,MAAM,WAAW,GACnB,WAAW,GACX,eAAe,GACf,SAAS,GACT,UAAU,GACV,QAAQ,CAAA;AAEZ,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,WAAW,CAAA;IACjB,SAAS,EAAE,OAAO,CAAA;IAClB,OAAO,EAAE,QAAQ,CAAA;IACjB,MAAM,EAAE,OAAO,EAAE,CAAA;IACjB,SAAS,EAAE,QAAQ,EAAE,CAAA;CACtB;AAED,MAAM,WAAW,mBAAmB;IAClC,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,YAAY,CAAC,EAAE,KAAK,GAAG,KAAK,GAAG,MAAM,CAAA;CACtC"}
+{"version":3,"file":"color.types.d.ts","sourceRoot":"","sources":["../../src/types/color.types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,QAAQ,GAAG,IAAI,MAAM,EAAE,GAAG,MAAM,CAAA;AAE5C,MAAM,WAAW,QAAQ;IACvB,CAAC,EAAE,MAAM,CAAA;IACT,CAAC,EAAE,MAAM,CAAA;IACT,CAAC,EAAE,MAAM,CAAA;IACT,CAAC,CAAC,EAAE,MAAM,CAAA;CACX;AAED,MAAM,WAAW,QAAQ;IACvB,CAAC,EAAE,MAAM,CAAA;IACT,CAAC,EAAE,MAAM,CAAA;IACT,CAAC,EAAE,MAAM,CAAA;IACT,CAAC,EAAE,MAAM,CAAA;CACV;AAED,MAAM,MAAM,OAAO,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAA;AAC9C,MAAM,MAAM,gBAAgB,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAA;AAE/D,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,iBAAiB,CAAA;IACvB,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,MAAM,CAAA;CACf;AAED,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,OAAO,CAAA;IACd,GAAG,EAAE,QAAQ,CAAA;IACb,UAAU,EAAE,MAAM,CAAA;IAClB,KAAK,EAAE,MAAM,CAAA;CACd;AAED,MAAM,WAAW,qBAAqB;IACpC,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,eAAe,CAAC,EAAE,OAAO,CAAA;CAC1B;AAED,MAAM,MAAM,WAAW,GACnB,WAAW,GACX,eAAe,GACf,SAAS,GACT,UAAU,GACV,QAAQ,GACR,UAAU,CAAA;AAEd,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,WAAW,CAAA;IACjB,SAAS,EAAE,OAAO,CAAA;IAClB,OAAO,EAAE,QAAQ,CAAA;IACjB,MAAM,EAAE,OAAO,EAAE,CAAA;IACjB,SAAS,EAAE,QAAQ,EAAE,CAAA;CACtB;AAED,MAAM,WAAW,mBAAmB;IAClC,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,YAAY,CAAC,EAAE,KAAK,GAAG,KAAK,GAAG,MAAM,CAAA;CACtC"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@a_ng_d/utils-ui-color-palette",
   "private": false,
-  "version": "1.7.1",
+  "version": "1.7.3",
   "description": "Core utilities library for UI Color Palette - a color management plugin for design tools. This library provides the foundational color manipulation, contrast calculation, and palette generation features used in the plugin.",
   "repository": "https://github.com/a-ng-d/utils-ui-color-palette",
   "keywords": [