@aviala-design/color 0.1.1 → 0.2.1

package/README.md

@@ -1,8 +1,13 @@
-# ArcoDesign Color
+# Aviala Design Color
 
-ArcoDesign Color Utils. 
+Aviala Design Color - A powerful color processing utility library.
 
-For a given color, a gradient swatch containing ten colors is generated with an algorithm. This works for both light and dark modes.
+This library provides four core functionalities:
+
+1. **Color Palette Generation**: Generate gradient swatches containing ten colors using algorithms, supporting both light and dark modes.
+2. **Image Color Extraction**: Extract dominant colors from images for generating matching palettes or theme colors.
+3. **Interface Color System**: Generate complete interface color systems based on primary colors, including semantic colors (success, warning, error, info).
+4. **Theme Blending**: Advanced theme blending functionality based on HCT color space with multiple blending modes.
 
 ## Usage
 
@@ -11,10 +16,21 @@ npm i @arco-design/color
 ```
 
 ```js
-import { generate, getPresetColors } from '@arco-design/color';
+import { 
+  generate, 
+  getPresetColors,
+  getRgbStr,
+  extractColorFromImage,
+  generateInterfaceColorSystem,
+  blendInHct,
+  rgbToHct,
+  hctToRgb
+} from '@aviala-design/color';
 
+// Generate color palette
 console.log(generate('#123456'));
 
+// Get preset colors
 console.log(getPresetColors());
 // {
 //   red: {...},
@@ -32,6 +48,17 @@ console.log(getPresetColors());
 //   magenta: {...},
 //   gray: {...}
 // }
+
+// Generate interface color system
+const colorSystem = generateInterfaceColorSystem('#3491FA');
+console.log(colorSystem.success); // Success colors
+console.log(colorSystem.warning); // Warning colors
+console.log(colorSystem.error); // Error colors
+console.log(colorSystem.info); // Info colors
+
+// Theme blending
+const blended = blendInHct([64, 196, 255], [255, 87, 34], 'overlay', 0.5);
+console.log(blended); // Blended RGB color
 ```
 
 ## API
@@ -87,3 +114,153 @@ For a given color, get the r, g, b value in string
 ```js
 getRgbStr('#F53F3F') // 245,63,63
 ```
+
+### generateInterfaceColorSystem(primaryColor: string, options?: Object)
+
+Generate a complete interface color system based on a primary color, including semantic colors.
+
+**Parameters:**
+- `primaryColor`: string - Primary color in hex format (e.g., '#3491FA')
+- `options`: Object - Optional configuration
+  - `successBase`: string - Custom success color base, defaults to green
+  - `warningBase`: string - Custom warning color base, defaults to orange
+  - `errorBase`: string - Custom error color base, defaults to red
+  - `infoBase`: string - Custom info color base, defaults to blue
+
+**Returns:**
+- `Object` - Complete color system object
+  - `primary`: string[] - Primary color palette (10 colors)
+  - `success`: string[] - Success color palette (10 colors)
+  - `warning`: string[] - Warning color palette (10 colors)
+  - `error`: string[] - Error color palette (10 colors)
+  - `info`: string[] - Info color palette (10 colors)
+
+```js
+// Generate default interface color system
+const colorSystem = generateInterfaceColorSystem('#3491FA');
+console.log(colorSystem.primary); // Primary color palette
+console.log(colorSystem.success); // Success color palette
+
+// Custom semantic color bases
+const customColorSystem = generateInterfaceColorSystem('#3491FA', {
+  successBase: '#00C853',
+  warningBase: '#FF9800',
+  errorBase: '#F44336',
+  infoBase: '#2196F3'
+});
+```
+
+### rgbToHct(rgb: number[])
+
+Convert RGB color to HCT color space.
+
+**Parameters:**
+- `rgb`: number[] - RGB color array [r, g, b], range 0-255
+
+**Returns:**
+- `number[]` - HCT color array [h, c, t], hue(0-360), chroma(0-100+), tone(0-100)
+
+### hctToRgb(hct: number[])
+
+Convert HCT color to RGB color space.
+
+**Parameters:**
+- `hct`: number[] - HCT color array [h, c, t]
+
+**Returns:**
+- `number[]` - RGB color array [r, g, b], range 0-255
+
+### blendInHct(color1: number[], color2: number[], mode: string, ratio: number)
+
+Blend two colors in HCT color space.
+
+**Parameters:**
+- `color1`: number[] - First color RGB array
+- `color2`: number[] - Second color RGB array
+- `mode`: string - Blend mode: 'multiply', 'screen', 'overlay', 'softLight'
+- `ratio`: number - Blend ratio, range 0-1
+
+**Returns:**
+- `number[]` - Blended RGB color array
+
+```js
+// RGB to HCT conversion
+const hct = rgbToHct([64, 196, 255]);
+console.log(hct); // [200, 45, 80]
+
+// HCT to RGB conversion
+const rgb = hctToRgb([200, 45, 80]);
+console.log(rgb); // [64, 196, 255]
+
+// Color blending
+const blended = blendInHct(
+  [64, 196, 255],  // Blue
+  [255, 87, 34],   // Orange
+  'overlay',       // Overlay mode
+  0.5              // 50% blend
+);
+console.log(blended); // Blended color
+
+// Different blend modes
+const multiply = blendInHct([255, 0, 0], [0, 255, 0], 'multiply', 0.5);
+const screen = blendInHct([255, 0, 0], [0, 255, 0], 'screen', 0.5);
+const softLight = blendInHct([255, 0, 0], [0, 255, 0], 'softLight', 0.5);
+```
+
+### extractColorFromImage(image: HTMLImageElement)
+
+Extract dominant color from a loaded image element.
+
+**Parameters:**
+- `image`: HTMLImageElement - Loaded image element
+
+**Returns:**
+- `Promise<string>` - Extracted dominant color (hex format)
+
+```js
+const image = document.getElementById('myImage');
+extractColorFromImage(image).then(color => {
+  console.log('Extracted color:', color);
+  // Generate palette from extracted color
+  const palette = generate(color, { list: true });
+});
+```
+
+### extractColorFromFile(file: File)
+
+Read image from file object and extract dominant color.
+
+**Parameters:**
+- `file`: File - Image file object
+
+**Returns:**
+- `Promise<string>` - Extracted dominant color (hex format)
+
+```js
+// Use in file input event
+document.getElementById('fileInput').addEventListener('change', (event) => {
+  const file = event.target.files[0];
+  if (file) {
+    extractColorFromFile(file).then(color => {
+      console.log('Extracted color:', color);
+    });
+  }
+});
+```
+
+## Version History
+
+### v0.2.0 (Latest)
+- ✨ Added interface color system functionality
+- ✨ Added HCT color space-based theme blending
+- 📚 Enhanced API documentation and examples
+- 🔧 Optimized code structure and performance
+
+### v0.1.1
+- 🐛 Fixed edge cases in color palette generation
+- 📚 Updated documentation and examples
+
+### v0.1.0
+- 🎉 Initial release
+- ✨ Color palette generation
+- ✨ Image color extraction

package/README.zh-CN.md

@@ -1,13 +1,15 @@
 # ArcoDesign Color
 
-ArcoDesign Color Utils - 一个强大的颜色处理工具库。
+Aviala Design Color - 一个强大的颜色处理工具库。
 
 ## 功能概述
 
-本库提供两大核心功能：
+本库提供四大核心功能：
 
 1. **色盘生成**：根据给定颜色通过算法生成包含十个颜色的梯度色板，支持亮色模式和暗色模式。
 2. **图片取色**：从图片中提取主色调，可用于生成与图片匹配的调色板或主题色。
+3. **界面色彩系统**：基于主色生成完整的界面色彩系统，包括语义色彩（成功、警告、错误、信息）。
+4. **主题混合**：基于 HCT 色彩空间的高级主题混合功能，支持多种混合模式。
 
 ## 安装
 
@@ -17,7 +19,16 @@ npm install @aviala-design/color```
 ## 基本使用
 
 ```js
-import { generate, getPresetColors, getRgbStr, extractColorFromImage } from '@arco-design/color';
+import { 
+  generate, 
+  getPresetColors, 
+  getRgbStr, 
+  extractColorFromImage,
+  generateInterfaceColorSystem,
+  blendInHct,
+  rgbToHct,
+  hctToRgb
+} from '@aviala-design/color';
 
 // 生成色盘
 const colorPalette = generate('#3491FA', { list: true });
@@ -32,6 +43,17 @@ console.log(arcoblue.primary); // arco蓝的主色
 // 获取RGB字符串
 const rgbStr = getRgbStr('#F53F3F');
 console.log(rgbStr); // 245,63,63
+
+// 生成界面色彩系统
+const colorSystem = generateInterfaceColorSystem('#3491FA');
+console.log(colorSystem.success); // 成功色
+console.log(colorSystem.warning); // 警告色
+console.log(colorSystem.error); // 错误色
+console.log(colorSystem.info); // 信息色
+
+// 主题混合
+const blended = blendInHct([64, 196, 255], [255, 87, 34], 'overlay', 0.5);
+console.log(blended); // 混合后的RGB颜色
 ```
 
 ## API 详解
