@a_ng_d/utils-ui-color-palette 1.6.4 → 1.7.0

package/README.md

@@ -27,6 +27,20 @@ UI Color Palette is available for:
   - Color mixing and blending
   - Brightness and saturation adjustments
 
+- **Dominant Colors Extraction**:
+
+  - Extract dominant colors from images using K-means clustering
+  - Configurable number of colors to extract
+  - Automatic color frequency calculation
+  - Support for transparent pixel filtering
+
+- **Color Harmony Generation**:
+
+  - Generate analogous, complementary, triadic, tetradic, and square color harmonies
+  - Configurable analogous spread angle
+  - Automatic color relationship calculations
+  - Support for all major color harmony types
+
 - **Palette Generation**:
   - Create harmonious color schemes
   - Generate accessible color combinations
@@ -43,7 +57,13 @@ yarn add @a_ng_d/utils-ui-color-palette
 ## Usage
 
 ```typescript
-import { Color, Contrast, Data } from '@a_ng_d/utils-ui-color-palette'
+import {
+  Color,
+  Contrast,
+  Data,
+  DominantColors,
+  ColorHarmony,
+} from '@a_ng_d/utils-ui-color-palette'
 
 // Use Color class for color manipulation
 const color = new Color({
@@ -120,6 +140,87 @@ const minSizes = contrast.getMinFontSizes() // Returns minimum font sizes
 const lightness = contrast.getLightnessForContrastRatio(4.5) // For WCAG AA
 ```
 