@@ -171,6 +193,109 @@ document.getElementById('fileInput').addEventListener('change', (event) => {
 });
 ```
 
+### 界面色彩系统功能
+
+#### generateInterfaceColorSystem(primaryColor: string, options?: Object)
+
+基于主色生成完整的界面色彩系统，包括语义色彩。
+
+**参数：**
+- `primaryColor`: string - 主色，支持十六进制格式（如 '#3491FA'）
+- `options`: Object - 可选配置项
+  - `successBase`: string - 自定义成功色基础色，默认为绿色
+  - `warningBase`: string - 自定义警告色基础色，默认为橙色
+  - `errorBase`: string - 自定义错误色基础色，默认为红色
+  - `infoBase`: string - 自定义信息色基础色，默认为蓝色
+
+**返回值：**
+- `Object` - 包含完整色彩系统的对象
+  - `primary`: string[] - 主色色盘（10个颜色）
+  - `success`: string[] - 成功色色盘（10个颜色）
+  - `warning`: string[] - 警告色色盘（10个颜色）
+  - `error`: string[] - 错误色色盘（10个颜色）
+  - `info`: string[] - 信息色色盘（10个颜色）
+
+**示例：**
+
+```js
+// 生成默认界面色彩系统
+const colorSystem = generateInterfaceColorSystem('#3491FA');
+console.log(colorSystem.primary); // 主色色盘
+console.log(colorSystem.success); // 成功色色盘
+console.log(colorSystem.warning); // 警告色色盘
+console.log(colorSystem.error); // 错误色色盘
+console.log(colorSystem.info); // 信息色色盘
+
+// 自定义语义色基础色
+const customColorSystem = generateInterfaceColorSystem('#3491FA', {
+  successBase: '#00C853',
+  warningBase: '#FF9800',
+  errorBase: '#F44336',
+  infoBase: '#2196F3'
+});
+```
+
+### 主题混合功能
+
+#### rgbToHct(rgb: number[])
+
+将 RGB 颜色转换为 HCT 色彩空间。
+
+**参数：**
+- `rgb`: number[] - RGB 颜色数组 [r, g, b]，范围 0-255
+
+**返回值：**
+- `number[]` - HCT 颜色数组 [h, c, t]，色相(0-360)、色度(0-100+)、色调(0-100)
+
+#### hctToRgb(hct: number[])
+
+将 HCT 颜色转换为 RGB 色彩空间。
+
+**参数：**
+- `hct`: number[] - HCT 颜色数组 [h, c, t]
+
+**返回值：**
+- `number[]` - RGB 颜色数组 [r, g, b]，范围 0-255
+
+#### blendInHct(color1: number[], color2: number[], mode: string, ratio: number)
+
+在 HCT 色彩空间中混合两个颜色。
+
+**参数：**
+- `color1`: number[] - 第一个颜色的 RGB 数组
+- `color2`: number[] - 第二个颜色的 RGB 数组
+- `mode`: string - 混合模式，可选值：'multiply'、'screen'、'overlay'、'softLight'
+- `ratio`: number - 混合比例，范围 0-1
+
+**返回值：**
+- `number[]` - 混合后的 RGB 颜色数组
+
+**示例：**
+
+```js
+// RGB 到 HCT 转换
+const hct = rgbToHct([64, 196, 255]);
+console.log(hct); // [200, 45, 80]
+
+// HCT 到 RGB 转换
+const rgb = hctToRgb([200, 45, 80]);
+console.log(rgb); // [64, 196, 255]
+
+// 颜色混合
+const blended = blendInHct(
+  [64, 196, 255],  // 蓝色
+  [255, 87, 34],   // 橙色
+  'overlay',       // 叠加模式
+  0.5              // 50% 混合
+);
+console.log(blended); // 混合后的颜色
+
+// 不同混合模式示例
+const multiply = blendInHct([255, 0, 0], [0, 255, 0], 'multiply', 0.5);
+const screen = blendInHct([255, 0, 0], [0, 255, 0], 'screen', 0.5);
+const softLight = blendInHct([255, 0, 0], [0, 255, 0], 'softLight', 0.5);
+```
+
 ## 实现原理
 
 ### 色盘生成算法
@@ -190,3 +315,42 @@ document.getElementById('fileInput').addEventListener('change', (event) => {
 2. **像素量化**：将RGB颜色空间从256^3种可能的颜色减少到16^3种
 3. **颜色频率统计**：统计每种颜色的出现频率
 4. **主色调提取**：过滤掉灰色和接近白色/黑色的颜色，选择出现频率最高的颜色
+
+### 界面色彩系统算法
+
+界面色彩系统基于色彩理论和无障碍访问性原则：
+
+1. **语义色彩映射**：将功能语义（成功、警告、错误、信息）映射到合适的色相区域
+2. **色彩调和**：确保生成的语义色彩与主色形成和谐的色彩关系
+3. **对比度优化**：自动调整颜色的明度以满足 WCAG 无障碍访问标准
+4. **一致性保证**：所有语义色彩使用相同的饱和度和明度调整算法
+
+### 主题混合算法
+
+主题混合功能基于 Material Design 3 的 HCT 色彩空间：
+
+1. **HCT 色彩空间**：使用色相(Hue)、色度(Chroma)、色调(Tone)三个维度描述颜色
+2. **感知均匀性**：HCT 空间在视觉感知上更加均匀，混合结果更自然
+3. **多种混合模式**：
+   - **multiply**: 相乘混合，产生更深的颜色
+   - **screen**: 屏幕混合，产生更亮的颜色
+   - **overlay**: 叠加混合，结合相乘和屏幕的效果
+   - **softLight**: 柔光混合，产生柔和的混合效果
+4. **比例控制**：支持精确的混合比例控制，实现渐进式颜色过渡
+
+## 版本历史
+
+### v0.2.0 (最新)
+- ✨ 新增界面色彩系统功能
+- ✨ 新增基于 HCT 色彩空间的主题混合功能
+- 📚 完善 API 文档和使用示例
+- 🔧 优化代码结构和性能
+
+### v0.1.1
+- 🐛 修复色盘生成的边界情况
+- 📚 更新文档和示例
+
+### v0.1.0
+- 🎉 初始版本发布
+- ✨ 色盘生成功能
+- ✨ 图片取色功能

package/dist/index.d.ts

@@ -1,6 +1,8 @@
 import { default as generate } from './generate.js';
 import { getRgbStr } from './utils.js';
 import { extractColorFromImage, extractColorFromFile } from './image-color.js';
+import { generateLinear, generateGrayLinear, generateMonochromeLinear, generateLinearHSL } from './linear.js';
+import { rgbToHct, hctToRgb, blendInHct, harmonizeColor, generateThemeVariants, blendSemanticColors, blendUIColors, generateThemePalette, generateControlColors, generateSemanticColors, generateThemeColors, generateInterfaceColorSystem } from './theme-blend.js';
 export namespace colorList {
     let red: string;
     let orangered: string;
@@ -23,4 +25,4 @@ export function getPresetColors(): {
         primary: string;
     };
 };
-export { generate, getRgbStr, extractColorFromImage, extractColorFromFile };
+export { generate, getRgbStr, extractColorFromImage, extractColorFromFile, generateLinear, generateGrayLinear, generateMonochromeLinear, generateLinearHSL, rgbToHct, hctToRgb, blendInHct, harmonizeColor, generateThemeVariants, blendSemanticColors, blendUIColors, generateThemePalette, generateControlColors, generateSemanticColors, generateThemeColors, generateInterfaceColorSystem };

package/dist/index.js

@@ -1 +1 @@
-(function(h,f){typeof exports=="object"&&typeof module<"u"?f(exports,require("color")):typeof define=="function"&&define.amd?define(["exports","color"],f):(h=typeof globalThis<"u"?globalThis:h||self,f(h.AvialaColor={},h.Color))})(this,function(h,f){"use strict";function P(t){return f(t).rgb().round().color.join(",")}const E=["hex","rgb","hsl"];function A(t){return!t||E.indexOf(t)<0?"hex":t}function D(t,e){const o=A(e);return o==="hex"?t[o]():t[o]().round().string()}function x(t,e,o){const a=f(t),r=a.hue(),n=a.saturationv(),s=a.value(),c=(l=>l>=60&&l<=240?2.5:l>=0&&l<60||l>300&&l<=360?1.5:2)(r),w=100,p=9,m=100,u=30;function b(l,d){let g;return r>=60&&r<=240?g=l?r-c*d:r+c*d:g=l?r+c*d:r-c*d,g<0?g+=360:g>=360&&(g-=360),Math.round(g)}function z(l,d){let g;if(l)g=n<=p?n:n-(n-p)/5.5*Math.pow(d,1.05);else{const O=Math.min(w,n+30);g=n+(O-n)/4.2*Math.pow(d,.95)}return Math.max(0,Math.min(100,g))}function H(l,d){return l?Math.min(m,s+(m-s)/5.2*Math.pow(d,.9)):s<=u?s:Math.max(u,s-(s-u)/4.2*Math.pow(d,1.05))}const M=e<6,S=M?6-e:e-6,L=e===6?a:f({h:b(M,S),s:z(M,S),v:H(M,S)});return D(L,o)}function v(t,e,o){const a=f(x(t,10-e+1)),r=f(t),n=r.hue(),s=r.saturationv(),c=f({h:r.hue(),s:m(6),v:r.value()}).saturationv(),w=Math.ceil((c-9)/4),p=Math.ceil((100-c)/5);function m(b){if(b<6)return c+(6-b)*p;if(b===6){if(n>=0&&n<50)return s-15;if(n>=50&&n<191)return s-20;if(n>=191&&n<=360)return s-15}return c-w*(b-6)}const u=f({h:a.hue(),s:m(e),v:a.value()});return D(u,o)}function y(t,e={}){const{dark:o,list:a,index:r=6,format:n="hex"}=e;if(a){const s=[],i=o?v:x;for(let c=1;c<=10;c++)s.push(i(t,c,n));return s}return o?v(t,r,n):x(t,r,n)}async function C(t){try{const e=await B(t),o=I(e);return q(o)}catch(e){throw console.error("提取图片颜色失败:",e),e}}async function B(t){return new Promise((e,o)=>{try{const a=document.createElement("canvas"),r=a.getContext("2d"),n=Math.min(t.width,100),s=Math.min(t.height,100),i=Math.min(n/t.width,s/t.height);a.width=t.width*i,a.height=t.height*i,r.drawImage(t,0,0,a.width,a.height);const c=r.getImageData(0,0,a.width,a.height);e(c)}catch(a){o(a)}})}function I(t){const e=t.data,o=new Map;for(let r=0;r<e.length;r+=4){const n=e[r],s=e[r+1],i=e[r+2];if(e[r+3]<128)continue;const w=Math.round(n/16)*16,p=Math.round(s/16)*16,m=Math.round(i/16)*16,u=`${w},${p},${m}`;o.has(u)?o.set(u,o.get(u)+1):o.set(u,1)}const a=[];return o.forEach((r,n)=>{const[s,i,c]=n.split(",").map(Number);a.push({r:s,g:i,b:c,count:r})}),a}function q(t){t.sort((r,n)=>n.count-r.count);const e=t.filter(r=>{const{r:n,g:s,b:i}=r,c=Math.max(n,s,i),w=Math.min(n,s,i),p=c-w,m=c===0?0:p/c,u=c/255;return m>.15&&u>.2&&u<.8}),o=e.length>0?e[0]:t[0];return f({r:o.r,g:o.g,b:o.b}).hex()}function N(t){return new Promise((e,o)=>{if(!t.type.startsWith("image/")){o(new Error("请选择图片文件"));return}const a=new FileReader;a.onload=async r=>{try{const n=new Image;n.onload=async()=>{try{const s=await C(n);e(s)}catch(s){o(s)}},n.onerror=()=>o(new Error("图片加载失败")),n.src=r.target.result}catch(n){o(n)}},a.onerror=()=>o(new Error("文件读取失败")),a.readAsDataURL(t)})}const F={red:"#F53F3F",orangered:"#F77234",orange:"#FF7D00",gold:"#F7BA1E",yellow:"#FADC19",lime:"#9FDB1D",green:"#00B42A",cyan:"#14C9C9",blue:"#3491FA",arcoblue:"#165DFF",purple:"#722ED1",pinkpurple:"#D91AD9",magenta:"#F5319D"};function R(){const t={};return Object.keys(F).forEach(e=>{t[e]={},t[e].light=y(F[e],{list:!0}),t[e].dark=y(F[e],{list:!0,dark:!0}),t[e].primary=F[e]}),t.gray={},t.gray.light=["#f7f8fa","#f2f3f5","#e5e6eb","#c9cdd4","#a9aeb8","#86909c","#6b7785","#4e5969","#272e3b","#1d2129"],t.gray.dark=["#17171a","#2e2e30","#484849","#5f5f60","#78787a","#929293","#ababac","#c5c5c5","#dfdfdf","#f6f6f6"],t.gray.primary=t.gray.light[6],t}h.colorList=F,h.extractColorFromFile=N,h.extractColorFromImage=C,h.generate=y,h.getPresetColors=R,h.getRgbStr=P,Object.defineProperty(h,Symbol.toStringTag,{value:"Module"})});
+(function(f,g){typeof exports=="object"&&typeof module<"u"?g(exports,require("color")):typeof define=="function"&&define.amd?define(["exports","color"],g):(f=typeof globalThis<"u"?globalThis:f||self,g(f.AvialaColor={},f.Color))})(this,function(f,g){"use strict";function O(t){return g(t).rgb().round().color.join(",")}const q=["hex","rgb","hsl"];function N(t){return!t||q.indexOf(t)<0?"hex":t}function E(t,r){const s=N(r);return s==="hex"?t[s]().toLowerCase():t[s]().round().string()}function R(t,r,s){const n=g(t),e=n.hue(),o=n.saturationv(),a=n.value(),c=(M=>M>=60&&M<=240?2.5:M>=0&&M<60||M>300&&M<=360?1.5:2)(e),l=100,d=9,h=100,u=30;function m(M,w){let S;return e>=60&&e<=240?S=M?e-c*w:e+c*w:S=M?e+c*w:e-c*w,S<0?S+=360:S>=360&&(S-=360),Math.round(S)}function b(M,w){let S;if(M)S=o<=d?o:o-(o-d)/5.5*Math.pow(w,1.05);else{const tt=Math.min(l,o+30);S=o+(tt-o)/4.2*Math.pow(w,.95)}return Math.max(0,Math.min(100,S))}function p(M,w){return M?Math.min(h,a+(h-a)/5.2*Math.pow(w,.9)):a<=u?a:Math.max(u,a-(a-u)/4.2*Math.pow(w,1.05))}const y=r<6,x=y?6-r:r-6,D=r===6?n:g({h:m(y,x),s:b(y,x),v:p(y,x)});return E(D,s)}function T(t,r,s){const n=g(R(t,10-r+1)),e=g(t),o=e.hue(),a=e.saturationv(),c=g({h:e.hue(),s:h(6),v:e.value()}).saturationv(),l=Math.ceil((c-9)/4),d=Math.ceil((100-c)/5);function h(m){if(m<6)return c+(6-m)*d;if(m===6){if(o>=0&&o<50)return a-15;if(o>=50&&o<191)return a-20;if(o>=191&&o<=360)return a-15}return c-l*(m-6)}const u=g({h:n.hue(),s:h(r),v:n.value()});return E(u,s)}function v(t,r={}){const{dark:s,list:n,index:e=6,format:o="hex"}=r;if(n){const a=[],i=s?T:R;for(let c=1;c<=10;c++)a.push(i(t,c,o));return a}return s?T(t,e,o):R(t,e,o)}async function P(t){try{const r=await j(t),s=U(r);return K(s)}catch(r){throw console.error("提取图片颜色失败:",r),r}}async function j(t){return new Promise((r,s)=>{try{const n=document.createElement("canvas"),e=n.getContext("2d"),o=Math.min(t.width,100),a=Math.min(t.height,100),i=Math.min(o/t.width,a/t.height);n.width=t.width*i,n.height=t.height*i,e.drawImage(t,0,0,n.width,n.height);const c=e.getImageData(0,0,n.width,n.height);r(c)}catch(n){s(n)}})}function U(t){const r=t.data,s=new Map;for(let e=0;e<r.length;e+=4){const o=r[e],a=r[e+1],i=r[e+2];if(r[e+3]<128)continue;const l=Math.round(o/16)*16,d=Math.round(a/16)*16,h=Math.round(i/16)*16,u=`${l},${d},${h}`;s.has(u)?s.set(u,s.get(u)+1):s.set(u,1)}const n=[];return s.forEach((e,o)=>{const[a,i,c]=o.split(",").map(Number);n.push({r:a,g:i,b:c,count:e})}),n}function K(t){t.sort((e,o)=>o.count-e.count);const r=t.filter(e=>{const{r:o,g:a,b:i}=e,c=Math.max(o,a,i),l=Math.min(o,a,i),d=c-l,h=c===0?0:d/c,u=c/255;return h>.15&&u>.2&&u<.8}),s=r.length>0?r[0]:t[0];return g({r:s.r,g:s.g,b:s.b}).hex()}function W(t){return new Promise((r,s)=>{if(!t.type.startsWith("image/")){s(new Error("请选择图片文件"));return}const n=new FileReader;n.onload=async e=>{try{const o=new Image;o.onload=async()=>{try{const a=await P(o);r(a)}catch(a){s(a)}},o.onerror=()=>s(new Error("图片加载失败")),o.src=e.target.result}catch(o){s(o)}},n.onerror=()=>s(new Error("文件读取失败")),n.readAsDataURL(t)})}function I(t,r,s={}){const{steps:n=10,format:e="hex",includeEnds:o=!0}=s;if(n<2)throw new Error("步数必须至少为2");const a=g(t),i=g(r),c=[],l=o?n:n+2,d=1/(l-1);for(let h=0;h<l;h++){const u=h*d,m=Math.round(a.red()+(i.red()-a.red())*u),b=Math.round(a.green()+(i.green()-a.green())*u),p=Math.round(a.blue()+(i.blue()-a.blue())*u),y=g({r:m,g:b,b:p});!o&&(h===0||h===l-1)||c.push(E(y,e))}return c}function J(t={}){const{startGray:r="#ffffff",endGray:s="#000000",steps:n=10,format:e="hex"}=t;return I(r,s,{steps:n,format:e,includeEnds:!0})}function Q(t,r={}){const{steps:s=10,format:n="hex",lightnessRange:e=80}=r,a=g(t).hsl(),i=a.lightness(),c=Math.min(95,i+e/2),l=Math.max(5,i-e/2),d=g({h:a.hue(),s:a.saturationl(),l:c}),h=g({h:a.hue(),s:a.saturationl(),l});return I(d.hex(),h.hex(),{steps:s,format:n,includeEnds:!0})}function X(t,r,s={}){const{steps:n=10,format:e="hex",includeEnds:o=!0}=s;if(n<2)throw new Error("步数必须至少为2");const a=g(t).hsl(),i=g(r).hsl(),c=[],l=o?n:n+2,d=1/(l-1);let h=a.hue()||0,u=i.hue()||0;const m=u-h;Math.abs(m)>180&&(m>0?h+=360:u+=360);for(let b=0;b<l;b++){const p=b*d;let y=h+(u-h)*p;const x=a.saturationl()+(i.saturationl()-a.saturationl())*p,D=a.lightness()+(i.lightness()-a.lightness())*p;y=y%360,y<0&&(y+=360);const M=g({h:y,s:x,l:D});!o&&(b===0||b===l-1)||c.push(E(M,e))}return c}function C(t){const r=t.replace("#",""),s=parseInt(r.substr(0,2),16)/255,n=parseInt(r.substr(2,2),16)/255,e=parseInt(r.substr(4,2),16)/255,o=Math.max(s,n,e),a=Math.min(s,n,e),i=o-a;let c=0;i!==0&&(o===s?c=(n-e)/i%6:o===n?c=(e-s)/i+2:c=(s-n)/i+4),c=Math.round(c*60),c<0&&(c+=360);const l=Math.round((.299*s+.587*n+.114*e)*100),d=(o+a)/2,h=i===0?0:i/(1-Math.abs(2*d-1)),u=Math.round(h*Math.min(l,100-l));return{h:c,c:u,t:l}}function H(t){const{h:r,c:s,t:n}=t,e=(r%360+360)%360,o=Math.max(0,Math.min(150,s)),a=Math.max(0,Math.min(100,n)),i=a/100,c=a===0||a===100?0:o/Math.min(a,100-a),l=(1-Math.abs(2*i-1))*Math.min(1,c),d=l*(1-Math.abs(e/60%2-1)),h=i-l/2;let u,m,b;e>=0&&e<60?[u,m,b]=[l,d,0]:e>=60&&e<120?[u,m,b]=[d,l,0]:e>=120&&e<180?[u,m,b]=[0,l,d]:e>=180&&e<240?[u,m,b]=[0,d,l]:e>=240&&e<300?[u,m,b]=[d,0,l]:[u,m,b]=[l,0,d];const p=y=>{const x=Math.max(0,Math.min(1,y+h)),D=Math.round(x*255).toString(16);return D.length===1?"0"+D:D};return`#${p(u)}${p(m)}${p(b)}`}function L(t,r,s=.5){const n=C(t),e=C(r);let o=n.h,a=e.h,i=a-o;Math.abs(i)>180&&(i>0?o+=360:a+=360);const c=(o+(a-o)*s)%360,l=n.c+(e.c-n.c)*s,d=n.t+(e.t-n.t)*s;return H({h:c<0?c+360:c,c:Math.max(0,Math.round(l)),t:Math.max(0,Math.min(100,Math.round(d)))})}function A(t,r,s=.15){const n=C(t),e=C(r);let o=e.h,a=n.h,i=a-o;Math.abs(i)>180&&(i>0?o+=360:a+=360,i=a-o);const c=(o+i*s)%360;return H({h:c<0?c+360:c,c:e.c,t:e.t})}function k(t,r=[10,20,30,40,50,60,70,80,90]){const s=C(t);let n;return Array.isArray(r)?n=r:r&&r.tones&&Array.isArray(r.tones)?n=r.tones:n=[10,20,30,40,50,60,70,80,90],n.map(e=>H({h:s.h,c:s.c,t:e}))}function z(t,r,s=.15){const n={};for(const[e,o]of Object.entries(r))n[e]=A(t,o,s);return n}function $(t,r,s=.2){const n={};for(const[e,o]of Object.entries(r))n[e]=L(t,o,s);return n}function B(t,r={}){const{baseGray:s="#666666"}=r,{blendRatio:n=.08,isDark:e=!1}=r,o=C(s),a={};return(e?[95,90,85,80,70,60,50,40,30,20,15,10]:[10,15,20,30,40,50,60,70,80,85,90,95]).forEach((c,l)=>{const d={h:o.h,c:o.c,t:c},h=L(H(d),t,n);a[`gray-${l+1}`]=h}),a}function V(t,r={}){const{semanticColors:s={success:"#52c41a",warning:"#faad14",error:"#ff4d4f",info:"#1890ff"},blendRatio:n=.12,isDark:e=!1}=r,o={};return Object.entries(s).forEach(([a,i])=>{const c={},l=C(i);(e?[90,80,70,60,50,40,30,25,20,15]:[15,25,35,45,55,65,75,85,90,95]).forEach((h,u)=>{const m={h:l.h,c:l.c,t:h},b=L(H(m),t,n);c[`${a}-${u+1}`]=b}),Object.assign(o,c)}),o}function G(t,r={}){const{isDark:s=!1}=r,n=C(t),e={};return(s?[90,80,70,60,50,40,30,25,20,15]:[15,25,35,45,55,65,75,85,90,95]).forEach((a,i)=>{const c={h:n.h,c:n.c,t:a};e[`theme-${i+1}`]=H(c)}),e}function Y(t,r={}){const{baseGray:s="#666666",isDark:n=!1,semanticColors:e,controlBlendRatio:o=.08,semanticBlendRatio:a=.12}=r;return{controls:B(t,{baseGray:s,blendRatio:o,isDark:n}),semantic:V(t,{semanticColors:e,blendRatio:a,isDark:n}),theme:G(t,{isDark:n})}}function Z(t,r={}){const{semanticColors:s={success:"#4caf50",warning:"#ff9800",error:"#f44336",info:"#2196f3"},uiColors:n={primary:t,"primary-light":"#ffffff","primary-lighter":"#f8f9ff","primary-dark":"#000000","primary-darker":"#0a0a0a",accent:"#722ed1","neutral-1":"#f7f8fa","neutral-2":"#f2f3f5","neutral-3":"#e5e6eb","neutral-4":"#c9cdd4","neutral-5":"#a9aeb8","neutral-6":"#86909c",background:"#ffffff",surface:"#f8f9fa",border:"#e5e6eb",disabled:"#c9cdd4"},harmonizeRatio:e=.15,blendRatio:o=.12,generateVariants:a=!0}=r,i={theme:t,semantic:z(t,s,e),ui:$(t,n,o)};return a&&(i.variants=k(t)),i}const F={red:"#F53F3F",orangered:"#F77234",orange:"#FF7D00",gold:"#F7BA1E",yellow:"#FADC19",lime:"#9FDB1D",green:"#00B42A",cyan:"#14C9C9",blue:"#3491FA",arcoblue:"#165DFF",purple:"#722ED1",pinkpurple:"#D91AD9",magenta:"#F5319D"};function _(){const t={};return Object.keys(F).forEach(r=>{t[r]={},t[r].light=v(F[r],{list:!0}),t[r].dark=v(F[r],{list:!0,dark:!0}),t[r].primary=F[r]}),t.gray={},t.gray.light=["#f7f8fa","#f2f3f5","#e5e6eb","#c9cdd4","#a9aeb8","#86909c","#6b7785","#4e5969","#272e3b","#1d2129"],t.gray.dark=["#17171a","#2e2e30","#484849","#5f5f60","#78787a","#929293","#ababac","#c5c5c5","#dfdfdf","#f6f6f6"],t.gray.primary=t.gray.light[6],t}f.blendInHct=L,f.blendSemanticColors=z,f.blendUIColors=$,f.colorList=F,f.extractColorFromFile=W,f.extractColorFromImage=P,f.generate=v,f.generateControlColors=B,f.generateGrayLinear=J,f.generateInterfaceColorSystem=Y,f.generateLinear=I,f.generateLinearHSL=X,f.generateMonochromeLinear=Q,f.generateSemanticColors=V,f.generateThemeColors=G,f.generateThemePalette=Z,f.generateThemeVariants=k,f.getPresetColors=_,f.getRgbStr=O,f.harmonizeColor=A,f.hctToRgb=H,f.rgbToHct=C,Object.defineProperty(f,Symbol.toStringTag,{value:"Module"})});

package/dist/index.mjs

@@ -1,144 +1,350 @@
 import m from "color";
-function R(t) {
+function W(t) {
   return m(t).rgb().round().color.join(",");
 }
-const B = ["hex", "rgb", "hsl"];
-function A(t) {
-  return !t || B.indexOf(t) < 0 ? "hex" : t;
+const A = ["hex", "rgb", "hsl"];
+function P(t) {
+  return !t || A.indexOf(t) < 0 ? "hex" : t;
 }
-function S(t, n) {
-  const o = A(n);
-  return o === "hex" ? t[o]() : t[o]().round().string();
+function F(t, r) {
+  const a = P(r);
+  return a === "hex" ? t[a]().toLowerCase() : t[a]().round().string();
 }
-function F(t, n, o) {
-  const a = m(t), e = a.hue(), r = a.saturationv(), s = a.value(), c = ((l) => l >= 60 && l <= 240 ? 2.5 : l >= 0 && l < 60 || l > 300 && l <= 360 ? 1.5 : 2)(e), p = 100, d = 9, f = 100, u = 30;
-  function w(l, g) {
-    let h;
-    return e >= 60 && e <= 240 ? h = l ? e - c * g : e + c * g : h = l ? e + c * g : e - c * g, h < 0 ? h += 360 : h >= 360 && (h -= 360), Math.round(h);
+function E(t, r, a) {
+  const e = m(t), n = e.hue(), o = e.saturationv(), s = e.value(), c = ((b) => b >= 60 && b <= 240 ? 2.5 : b >= 0 && b < 60 || b > 300 && b <= 360 ? 1.5 : 2)(n), l = 100, f = 9, h = 100, u = 30;
+  function d(b, w) {
+    let x;
+    return n >= 60 && n <= 240 ? x = b ? n - c * w : n + c * w : x = b ? n + c * w : n - c * w, x < 0 ? x += 360 : x >= 360 && (x -= 360), Math.round(x);
   }
-  function y(l, g) {
-    let h;
-    if (l)
-      h = r <= d ? r : r - (r - d) / 5.5 * Math.pow(g, 1.05);
+  function g(b, w) {
+    let x;
+    if (b)
+      x = o <= f ? o : o - (o - f) / 5.5 * Math.pow(w, 1.05);
     else {
-      const E = Math.min(p, r + 30);
-      h = r + (E - r) / 4.2 * Math.pow(g, 0.95);
+      const k = Math.min(l, o + 30);
+      x = o + (k - o) / 4.2 * Math.pow(w, 0.95);
     }
-    return Math.max(0, Math.min(100, h));
+    return Math.max(0, Math.min(100, x));
   }
-  function v(l, g) {
-    return l ? Math.min(f, s + (f - s) / 5.2 * Math.pow(g, 0.9)) : s <= u ? s : Math.max(u, s - (s - u) / 4.2 * Math.pow(g, 1.05));
+  function M(b, w) {
+    return b ? Math.min(h, s + (h - s) / 5.2 * Math.pow(w, 0.9)) : s <= u ? s : Math.max(u, s - (s - u) / 4.2 * Math.pow(w, 1.05));
   }
-  const x = n < 6, b = x ? 6 - n : n - 6, P = n === 6 ? a : m({
-    h: w(x, b),
-    s: y(x, b),
-    v: v(x, b)
+  const p = r < 6, C = p ? 6 - r : r - 6, S = r === 6 ? e : m({
+    h: d(p, C),
+    s: g(p, C),
+    v: M(p, C)
   });
-  return S(P, o);
+  return F(S, a);
 }
-function C(t, n, o) {
-  const a = m(F(t, 10 - n + 1)), e = m(t), r = e.hue(), s = e.saturationv(), c = m({
-    h: e.hue(),
-    s: f(6),
-    v: e.value()
-  }).saturationv(), p = Math.ceil((c - 9) / 4), d = Math.ceil((100 - c) / 5);
-  function f(w) {
-    if (w < 6)
-      return c + (6 - w) * d;
-    if (w === 6) {
-      if (r >= 0 && r < 50)
+function v(t, r, a) {
+  const e = m(E(t, 10 - r + 1)), n = m(t), o = n.hue(), s = n.saturationv(), c = m({
+    h: n.hue(),
+    s: h(6),
+    v: n.value()
+  }).saturationv(), l = Math.ceil((c - 9) / 4), f = Math.ceil((100 - c) / 5);
+  function h(d) {
+    if (d < 6)
+      return c + (6 - d) * f;
+    if (d === 6) {
+      if (o >= 0 && o < 50)
         return s - 15;
-      if (r >= 50 && r < 191)
+      if (o >= 50 && o < 191)
         return s - 20;
-      if (r >= 191 && r <= 360)
+      if (o >= 191 && o <= 360)
         return s - 15;
     }
-    return c - p * (w - 6);
+    return c - l * (d - 6);
   }
   const u = m({
-    h: a.hue(),
-    s: f(n),
-    v: a.value()
+    h: e.hue(),
+    s: h(r),
+    v: e.value()
   });
-  return S(u, o);
+  return F(u, a);
 }
-function D(t, n = {}) {
-  const { dark: o, list: a, index: e = 6, format: r = "hex" } = n;
-  if (a) {
-    const s = [], i = o ? C : F;
+function I(t, r = {}) {
+  const { dark: a, list: e, index: n = 6, format: o = "hex" } = r;
+  if (e) {
+    const s = [], i = a ? v : E;
     for (let c = 1; c <= 10; c++)
-      s.push(i(t, c, r));
+      s.push(i(t, c, o));
     return s;
   }
-  return o ? C(t, e, r) : F(t, e, r);
+  return a ? v(t, n, o) : E(t, n, o);
 }
-async function I(t) {
+async function $(t) {
   try {
-    const n = await N(t), o = q(n);
-    return z(o);
-  } catch (n) {
-    throw console.error("提取图片颜色失败:", n), n;
+    const r = await z(t), a = B(r);
+    return V(a);
+  } catch (r) {
+    throw console.error("提取图片颜色失败:", r), r;
   }
 }
-async function N(t) {
-  return new Promise((n, o) => {
+async function z(t) {
+  return new Promise((r, a) => {
     try {
-      const a = document.createElement("canvas"), e = a.getContext("2d"), r = Math.min(t.width, 100), s = Math.min(t.height, 100), i = Math.min(r / t.width, s / t.height);
-      a.width = t.width * i, a.height = t.height * i, e.drawImage(t, 0, 0, a.width, a.height);
-      const c = e.getImageData(0, 0, a.width, a.height);
-      n(c);
-    } catch (a) {
-      o(a);
+      const e = document.createElement("canvas"), n = e.getContext("2d"), o = Math.min(t.width, 100), s = Math.min(t.height, 100), i = Math.min(o / t.width, s / t.height);
+      e.width = t.width * i, e.height = t.height * i, n.drawImage(t, 0, 0, e.width, e.height);
+      const c = n.getImageData(0, 0, e.width, e.height);
+      r(c);
+    } catch (e) {
+      a(e);
     }
   });
 }
-function q(t) {
-  const n = t.data, o = /* @__PURE__ */ new Map();
-  for (let e = 0; e < n.length; e += 4) {
-    const r = n[e], s = n[e + 1], i = n[e + 2];
-    if (n[e + 3] < 128) continue;
-    const p = Math.round(r / 16) * 16, d = Math.round(s / 16) * 16, f = Math.round(i / 16) * 16, u = `${p},${d},${f}`;
-    o.has(u) ? o.set(u, o.get(u) + 1) : o.set(u, 1);
+function B(t) {
+  const r = t.data, a = /* @__PURE__ */ new Map();
+  for (let n = 0; n < r.length; n += 4) {
+    const o = r[n], s = r[n + 1], i = r[n + 2];
+    if (r[n + 3] < 128) continue;
+    const l = Math.round(o / 16) * 16, f = Math.round(s / 16) * 16, h = Math.round(i / 16) * 16, u = `${l},${f},${h}`;
+    a.has(u) ? a.set(u, a.get(u) + 1) : a.set(u, 1);
   }
-  const a = [];
-  return o.forEach((e, r) => {
-    const [s, i, c] = r.split(",").map(Number);
-    a.push({ r: s, g: i, b: c, count: e });
-  }), a;
-}
-function z(t) {
-  t.sort((e, r) => r.count - e.count);
-  const n = t.filter((e) => {
-    const { r, g: s, b: i } = e, c = Math.max(r, s, i), p = Math.min(r, s, i), d = c - p, f = c === 0 ? 0 : d / c, u = c / 255;
-    return f > 0.15 && u > 0.2 && u < 0.8;
-  }), o = n.length > 0 ? n[0] : t[0];
-  return m({ r: o.r, g: o.g, b: o.b }).hex();
+  const e = [];
+  return a.forEach((n, o) => {
+    const [s, i, c] = o.split(",").map(Number);
+    e.push({ r: s, g: i, b: c, count: n });
+  }), e;
 }
 function V(t) {
-  return new Promise((n, o) => {
+  t.sort((n, o) => o.count - n.count);
+  const r = t.filter((n) => {
+    const { r: o, g: s, b: i } = n, c = Math.max(o, s, i), l = Math.min(o, s, i), f = c - l, h = c === 0 ? 0 : f / c, u = c / 255;
+    return h > 0.15 && u > 0.2 && u < 0.8;
+  }), a = r.length > 0 ? r[0] : t[0];
+  return m({ r: a.r, g: a.g, b: a.b }).hex();
+}
+function J(t) {
+  return new Promise((r, a) => {
     if (!t.type.startsWith("image/")) {
-      o(new Error("请选择图片文件"));
+      a(new Error("请选择图片文件"));
       return;
     }
-    const a = new FileReader();
-    a.onload = async (e) => {
+    const e = new FileReader();
+    e.onload = async (n) => {
       try {
-        const r = new Image();
-        r.onload = async () => {
+        const o = new Image();
+        o.onload = async () => {
           try {
-            const s = await I(r);
-            n(s);
+            const s = await $(o);
+            r(s);
           } catch (s) {
-            o(s);
+            a(s);
           }
-        }, r.onerror = () => o(new Error("图片加载失败")), r.src = e.target.result;
-      } catch (r) {
-        o(r);
+        }, o.onerror = () => a(new Error("图片加载失败")), o.src = n.target.result;
+      } catch (o) {
+        a(o);
       }
-    }, a.onerror = () => o(new Error("文件读取失败")), a.readAsDataURL(t);
+    }, e.onerror = () => a(new Error("文件读取失败")), e.readAsDataURL(t);
+  });
+}
+function L(t, r, a = {}) {
+  const { steps: e = 10, format: n = "hex", includeEnds: o = !0 } = a;
+  if (e < 2)
+    throw new Error("步数必须至少为2");
+  const s = m(t), i = m(r), c = [], l = o ? e : e + 2, f = 1 / (l - 1);
+  for (let h = 0; h < l; h++) {
+    const u = h * f, d = Math.round(s.red() + (i.red() - s.red()) * u), g = Math.round(s.green() + (i.green() - s.green()) * u), M = Math.round(s.blue() + (i.blue() - s.blue()) * u), p = m({ r: d, g, b: M });
+    !o && (h === 0 || h === l - 1) || c.push(F(p, n));
+  }
+  return c;
+}
+function Q(t = {}) {
+  const {
+    startGray: r = "#ffffff",
+    endGray: a = "#000000",
+    steps: e = 10,
+    format: n = "hex"
+  } = t;
+  return L(r, a, { steps: e, format: n, includeEnds: !0 });
+}
+function X(t, r = {}) {
+  const { steps: a = 10, format: e = "hex", lightnessRange: n = 80 } = r, s = m(t).hsl(), i = s.lightness(), c = Math.min(95, i + n / 2), l = Math.max(5, i - n / 2), f = m({
+    h: s.hue(),
+    s: s.saturationl(),
+    l: c
+  }), h = m({
+    h: s.hue(),
+    s: s.saturationl(),
+    l
+  });
+  return L(f.hex(), h.hex(), { steps: a, format: e, includeEnds: !0 });
+}
+function Y(t, r, a = {}) {
+  const { steps: e = 10, format: n = "hex", includeEnds: o = !0 } = a;
+  if (e < 2)
+    throw new Error("步数必须至少为2");
+  const s = m(t).hsl(), i = m(r).hsl(), c = [], l = o ? e : e + 2, f = 1 / (l - 1);
+  let h = s.hue() || 0, u = i.hue() || 0;
+  const d = u - h;
+  Math.abs(d) > 180 && (d > 0 ? h += 360 : u += 360);
+  for (let g = 0; g < l; g++) {
+    const M = g * f;
+    let p = h + (u - h) * M;
+    const C = s.saturationl() + (i.saturationl() - s.saturationl()) * M, S = s.lightness() + (i.lightness() - s.lightness()) * M;
+    p = p % 360, p < 0 && (p += 360);
+    const b = m({ h: p, s: C, l: S });
+    !o && (g === 0 || g === l - 1) || c.push(F(b, n));
+  }
+  return c;
+}
+function y(t) {
+  const r = t.replace("#", ""), a = parseInt(r.substr(0, 2), 16) / 255, e = parseInt(r.substr(2, 2), 16) / 255, n = parseInt(r.substr(4, 2), 16) / 255, o = Math.max(a, e, n), s = Math.min(a, e, n), i = o - s;
+  let c = 0;
+  i !== 0 && (o === a ? c = (e - n) / i % 6 : o === e ? c = (n - a) / i + 2 : c = (a - e) / i + 4), c = Math.round(c * 60), c < 0 && (c += 360);
+  const l = Math.round((0.299 * a + 0.587 * e + 0.114 * n) * 100), f = (o + s) / 2, h = i === 0 ? 0 : i / (1 - Math.abs(2 * f - 1)), u = Math.round(h * Math.min(l, 100 - l));
+  return { h: c, c: u, t: l };
+}
+function D(t) {
+  const { h: r, c: a, t: e } = t, n = (r % 360 + 360) % 360, o = Math.max(0, Math.min(150, a)), s = Math.max(0, Math.min(100, e)), i = s / 100, c = s === 0 || s === 100 ? 0 : o / Math.min(s, 100 - s), l = (1 - Math.abs(2 * i - 1)) * Math.min(1, c), f = l * (1 - Math.abs(n / 60 % 2 - 1)), h = i - l / 2;
+  let u, d, g;
+  n >= 0 && n < 60 ? [u, d, g] = [l, f, 0] : n >= 60 && n < 120 ? [u, d, g] = [f, l, 0] : n >= 120 && n < 180 ? [u, d, g] = [0, l, f] : n >= 180 && n < 240 ? [u, d, g] = [0, f, l] : n >= 240 && n < 300 ? [u, d, g] = [f, 0, l] : [u, d, g] = [l, 0, f];
+  const M = (p) => {
+    const C = Math.max(0, Math.min(1, p + h)), S = Math.round(C * 255).toString(16);
+    return S.length === 1 ? "0" + S : S;
+  };
+  return `#${M(u)}${M(d)}${M(g)}`;
+}
+function R(t, r, a = 0.5) {
+  const e = y(t), n = y(r);
+  let o = e.h, s = n.h, i = s - o;
+  Math.abs(i) > 180 && (i > 0 ? o += 360 : s += 360);
+  const c = (o + (s - o) * a) % 360, l = e.c + (n.c - e.c) * a, f = e.t + (n.t - e.t) * a;
+  return D({
+    h: c < 0 ? c + 360 : c,
+    c: Math.max(0, Math.round(l)),
+    t: Math.max(0, Math.min(100, Math.round(f)))
   });
 }
-const M = {
+function G(t, r, a = 0.15) {
+  const e = y(t), n = y(r);
+  let o = n.h, s = e.h, i = s - o;
+  Math.abs(i) > 180 && (i > 0 ? o += 360 : s += 360, i = s - o);
+  const c = (o + i * a) % 360;
+  return D({
+    h: c < 0 ? c + 360 : c,
+    c: n.c,
+    // 保持原有色度
+    t: n.t
+    // 保持原有色调
+  });
+}
+function O(t, r = [10, 20, 30, 40, 50, 60, 70, 80, 90]) {
+  const a = y(t);
+  let e;
+  return Array.isArray(r) ? e = r : r && r.tones && Array.isArray(r.tones) ? e = r.tones : e = [10, 20, 30, 40, 50, 60, 70, 80, 90], e.map((n) => D({
+    h: a.h,
+    c: a.c,
+    t: n
+  }));
+}
+function T(t, r, a = 0.15) {
+  const e = {};
+  for (const [n, o] of Object.entries(r))
+    e[n] = G(t, o, a);
+  return e;
+}
+function N(t, r, a = 0.2) {
+  const e = {};
+  for (const [n, o] of Object.entries(r))
+    e[n] = R(t, o, a);
+  return e;
+}
+function q(t, r = {}) {
+  const { baseGray: a = "#666666" } = r, { blendRatio: e = 0.08, isDark: n = !1 } = r, o = y(a), s = {};
+  return (n ? [95, 90, 85, 80, 70, 60, 50, 40, 30, 20, 15, 10] : [10, 15, 20, 30, 40, 50, 60, 70, 80, 85, 90, 95]).forEach((c, l) => {
+    const f = { h: o.h, c: o.c, t: c }, h = R(D(f), t, e);
+    s[`gray-${l + 1}`] = h;
+  }), s;
+}
+function j(t, r = {}) {
+  const {
+    semanticColors: a = {
+      success: "#52c41a",
+      warning: "#faad14",
+      error: "#ff4d4f",
+      info: "#1890ff"
+    },
+    blendRatio: e = 0.12,
+    isDark: n = !1
+  } = r, o = {};
+  return Object.entries(a).forEach(([s, i]) => {
+    const c = {}, l = y(i);
+    (n ? [90, 80, 70, 60, 50, 40, 30, 25, 20, 15] : [15, 25, 35, 45, 55, 65, 75, 85, 90, 95]).forEach((h, u) => {
+      const d = { h: l.h, c: l.c, t: h }, g = R(D(d), t, e);
+      c[`${s}-${u + 1}`] = g;
+    }), Object.assign(o, c);
+  }), o;
+}
+function U(t, r = {}) {
+  const { isDark: a = !1 } = r, e = y(t), n = {};
+  return (a ? [90, 80, 70, 60, 50, 40, 30, 25, 20, 15] : [15, 25, 35, 45, 55, 65, 75, 85, 90, 95]).forEach((s, i) => {
+    const c = { h: e.h, c: e.c, t: s };
+    n[`theme-${i + 1}`] = D(c);
+  }), n;
+}
+function Z(t, r = {}) {
+  const {
+    baseGray: a = "#666666",
+    isDark: e = !1,
+    semanticColors: n,
+    controlBlendRatio: o = 0.08,
+    semanticBlendRatio: s = 0.12
+  } = r;
+  return {
+    // 1. 基础控件颜色（灰色系1-12）
+    controls: q(t, {
+      baseGray: a,
+      blendRatio: o,
+      isDark: e
+    }),
+    // 2. 表意色（1-10）
+    semantic: j(t, {
+      semanticColors: n,
+      blendRatio: s,
+      isDark: e
+    }),
+    // 3. 主题色（1-10）
+    theme: U(t, { isDark: e })
+  };
+}
+function _(t, r = {}) {
+  const {
+    semanticColors: a = {
+      success: "#4caf50",
+      warning: "#ff9800",
+      error: "#f44336",
+      info: "#2196f3"
+    },
+    uiColors: e = {
+      primary: t,
+      "primary-light": "#ffffff",
+      "primary-lighter": "#f8f9ff",
+      "primary-dark": "#000000",
+      "primary-darker": "#0a0a0a",
+      accent: "#722ed1",
+      "neutral-1": "#f7f8fa",
+      "neutral-2": "#f2f3f5",
+      "neutral-3": "#e5e6eb",
+      "neutral-4": "#c9cdd4",
+      "neutral-5": "#a9aeb8",
+      "neutral-6": "#86909c",
+      background: "#ffffff",
+      surface: "#f8f9fa",
+      border: "#e5e6eb",
+      disabled: "#c9cdd4"
+    },
+    harmonizeRatio: n = 0.15,
+    blendRatio: o = 0.12,
+    generateVariants: s = !0
+  } = r, i = {
+    theme: t,
+    semantic: T(t, a, n),
+    ui: N(t, e, o)
+  };
+  return s && (i.variants = O(t)), i;
+}
+const H = {
   red: "#F53F3F",
   orangered: "#F77234",
   orange: "#FF7D00",
@@ -153,10 +359,10 @@ const M = {
   pinkpurple: "#D91AD9",
   magenta: "#F5319D"
 };
-function $() {
+function tt() {
   const t = {};
-  return Object.keys(M).forEach((n) => {
-    t[n] = {}, t[n].light = D(M[n], { list: !0 }), t[n].dark = D(M[n], { list: !0, dark: !0 }), t[n].primary = M[n];
+  return Object.keys(H).forEach((r) => {
+    t[r] = {}, t[r].light = I(H[r], { list: !0 }), t[r].dark = I(H[r], { list: !0, dark: !0 }), t[r].primary = H[r];
   }), t.gray = {}, t.gray.light = [
     "#f7f8fa",
     "#f2f3f5",
@@ -182,10 +388,26 @@ function $() {
   ], t.gray.primary = t.gray.light[6], t;
 }
 export {
-  M as colorList,
-  V as extractColorFromFile,
-  I as extractColorFromImage,
-  D as generate,
-  $ as getPresetColors,
-  R as getRgbStr
+  R as blendInHct,
+  T as blendSemanticColors,
+  N as blendUIColors,
+  H as colorList,
+  J as extractColorFromFile,
+  $ as extractColorFromImage,
+  I as generate,
+  q as generateControlColors,
+  Q as generateGrayLinear,
+  Z as generateInterfaceColorSystem,
+  L as generateLinear,
+  Y as generateLinearHSL,
+  X as generateMonochromeLinear,
+  j as generateSemanticColors,
+  U as generateThemeColors,
+  _ as generateThemePalette,
+  O as generateThemeVariants,
+  tt as getPresetColors,
+  W as getRgbStr,
+  G as harmonizeColor,
+  D as hctToRgb,
+  y as rgbToHct
 };

package/dist/linear.d.ts

@@ -0,0 +1,68 @@
+/**
+ * 线性颜色生成器
+ * 在两个颜色之间进行线性插值，生成指定数量的颜色
+ * 特别适用于灰色系和单色调渐变
+ *
+ * @param {string} startColor - 起始颜色
+ * @param {string} endColor - 结束颜色
+ * @param {Object} options - 配置选项
+ * @param {number} options.steps - 生成的颜色数量 (默认: 10)
+ * @param {string} options.format - 颜色格式 'hex' | 'rgb' | 'hsl' (默认: 'hex')
+ * @param {boolean} options.includeEnds - 是否包含起始和结束颜色 (默认: true)
+ * @returns {string[]} 颜色数组
+ */
+export function generateLinear(startColor: string, endColor: string, options?: {
+    steps: number;
+    format: string;
+    includeEnds: boolean;
+}): string[];
+/**
+ * 生成灰色系线性渐变
+ * 从白色到黑色或指定的灰色范围
+ *
+ * @param {Object} options - 配置选项
+ * @param {string} options.startGray - 起始灰色 (默认: '#ffffff')
+ * @param {string} options.endGray - 结束灰色 (默认: '#000000')
+ * @param {number} options.steps - 生成的颜色数量 (默认: 10)
+ * @param {string} options.format - 颜色格式 (默认: 'hex')
+ * @returns {string[]} 灰色系颜色数组
+ */
+export function generateGrayLinear(options?: {
+    startGray: string;
+    endGray: string;
+    steps: number;
+    format: string;
+}): string[];
+/**
+ * 生成单色调线性渐变
+ * 基于一个基础颜色，生成从浅到深的渐变
+ *
+ * @param {string} baseColor - 基础颜色
+ * @param {Object} options - 配置选项
+ * @param {number} options.steps - 生成的颜色数量 (默认: 10)
+ * @param {string} options.format - 颜色格式 (默认: 'hex')
+ * @param {number} options.lightnessRange - 亮度范围 0-100 (默认: 80)
+ * @returns {string[]} 单色调颜色数组
+ */
+export function generateMonochromeLinear(baseColor: string, options?: {
+    steps: number;
+    format: string;
+    lightnessRange: number;
+}): string[];
+/**
+ * 在HSL空间进行线性插值
+ * 适用于需要更自然色彩过渡的场景
+ *
+ * @param {string} startColor - 起始颜色
+ * @param {string} endColor - 结束颜色
+ * @param {Object} options - 配置选项
+ * @param {number} options.steps - 生成的颜色数量 (默认: 10)
+ * @param {string} options.format - 颜色格式 (默认: 'hex')
+ * @param {boolean} options.includeEnds - 是否包含起始和结束颜色 (默认: true)
+ * @returns {string[]} 颜色数组
+ */
+export function generateLinearHSL(startColor: string, endColor: string, options?: {
+    steps: number;
+    format: string;
+    includeEnds: boolean;
+}): string[];

package/dist/theme-blend.d.ts

@@ -0,0 +1,96 @@
+/**
+ * 生成基础控件颜色（灰色系1-12）
+ * @param {string} themeColor - 主题颜色
+ * @param {Object} options - 配置选项
+ * @returns {Object} 基础控件颜色对象
+ */
+export function generateControlColors(themeColor: string, options?: Object): Object;
+/**
+ * 生成表意色（1-10）
+ * @param {string} themeColor - 主题颜色
+ * @param {Object} options - 配置选项
+ * @returns {Object} 表意色对象
+ */
+export function generateSemanticColors(themeColor: string, options?: Object): Object;
+/**
+ * 生成主题色（1-10）
+ * @param {string} themeColor - 主题颜色
+ * @param {Object} options - 配置选项
+ * @returns {Object} 主题色对象
+ */
+export function generateThemeColors(themeColor: string, options?: Object): Object;
+/**
+ * 生成完整的界面色彩系统
+ * @param {string} themeColor - 主题颜色
+ * @param {Object} options - 配置选项
+ * @returns {Object} 包含三个部分的完整色彩系统
+ */
+export function generateInterfaceColorSystem(themeColor: string, options?: Object): Object;
+/**
+ * 主题色混合模块
+ * 基于 Material Design 3 的 HCT 颜色空间实现颜色混合和调和
+ *
+ * HCT (Hue, Chroma, Tone) 颜色空间结合了 CAM16 和 CIE-Lab 的优势：
+ * - H (Hue): 色相，0-360度
+ * - C (Chroma): 色度，颜色的饱和度
+ * - T (Tone): 色调，亮度从黑色(0)到白色(100)
+ */
+/**
+ * 将 RGB 颜色转换为 HCT 颜色空间
+ * 这是一个简化的实现，实际的 HCT 转换需要复杂的 CAM16 计算
+ * @param {string} rgb - RGB 颜色值，格式如 "#ff0000"
+ * @returns {Object} HCT 颜色对象 {h, c, t}
+ */
+export function rgbToHct(rgb: string): Object;
+/**
+ * 将 HCT 颜色转换为 RGB
+ * @param {Object} hct - HCT 颜色对象 {h, c, t}
+ * @returns {string} RGB 颜色值，格式如 "#ff0000"
+ */
+export function hctToRgb(hct: Object): string;
+/**
+ * 在 HCT 颜色空间中混合两种颜色
+ * @param {string} color1 - 第一种颜色 (RGB)
+ * @param {string} color2 - 第二种颜色 (RGB)
+ * @param {number} ratio - 混合比例，0-1，0表示完全是color1，1表示完全是color2
+ * @returns {string} 混合后的颜色 (RGB)
+ */
+export function blendInHct(color1: string, color2: string, ratio?: number): string;
+/**
+ * 颜色调和 - 让目标颜色向主题色的色相靠拢
+ * @param {string} themeColor - 主题色 (RGB)
+ * @param {string} targetColor - 目标颜色 (RGB)
+ * @param {number} harmonizeRatio - 调和强度，0-1，0表示不调和，1表示完全采用主题色的色相
+ * @returns {string} 调和后的颜色 (RGB)
+ */
+export function harmonizeColor(themeColor: string, targetColor: string, harmonizeRatio?: number): string;
+/**
+ * 生成主题色变体 - 基于主题色生成不同明度的颜色变体
+ * @param {string} themeColor - 主题色 (RGB)
+ * @param {Object|Array} options - 配置选项，可以是对象 {tones: [...]} 或直接传入数组
+ * @returns {Array} 主题色变体数组
+ */
+export function generateThemeVariants(themeColor: string, options?: Object | any[]): any[];
+/**
+ * 表意色混合 - 为成功、警告、错误等状态色添加主题色调
+ * @param {string} themeColor - 主题色
+ * @param {Object} semanticColors - 表意色对象，如 {success: '#4caf50', warning: '#ff9800', error: '#f44336'}
+ * @param {number} blendRatio - 混合强度
+ * @returns {Object} 混合后的表意色对象
+ */
+export function blendSemanticColors(themeColor: string, semanticColors: Object, blendRatio?: number): Object;
+/**
+ * UI 元素颜色混合 - 为按钮、卡片等 UI 元素生成主题化颜色
+ * @param {string} themeColor - 主题色
+ * @param {Object} uiColors - UI 颜色对象
+ * @param {number} blendRatio - 混合强度
+ * @returns {Object} 混合后的 UI 颜色对象
+ */
+export function blendUIColors(themeColor: string, uiColors: Object, blendRatio?: number): Object;
+/**
+ * 生成完整的主题色板
+ * @param {string} themeColor - 主题色
+ * @param {Object} options - 配置选项
+ * @returns {Object} 完整的主题色板
+ */
+export function generateThemePalette(themeColor: string, options?: Object): Object;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aviala-design/color",
-  "version": "0.1.1",
+  "version": "0.2.1",
   "description": "Aviala Design color utils",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",