+### Dominant Colors Extraction
+
+```typescript
+import { DominantColors } from '@a_ng_d/utils-ui-color-palette'
+
+// Prepare your image data (from canvas, file, etc.)
+const canvas = document.createElement('canvas')
+const ctx = canvas.getContext('2d')
+// ... load your image into the canvas
+const imageData = ctx.getImageData(0, 0, canvas.width, canvas.height)
+
+// Create a dominant colors extractor
+const dominantColors = new DominantColors({
+  imageData: imageData,
+  colorCount: 5, // Extract top 5 colors
+  maxIterations: 50, // K-means algorithm iterations
+  tolerance: 0.01, // Convergence tolerance
+  skipTransparent: true, // Skip transparent pixels
+})
+
+// Extract the dominant colors
+const colors = dominantColors.extractDominantColors()
+
+// Results array contains:
+colors.forEach((result) => {
+  console.log({
+    color: result.color, // RGB array: [r, g, b]
+    hex: result.hex, // Hex string: "#ff0000"
+    percentage: result.percentage, // Percentage of image: 25.5
+    count: result.count, // Number of pixels: 1000
+  })
+})
+
+// Update settings dynamically
+dominantColors.setColorCount(8) // Change to 8 colors
+dominantColors.updateOptions({
+  maxIterations: 100,
+  tolerance: 0.005,
+})
+
+// Get current configuration
+const options = dominantColors.getOptions()
+```
+
+### Color Harmony Generation
+
+```typescript
+import { ColorHarmony } from '@a_ng_d/utils-ui-color-palette'
+
+// Create a color harmony generator
+const colorHarmony = new ColorHarmony({
+  baseColor: [255, 0, 0], // Red base color
+  analogousSpread: 30, // 30 degrees for analogous colors
+})
+
+// Generate specific harmony types
+const analogous = colorHarmony.generateAnalogous()
+const complementary = colorHarmony.generateComplementary()
+const triadic = colorHarmony.generateTriadic()
+const tetradic = colorHarmony.generateTetradic()
+const square = colorHarmony.generateSquare()
+
+// Generate harmony by type
+const harmony = colorHarmony.generateHarmony('triadic')
+
+// Generate all harmonies at once
+const allHarmonies = colorHarmony.getAllHarmonies()
+
+// Results contain both RGB and hex values
+console.log(triadic.colors) // [[255, 0, 0], [0, 255, 0], [0, 0, 255]]
+console.log(triadic.hexColors) // ['#ff0000', '#00ff00', '#0000ff']
+
+// Update settings
+colorHarmony.setBaseColor([0, 128, 255])
+colorHarmony.setAnalogousSpread(45)
+colorHarmony.updateOptions({
+  analogousSpread: 60,
+  returnFormat: 'hex',
+})
+```
+
 ### Palette Generation
 
 ```typescript
@@ -170,15 +271,15 @@ yarn test
 
 Current test coverage results:
 
-| File        | % Stmts | % Branch | % Funcs | % Lines |
-| ----------- | ------- | -------- | ------- | ------- |
-| All files   | 79.82   | 81.81    | 81.42   | 79.82   |
-| color       | 72.02   | 72.36    | 69.04   | 72.02   |
-| color.ts    | 72.02   | 72.36    | 69.04   | 72.02   |
-| contrast    | 89      | 93.02    | 100     | 89      |
-| contrast.ts | 89      | 93.02    | 100     | 89      |
-| data        | 85.99   | 83.73    | 100     | 85.99   |
-| data.ts     | 85.99   | 83.73    | 100     | 85.99   |
+| File              | % Stmts | % Branch | % Funcs | % Lines |
+| ----------------- | ------- | -------- | ------- | ------- |
+| **All files**     | **94.29** | **85.63** | **92.3** | **94.29** |
+| code              | 100     | 100      | 100     | 100     |
+| color             | 92.06   | 72.38    | 80.95   | 92.06   |
+| color-harmony     | 100     | 96.42    | 100     | 100     |
+| contrast          | 89      | 93.02    | 100     | 89      |
+| data              | 92.69   | 84.74    | 100     | 92.69   |
+| dominant-colors   | 100     | 100      | 100     | 100     |
 
 To run coverage tests:
 

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-export type { HexModel, RgbModel, HslModel, Channel, ChannelWithAlpha, } from './types/color.types';
+export type { HexModel, RgbModel, HslModel, Channel, ChannelWithAlpha, ImageData, DominantColorResult, DominantColorsOptions, HarmonyType, ColorHarmonyResult, ColorHarmonyOptions, } from './types/color.types';
 export type { BaseConfiguration, SourceColorConfiguration, ExchangeConfiguration, ExtractOfBaseConfiguration, EasingConfiguration, PresetConfiguration, ShiftConfiguration, ScaleConfiguration, LockedSourceColorsConfiguration, ColorConfiguration, ThemeConfiguration, ExportConfiguration, ColorSpaceConfiguration, VisionSimulationModeConfiguration, TextColorsThemeConfiguration, ViewConfiguration, AlgorithmVersionConfiguration, DatesConfiguration, PublicationConfiguration, CreatorConfiguration, StatusConfiguration, UserConfiguration, MetaConfiguration, FullConfiguration, DocumentConfiguration, ThirdParty, } from './types/configuration.types';
 export type { PaletteData, LibraryData, PaletteDataThemeItem, PaletteDataColorItem, PaletteDataShadeItem, ExternalPalettes, ColourLovers, } from './types/data.types';
 export type { ColorFormat } from './types/model.types';
@@ -6,4 +6,6 @@ export { default as Color } from './modules/color/color';
 export { default as Contrast } from './modules/contrast/contrast';
 export { default as Data } from './modules/data/data';
 export { default as Code } from './modules/code/code';
+export { default as DominantColors } from './modules/dominant-colors/dominant-colors';
+export { default as ColorHarmony } from './modules/color-harmony/color-harmony';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,QAAQ,EACR,QAAQ,EACR,QAAQ,EACR,OAAO,EACP,gBAAgB,GACjB,MAAM,kBAAkB,CAAA;AACzB,YAAY,EACV,iBAAiB,EACjB,wBAAwB,EACxB,qBAAqB,EACrB,0BAA0B,EAC1B,mBAAmB,EACnB,mBAAmB,EACnB,kBAAkB,EAClB,kBAAkB,EAClB,+BAA+B,EAC/B,kBAAkB,EAClB,kBAAkB,EAClB,mBAAmB,EACnB,uBAAuB,EACvB,iCAAiC,EACjC,4BAA4B,EAC5B,iBAAiB,EACjB,6BAA6B,EAC7B,kBAAkB,EAClB,wBAAwB,EACxB,oBAAoB,EACpB,mBAAmB,EACnB,iBAAiB,EACjB,iBAAiB,EACjB,iBAAiB,EACjB,qBAAqB,EACrB,UAAU,GACX,MAAM,0BAA0B,CAAA;AACjC,YAAY,EACV,WAAW,EACX,WAAW,EACX,oBAAoB,EACpB,oBAAoB,EACpB,oBAAoB,EACpB,gBAAgB,EAChB,YAAY,GACb,MAAM,iBAAiB,CAAA;AACxB,YAAY,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AAEnD,OAAO,EAAE,OAAO,IAAI,KAAK,EAAE,MAAM,sBAAsB,CAAA;AACvD,OAAO,EAAE,OAAO,IAAI,QAAQ,EAAE,MAAM,4BAA4B,CAAA;AAChE,OAAO,EAAE,OAAO,IAAI,IAAI,EAAE,MAAM,oBAAoB,CAAA;AACpD,OAAO,EAAE,OAAO,IAAI,IAAI,EAAE,MAAM,oBAAoB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,QAAQ,EACR,QAAQ,EACR,QAAQ,EACR,OAAO,EACP,gBAAgB,EAChB,SAAS,EACT,mBAAmB,EACnB,qBAAqB,EACrB,WAAW,EACX,kBAAkB,EAClB,mBAAmB,GACpB,MAAM,kBAAkB,CAAA;AACzB,YAAY,EACV,iBAAiB,EACjB,wBAAwB,EACxB,qBAAqB,EACrB,0BAA0B,EAC1B,mBAAmB,EACnB,mBAAmB,EACnB,kBAAkB,EAClB,kBAAkB,EAClB,+BAA+B,EAC/B,kBAAkB,EAClB,kBAAkB,EAClB,mBAAmB,EACnB,uBAAuB,EACvB,iCAAiC,EACjC,4BAA4B,EAC5B,iBAAiB,EACjB,6BAA6B,EAC7B,kBAAkB,EAClB,wBAAwB,EACxB,oBAAoB,EACpB,mBAAmB,EACnB,iBAAiB,EACjB,iBAAiB,EACjB,iBAAiB,EACjB,qBAAqB,EACrB,UAAU,GACX,MAAM,0BAA0B,CAAA;AACjC,YAAY,EACV,WAAW,EACX,WAAW,EACX,oBAAoB,EACpB,oBAAoB,EACpB,oBAAoB,EACpB,gBAAgB,EAChB,YAAY,GACb,MAAM,iBAAiB,CAAA;AACxB,YAAY,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AAEnD,OAAO,EAAE,OAAO,IAAI,KAAK,EAAE,MAAM,sBAAsB,CAAA;AACvD,OAAO,EAAE,OAAO,IAAI,QAAQ,EAAE,MAAM,4BAA4B,CAAA;AAChE,OAAO,EAAE,OAAO,IAAI,IAAI,EAAE,MAAM,oBAAoB,CAAA;AACpD,OAAO,EAAE,OAAO,IAAI,IAAI,EAAE,MAAM,oBAAoB,CAAA;AACpD,OAAO,EAAE,OAAO,IAAI,cAAc,EAAE,MAAM,0CAA0C,CAAA;AACpF,OAAO,EAAE,OAAO,IAAI,YAAY,EAAE,MAAM,sCAAsC,CAAA"}

package/dist/index.js

@@ -1,11 +1,15 @@
-import { C as r } from "./color-1CXTuV84.js";
+import { C as a } from "./color-1CXTuV84.js";
 import { default as e } from "./modules/contrast/contrast.js";
-import { default as s } from "./modules/data/data.js";
-import { default as l } from "./modules/code/code.js";
+import { default as l } from "./modules/data/data.js";
+import { default as s } from "./modules/code/code.js";
+import { default as p } from "./modules/dominant-colors/dominant-colors.js";
+import { default as C } from "./modules/color-harmony/color-harmony.js";
 export {
-  l as Code,
-  r as Color,
+  s as Code,
+  a as Color,
+  C as ColorHarmony,
   e as Contrast,
-  s as Data
+  l as Data,
+  p as DominantColors
 };
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;"}
+{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;"}

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

@@ -0,0 +1,25 @@
+import { Channel, HarmonyType, ColorHarmonyResult, ColorHarmonyOptions } from '../../types/color.types';
+
+export default class ColorHarmony {
+    private baseColor;
+    private analogousSpread;
+    private returnFormat;
+    constructor({ baseColor, analogousSpread, returnFormat, }: {
+        baseColor?: Channel;
+    } & ColorHarmonyOptions);
+    generateAnalogous: () => ColorHarmonyResult;
+    generateComplementary: () => ColorHarmonyResult;
+    generateTriadic: () => ColorHarmonyResult;
+    generateTetradic: () => ColorHarmonyResult;
+    generateSquare: () => ColorHarmonyResult;
+    generateHarmony: (type: HarmonyType) => ColorHarmonyResult;
+    getAllHarmonies: () => ColorHarmonyResult[];
+    private normalizeHue;
+    private hueToRgb;
+    private formatResult;
+    setBaseColor: (color: Channel) => void;
+    setAnalogousSpread: (spread: number) => void;
+    updateOptions: (options: Partial<ColorHarmonyOptions>) => void;
+    getOptions: () => ColorHarmonyOptions;
+}
+//# sourceMappingURL=color-harmony.d.ts.map

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

@@ -0,0 +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"}

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

@@ -0,0 +1,136 @@
+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";
+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 = [
+        this.baseColor,
+        this.hueToRgb(
+          this.normalizeHue(t - this.analogousSpread),
+          e[1],
+          e[2]
+        ),
+        this.hueToRgb(
+          this.normalizeHue(t + this.analogousSpread),
+          e[1],
+          e[2]
+        )
+      ];
+      return this.formatResult("analogous", s);
+    });
+    r(this, "generateComplementary", () => {
+      const e = o(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);
+    });
+    r(this, "generateTriadic", () => {
+      const e = o(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);
+    });
+    r(this, "generateTetradic", () => {
+      const e = o(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);
+    });
+    r(this, "generateSquare", () => {
+      const e = o(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);
+    });
+    r(this, "generateHarmony", (e) => {
+      switch (e) {
+        case "analogous":
+          return this.generateAnalogous();
+        case "complementary":
+          return this.generateComplementary();
+        case "triadic":
+          return this.generateTriadic();
+        case "tetradic":
+          return this.generateTetradic();
+        case "square":
+          return this.generateSquare();
+        default:
+          throw new Error(`Unknown harmony type: ${e}`);
+      }
+    });
+    r(this, "getAllHarmonies", () => [
+      this.generateAnalogous(),
+      this.generateComplementary(),
+      this.generateTriadic(),
+      this.generateTetradic(),
+      this.generateSquare()
+    ]);
+    r(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])];
+    });
+    r(this, "formatResult", (e, t) => {
+      const s = t.map(
+        (a) => [
+          Math.round(a[0]),
+          Math.round(a[1]),
+          Math.round(a[2])
+        ]
+      ), h = s.map(
+        (a) => o.rgb(a[0], a[1], a[2]).hex()
+      );
+      return {
+        type: e,
+        baseColor: [
+          Math.round(this.baseColor[0]),
+          Math.round(this.baseColor[1]),
+          Math.round(this.baseColor[2])
+        ],
+        baseHex: o.rgb(this.baseColor[0], this.baseColor[1], this.baseColor[2]).hex(),
+        colors: s,
+        hexColors: h
+      };
+    });
+    r(this, "setBaseColor", (e) => {
+      this.baseColor = e;
+    });
+    r(this, "setAnalogousSpread", (e) => {
+      this.analogousSpread = Math.max(1, Math.min(e, 180));
+    });
+    r(this, "updateOptions", (e) => {
+      e.analogousSpread !== void 0 && this.setAnalogousSpread(e.analogousSpread), e.returnFormat !== void 0 && (this.returnFormat = e.returnFormat);
+    });
+    r(this, "getOptions", () => ({
+      analogousSpread: this.analogousSpread,
+      returnFormat: this.returnFormat
+    }));
+    this.baseColor = e, this.analogousSpread = t, this.returnFormat = s;
+  }
+}
+export {
+  m as default
+};
+//# sourceMappingURL=color-harmony.js.map

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

@@ -0,0 +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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"}

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

@@ -0,0 +1,25 @@
+import { ImageData, DominantColorResult, DominantColorsOptions } from '../../types/color.types';
+
+export default class DominantColors {
+    private imageData;
+    private colorCount;
+    private maxIterations;
+    private tolerance;
+    private skipTransparent;
+    constructor({ imageData, colorCount, maxIterations, tolerance, skipTransparent, }: {
+        imageData: ImageData;
+    } & DominantColorsOptions);
+    extractDominantColors: () => DominantColorResult[];
+    private extractPixels;
+    private performKMeans;
+    private initializeCentroids;
+    private findClosestCentroid;
+    private calculateDistance;
+    private calculateCentroid;
+    private hasConverged;
+    private calculateColorFrequencies;
+    setColorCount: (count: number) => void;
+    updateOptions: (options: Partial<DominantColorsOptions>) => void;
+    getOptions: () => DominantColorsOptions;
+}
+//# sourceMappingURL=dominant-colors.d.ts.map

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

@@ -0,0 +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"}

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

@@ -0,0 +1,125 @@
+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 {
+  constructor({
+    imageData: t,
+    colorCount: e = 5,
+    maxIterations: n = 50,
+    tolerance: a = 0.01,
+    skipTransparent: r = !0
+  }) {
+    o(this, "imageData");
+    o(this, "colorCount");
+    o(this, "maxIterations");
+    o(this, "tolerance");
+    o(this, "skipTransparent");
+    o(this, "extractDominantColors", () => {
+      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);
+    });
+    o(this, "extractPixels", () => {
+      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]);
+      }
+      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(
+          { 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++;
+      }
+      return e;
+    });
+    o(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) => {
+          const h = Math.min(
+            ...e.map(
+              (u) => this.calculateDistance(c, u)
+            )
+          );
+          return h * h;
+        }), r = a.reduce((c, h) => c + h, 0), s = Math.random() * r;
+        let i = 0;
+        for (let c = 0; c < t.length; c++)
+          if (i += a[c], i >= s) {
+            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;
+    });
+    o(this, "calculateDistance", (t, e) => {
+      const [n, a, r] = t, [s, i, c] = e;
+      return Math.sqrt(
+        Math.pow(n - s, 2) + Math.pow(a - i, 2) + Math.pow(r - c, 2)
+      );
+    });
+    o(this, "calculateCentroid", (t) => {
+      const e = t.reduce(
+        (n, a) => [n[0] + a[0], n[1] + a[1], n[2] + a[2]],
+        [0, 0, 0]
+      );
+      return [
+        Math.round(e[0] / t.length),
+        Math.round(e[1] / t.length),
+        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]++;
+      });
+      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))
+      }));
+    });
+    o(this, "setColorCount", (t) => {
+      this.colorCount = Math.max(1, Math.min(t, 20));
+    });
+    o(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", () => ({
+      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;
+  }
+}
+export {
+  p as default
+};
+//# sourceMappingURL=dominant-colors.js.map

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

@@ -0,0 +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":";;;;AASA,MAAqBA,EAAe;AAAA,EAOlC,YAAY;AAAA,IACV,WAAAC;AAAA,IACA,YAAAC,IAAa;AAAA,IACb,eAAAC,IAAgB;AAAA,IAChB,WAAAC,IAAY;AAAA,IACZ,iBAAAC,IAAkB;AAAA,EAAA,GAGO;AAdnB,IAAAC,EAAA;AACA,IAAAA,EAAA;AACA,IAAAA,EAAA;AACA,IAAAA,EAAA;AACA,IAAAA,EAAA;AAkBR,IAAAA,EAAA,+BAAwB,MAA6B;AAC7C,YAAAC,IAAS,KAAK,cAAc;AAClC,UAAIA,EAAO,WAAW,EAAG,QAAO,CAAC;AAE3B,YAAAC,IAAW,KAAK,cAAcD,CAAM;AAGnC,aAFS,KAAK,0BAA0BA,GAAQC,CAAQ,EAEhD,KAAK,CAAC,GAAGC,MAAMA,EAAE,aAAa,EAAE,UAAU;AAAA,IAC3D;AAEQ,IAAAH,EAAA,uBAAgB,MAAiB;AACvC,YAAMC,IAAoB,CAAC,GACrBG,IAAO,KAAK,UAAU;AAE5B,eAASC,IAAI,GAAGA,IAAID,EAAK,QAAQC,KAAK,GAAG;AACjC,cAAAC,IAAIF,EAAKC,CAAC,GACVE,IAAIH,EAAKC,IAAI,CAAC,GACdF,IAAIC,EAAKC,IAAI,CAAC,GACdG,IAAIJ,EAAKC,IAAI,CAAC;AAEhB,QAAA,KAAK,mBAAmBG,IAAI,OAEhCP,EAAO,KAAK,CAACK,GAAGC,GAAGJ,CAAC,CAAC;AAAA,MAAA;AAGhB,aAAAF;AAAA,IACT;AAEQ,IAAAD,EAAA,uBAAgB,CAACC,MAAiC;AACpD,UAAAQ,IAAY,KAAK,oBAAoBR,CAAM,GAC3CS,IAA2B,CAAC,GAC5BC,IAAY;AAGd,aAAAA,IAAY,KAAK,iBACjB,CAAC,KAAK,aAAaF,GAAWC,CAAa,KAC3C;AACA,QAAAA,IAAgBD,EAAU,IAAI,CAACG,MAAM,CAAC,GAAGA,CAAC,CAAY;AAEtD,cAAMV,IAAwB,MAAM;AAAA,UAClC,EAAE,QAAQ,KAAK,WAAW;AAAA,UAC1B,MAAM,CAAA;AAAA,QACR;AAEO,QAAAD,EAAA,QAAQ,CAACY,MAAU;AACxB,gBAAMC,IAAe,KAAK,oBAAoBD,GAAOJ,CAAS;AACrD,UAAAP,EAAAY,CAAY,EAAE,KAAKD,CAAK;AAAA,QAAA,CAClC,GAEWJ,IAAAP,EAAS,IAAI,CAACa,MACpBA,EAAQ,WAAW,IACdL,EAAcD,EAAU,QAAQA,EAAU,CAAC,CAAC,CAAC,IAC/C,KAAK,kBAAkBM,CAAO,CACtC,GAEDJ;AAAA,MAAA;AAGK,aAAAF;AAAA,IACT;AAEQ,IAAAT,EAAA,6BAAsB,CAACC,MAAiC;AAC9D,YAAMQ,IAAuB,CAAC;AAGpB,MAAAA,EAAA,KAAKR,EAAO,KAAK,MAAM,KAAK,WAAWA,EAAO,MAAM,CAAC,CAAC;AAEhE,eAASI,IAAI,GAAGA,IAAI,KAAK,YAAYA,KAAK;AACxC,cAAMW,IAAYf,EAAO,IAAI,CAACY,MAAU;AACtC,gBAAMI,IAAc,KAAK;AAAA,YACvB,GAAGR,EAAU;AAAA,cAAI,CAACS,MAChB,KAAK,kBAAkBL,GAAOK,CAAQ;AAAA,YAAA;AAAA,UAE1C;AACA,iBAAOD,IAAcA;AAAA,QAAA,CACtB,GAEKE,IAAgBH,EAAU,OAAO,CAACI,GAAKC,MAAMD,IAAMC,GAAG,CAAC,GACvDC,IAAY,KAAK,OAAA,IAAWH;AAElC,YAAII,IAAa;AACjB,iBAASC,IAAI,GAAGA,IAAIvB,EAAO,QAAQuB;AAEjC,cADAD,KAAcP,EAAUQ,CAAC,GACrBD,KAAcD,GAAW;AACjB,YAAAb,EAAA,KAAKR,EAAOuB,CAAC,CAAC;AACxB;AAAA,UAAA;AAAA,MAEJ;AAGK,aAAAf;AAAA,IACT;AAEQ,IAAAT,EAAA,6BAAsB,CAC5Ba,GACAJ,MACW;AACX,UAAIQ,IAAc,OACdH,IAAe;AAET,aAAAL,EAAA,QAAQ,CAACS,GAAUO,MAAU;AACrC,cAAMC,IAAW,KAAK,kBAAkBb,GAAOK,CAAQ;AACvD,QAAIQ,IAAWT,MACCA,IAAAS,GACCZ,IAAAW;AAAA,MACjB,CACD,GAEMX;AAAA,IACT;AAEQ,IAAAd,EAAA,2BAAoB,CAAC2B,GAAiBC,MAA4B;AACxE,YAAM,CAACC,GAAIC,GAAIC,CAAE,IAAIJ,GACf,CAACK,GAAIC,GAAIC,CAAE,IAAIN;AAErB,aAAO,KAAK;AAAA,QACV,KAAK,IAAIC,IAAKG,GAAI,CAAC,IAAI,KAAK,IAAIF,IAAKG,GAAI,CAAC,IAAI,KAAK,IAAIF,IAAKG,GAAI,CAAC;AAAA,MACnE;AAAA,IACF;AAEQ,IAAAlC,EAAA,2BAAoB,CAACe,MAAgC;AAC3D,YAAMK,IAAML,EAAQ;AAAA,QAClB,CAACoB,GAAKtB,MAAU,CAACsB,EAAI,CAAC,IAAItB,EAAM,CAAC,GAAGsB,EAAI,CAAC,IAAItB,EAAM,CAAC,GAAGsB,EAAI,CAAC,IAAItB,EAAM,CAAC,CAAC;AAAA,QACxE,CAAC,GAAG,GAAG,CAAC;AAAA,MACV;AAEO,aAAA;AAAA,QACL,KAAK,MAAMO,EAAI,CAAC,IAAIL,EAAQ,MAAM;AAAA,QAClC,KAAK,MAAMK,EAAI,CAAC,IAAIL,EAAQ,MAAM;AAAA,QAClC,KAAK,MAAMK,EAAI,CAAC,IAAIL,EAAQ,MAAM;AAAA,MACpC;AAAA,IACF;AAEQ,IAAAf,EAAA,sBAAe,CACrBS,GACAC,MAEIA,EAAc,WAAW,IAAU,KAEhCD,EAAU,MAAM,CAACS,GAAUO,MACf,KAAK,kBAAkBP,GAAUR,EAAce,CAAK,CAAC,IACpD,KAAK,SACxB;AAGK,IAAAzB,EAAA,mCAA4B,CAClCC,GACAQ,MAC0B;AAC1B,YAAM2B,IAAS,IAAI,MAAM3B,EAAU,MAAM,EAAE,KAAK,CAAC;AAE1C,MAAAR,EAAA,QAAQ,CAACY,MAAU;AACxB,cAAMC,IAAe,KAAK,oBAAoBD,GAAOJ,CAAS;AAC9D,QAAA2B,EAAOtB,CAAY;AAAA,MAAA,CACpB;AAED,YAAMuB,IAAcpC,EAAO;AAE3B,aAAOQ,EAAU,IAAI,CAACS,GAAUO,OAAW;AAAA,QACzC,OAAOP;AAAA,QACP,KAAKoB,EAAO,IAAIpB,EAAS,CAAC,GAAGA,EAAS,CAAC,GAAGA,EAAS,CAAC,CAAC,EAAE,IAAI;AAAA,QAC3D,OAAOkB,EAAOX,CAAK;AAAA,QACnB,YAAY,YAAaW,EAAOX,CAAK,IAAIY,IAAe,KAAK,QAAQ,CAAC,CAAC;AAAA,MAAA,EACvE;AAAA,IACJ;AAEA,IAAArC,EAAA,uBAAgB,CAACuC,MAAwB;AAClC,WAAA,aAAa,KAAK,IAAI,GAAG,KAAK,IAAIA,GAAO,EAAE,CAAC;AAAA,IACnD;AAEA,IAAAvC,EAAA,uBAAgB,CAACwC,MAAkD;AACjE,MAAIA,EAAQ,eAAe,UAAgB,KAAA,cAAcA,EAAQ,UAAU,GACvEA,EAAQ,kBAAkB,WAC5B,KAAK,gBAAgBA,EAAQ,gBAC3BA,EAAQ,cAAc,WAAW,KAAK,YAAYA,EAAQ,YAC1DA,EAAQ,oBAAoB,WAC9B,KAAK,kBAAkBA,EAAQ;AAAA,IACnC;AAEA,IAAAxC,EAAA,oBAAa,OAA8B;AAAA,MACzC,YAAY,KAAK;AAAA,MACjB,eAAe,KAAK;AAAA,MACpB,WAAW,KAAK;AAAA,MAChB,iBAAiB,KAAK;AAAA,IAAA;AA9LtB,SAAK,YAAYL,GACjB,KAAK,aAAaC,GAClB,KAAK,gBAAgBC,GACrB,KAAK,YAAYC,GACjB,KAAK,kBAAkBC;AAAA,EAAA;AA4L3B;"}

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

@@ -13,4 +13,33 @@ export interface HslModel {
 }
 export type Channel = [number, number, number];
 export type ChannelWithAlpha = [number, number, number, number];
+export interface ImageData {
+    data: Uint8ClampedArray;
+    width: number;
+    height: number;
+}
+export interface DominantColorResult {
+    color: Channel;
+    hex: HexModel;
+    percentage: number;
+    count: number;
+}
+export interface DominantColorsOptions {
+    colorCount?: number;
+    maxIterations?: number;
+    tolerance?: number;
+    skipTransparent?: boolean;
+}
+export type HarmonyType = 'analogous' | 'complementary' | 'triadic' | 'tetradic' | 'square';
+export interface ColorHarmonyResult {
+    type: HarmonyType;
+    baseColor: Channel;
+    baseHex: HexModel;
+    colors: Channel[];
+    hexColors: HexModel[];
+}
+export interface ColorHarmonyOptions {
+    analogousSpread?: number;
+    returnFormat?: 'rgb' | 'hex' | 'both';
+}
 //# sourceMappingURL=color.types.d.ts.map

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"}
+{"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"}

package/package.json

@@ -1,12 +1,9 @@
 {
   "name": "@a_ng_d/utils-ui-color-palette",
   "private": false,
-  "version": "1.6.4",
+  "version": "1.7.0",
   "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": {
-    "type": "git",
-    "url": "git+https://github.com/a-ng-d/utils-ui-color-palette.git"
-  },
+  "repository": "https://github.com/a-ng-d/utils-ui-color-palette",
   "keywords": [
     "color",
     "contrast",
@@ -61,4 +58,4 @@
     "chroma-js": "^2.4.2",
     "hsluv": "^1.0.1"
   }
-}
+}