@cloudcome/utils-core 0.0.0 → 1.1.0

package/dist/base64.mjs

@@ -0,0 +1,16 @@
+function base64toBlob(base64) {
+  const byteString = atob(base64.split(",")[1]);
+  const mimeString = base64.split(",")[0].split(":")[1].split(";")[0];
+  const ab = new ArrayBuffer(byteString.length);
+  const ua = new Uint8Array(ab);
+  for (let i = 0; i < byteString.length; i++) {
+    ua[i] = byteString.charCodeAt(i);
+  }
+  return new Blob([ab], {
+    type: mimeString
+  });
+}
+export {
+  base64toBlob
+};
+//# sourceMappingURL=base64.mjs.map

package/dist/base64.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"base64.mjs","sources":["../src/base64.ts"],"sourcesContent":["/**\n * base64 转换为 Blob 实例\n * @ref http://stackoverflow.com/q/18253378\n * @param base64 {String} base64 编码\n * @returns {Blob}\n */\nexport function base64toBlob(base64: string): Blob {\n  const byteString = atob(base64.split(',')[1]);\n  const mimeString = base64.split(',')[0].split(':')[1].split(';')[0];\n  const ab = new ArrayBuffer(byteString.length);\n  const ua = new Uint8Array(ab);\n\n  for (let i = 0; i < byteString.length; i++) {\n    ua[i] = byteString.charCodeAt(i);\n  }\n\n  return new Blob([ab], {\n    type: mimeString,\n  });\n}\n"],"names":[],"mappings":"AAMO,SAAS,aAAa,QAAsB;AACjD,QAAM,aAAa,KAAK,OAAO,MAAM,GAAG,EAAE,CAAC,CAAC;AAC5C,QAAM,aAAa,OAAO,MAAM,GAAG,EAAE,CAAC,EAAE,MAAM,GAAG,EAAE,CAAC,EAAE,MAAM,GAAG,EAAE,CAAC;AAClE,QAAM,KAAK,IAAI,YAAY,WAAW,MAAM;AACtC,QAAA,KAAK,IAAI,WAAW,EAAE;AAE5B,WAAS,IAAI,GAAG,IAAI,WAAW,QAAQ,KAAK;AAC1C,OAAG,CAAC,IAAI,WAAW,WAAW,CAAC;AAAA,EAAA;AAGjC,SAAO,IAAI,KAAK,CAAC,EAAE,GAAG;AAAA,IACpB,MAAM;AAAA,EAAA,CACP;AACH;"}

package/dist/cache.cjs

@@ -0,0 +1,79 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const core = require("./core.cjs");
+class AbstractCache {
+  isExpired(cached) {
+    return cached.expiredAt > 0 && Date.now() > cached.expiredAt;
+  }
+  normalizeCached(id, data, options) {
+    const { expiredAt = 0, maxAge = 0 } = options || {};
+    const now = Date.now();
+    return {
+      id,
+      data,
+      createdAt: now,
+      expiredAt: expiredAt ? core.dateParse(expiredAt).getTime() : maxAge > 0 ? now + maxAge : 0
+    };
+  }
+  /**
+   * 获取缓存项
+   * @param id 缓存项的唯一标识
+   * @returns 返回缓存项或 null
+   */
+  get(id) {
+    return null;
+  }
+  /**
+   * 设置缓存项
+   * @param id 缓存项的唯一标识
+   * @param data 要缓存的数据
+   * @param options 缓存选项
+   */
+  set(id, data, options) {
+  }
+  /**
+   * 删除缓存项
+   * @param id 缓存项的唯一标识
+   */
+  del(id) {
+  }
+  /**
+   * 清空缓存
+   */
+  clear() {
+  }
+}
+class MemoryCache extends AbstractCache {
+  constructor() {
+    super(...arguments);
+    __publicField(this, "cache", /* @__PURE__ */ new Map());
+  }
+  get(id) {
+    const cached = this.cache.get(id);
+    if (!cached) return null;
+    if (this.isExpired(cached)) {
+      this.del(id);
+      return null;
+    }
+    return cached;
+  }
+  set(id, data, options) {
+    this.cache.set(id, this.normalizeCached(id, data, options));
+  }
+  del(id) {
+    this.cache.delete(id);
+  }
+  clear() {
+    this.cache.clear();
+  }
+}
+function createMemCache() {
+  return new MemoryCache();
+}
+exports.AbstractCache = AbstractCache;
+exports.MemoryCache = MemoryCache;
+exports.createMemCache = createMemCache;
+//# sourceMappingURL=cache.cjs.map

package/dist/cache.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.cjs","sources":["../src/cache.ts"],"sourcesContent":["import { type TDateValue, dateParse } from './date';\nimport type { MaybePromise } from './types';\n\n/**\n * 缓存选项\n */\nexport type TCacheOptions = {\n  /**\n   * 缓存的最大时长（毫秒），为 0 时表示永久缓存\n   */\n  maxAge?: number;\n\n  /**\n   * 缓存的过期时间（时间戳、日期字符串、日期对象等）\n   * 优先级比 maxAge 更高\n   */\n  expiredAt?: TDateValue;\n};\n\n/**\n * 缓存项\n * @template T 缓存数据的类型\n */\nexport type TCached<T> = {\n  /**\n   * 缓存项的唯一标识\n   */\n  id: string;\n  /**\n   * 缓存的数据\n   */\n  data: T;\n  /**\n   * 缓存项的创建时间（时间戳）\n   */\n  createdAt: number;\n  /**\n   * 缓存项的过期时间（时间戳）\n   */\n  expiredAt: number;\n};\n\nexport type TCache<T> = {\n  get(id: string): MaybePromise<TCached<T> | null>;\n\n  set(id: string, data: T, options?: TCacheOptions): MaybePromise<void>;\n\n  del(id: string): MaybePromise<void>;\n};\n\n/**\n * 缓存抽象类\n * @template T 缓存数据的类型\n */\nexport class AbstractCache<T> implements TCache<T> {\n  isExpired(cached: TCached<T>) {\n    return cached.expiredAt > 0 && Date.now() > cached.expiredAt;\n  }\n\n  normalizeCached(id: string, data: T, options?: TCacheOptions): TCached<T> {\n    const { expiredAt = 0, maxAge = 0 } = options || {};\n    const now = Date.now();\n    return {\n      id,\n      data,\n      createdAt: now,\n      expiredAt: expiredAt ? dateParse(expiredAt).getTime() : maxAge > 0 ? now + maxAge : 0,\n    };\n  }\n\n  /**\n   * 获取缓存项\n   * @param id 缓存项的唯一标识\n   * @returns 返回缓存项或 null\n   */\n  get(id: string): MaybePromise<TCached<T> | null> {\n    return null;\n  }\n\n  /**\n   * 设置缓存项\n   * @param id 缓存项的唯一标识\n   * @param data 要缓存的数据\n   * @param options 缓存选项\n   */\n  set(id: string, data: T, options?: TCacheOptions): MaybePromise<void> {\n    //\n  }\n\n  /**\n   * 删除缓存项\n   * @param id 缓存项的唯一标识\n   */\n  del(id: string): MaybePromise<void> {\n    //\n  }\n\n  /**\n   * 清空缓存\n   */\n  clear(): MaybePromise<void> {\n    //\n  }\n}\n\n/**\n * 内存缓存实现类\n * @template T 缓存数据的类型\n */\nexport class MemoryCache<T> extends AbstractCache<T> {\n  private cache: Map<string, TCached<T>> = new Map();\n\n  get(id: string) {\n    const cached = this.cache.get(id);\n\n    if (!cached) return null;\n\n    if (this.isExpired(cached)) {\n      this.del(id);\n      return null;\n    }\n\n    return cached;\n  }\n\n  set(id: string, data: T, options?: TCacheOptions) {\n    this.cache.set(id, this.normalizeCached(id, data, options));\n  }\n\n  del(id: string) {\n    this.cache.delete(id);\n  }\n\n  clear() {\n    this.cache.clear();\n  }\n}\n\n/**\n * 创建一个新的内存缓存实例\n * @template T 缓存数据的类型\n * @returns 返回一个新的 MemoryCache 实例\n */\nexport function createMemCache<T>() {\n  return new MemoryCache<T>();\n}\n"],"names":["dateParse"],"mappings":";;;;;;AAsDO,MAAM,cAAsC;AAAA,EACjD,UAAU,QAAoB;AAC5B,WAAO,OAAO,YAAY,KAAK,KAAK,IAAA,IAAQ,OAAO;AAAA,EAAA;AAAA,EAGrD,gBAAgB,IAAY,MAAS,SAAqC;AACxE,UAAM,EAAE,YAAY,GAAG,SAAS,EAAE,IAAI,WAAW,CAAC;AAC5C,UAAA,MAAM,KAAK,IAAI;AACd,WAAA;AAAA,MACL;AAAA,MACA;AAAA,MACA,WAAW;AAAA,MACX,WAAW,YAAYA,KAAA,UAAU,SAAS,EAAE,QAAY,IAAA,SAAS,IAAI,MAAM,SAAS;AAAA,IACtF;AAAA,EAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQF,IAAI,IAA6C;AACxC,WAAA;AAAA,EAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAST,IAAI,IAAY,MAAS,SAA6C;AAAA,EAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQtE,IAAI,IAAgC;AAAA,EAAA;AAAA;AAAA;AAAA;AAAA,EAOpC,QAA4B;AAAA,EAAA;AAG9B;AAMO,MAAM,oBAAuB,cAAiB;AAAA,EAA9C;AAAA;AACG,qDAAqC,IAAI;AAAA;AAAA,EAEjD,IAAI,IAAY;AACd,UAAM,SAAS,KAAK,MAAM,IAAI,EAAE;AAE5B,QAAA,CAAC,OAAe,QAAA;AAEhB,QAAA,KAAK,UAAU,MAAM,GAAG;AAC1B,WAAK,IAAI,EAAE;AACJ,aAAA;AAAA,IAAA;AAGF,WAAA;AAAA,EAAA;AAAA,EAGT,IAAI,IAAY,MAAS,SAAyB;AAC3C,SAAA,MAAM,IAAI,IAAI,KAAK,gBAAgB,IAAI,MAAM,OAAO,CAAC;AAAA,EAAA;AAAA,EAG5D,IAAI,IAAY;AACT,SAAA,MAAM,OAAO,EAAE;AAAA,EAAA;AAAA,EAGtB,QAAQ;AACN,SAAK,MAAM,MAAM;AAAA,EAAA;AAErB;AAOO,SAAS,iBAAoB;AAClC,SAAO,IAAI,YAAe;AAC5B;;;;"}

package/dist/cache.d.ts

@@ -0,0 +1,90 @@
+import { TDateValue } from './date';
+import { MaybePromise } from './types';
+/**
+ * 缓存选项
+ */
+export type TCacheOptions = {
+    /**
+     * 缓存的最大时长（毫秒），为 0 时表示永久缓存
+     */
+    maxAge?: number;
+    /**
+     * 缓存的过期时间（时间戳、日期字符串、日期对象等）
+     * 优先级比 maxAge 更高
+     */
+    expiredAt?: TDateValue;
+};
+/**
+ * 缓存项
+ * @template T 缓存数据的类型
+ */
+export type TCached<T> = {
+    /**
+     * 缓存项的唯一标识
+     */
+    id: string;
+    /**
+     * 缓存的数据
+     */
+    data: T;
+    /**
+     * 缓存项的创建时间（时间戳）
+     */
+    createdAt: number;
+    /**
+     * 缓存项的过期时间（时间戳）
+     */
+    expiredAt: number;
+};
+export type TCache<T> = {
+    get(id: string): MaybePromise<TCached<T> | null>;
+    set(id: string, data: T, options?: TCacheOptions): MaybePromise<void>;
+    del(id: string): MaybePromise<void>;
+};
+/**
+ * 缓存抽象类
+ * @template T 缓存数据的类型
+ */
+export declare class AbstractCache<T> implements TCache<T> {
+    isExpired(cached: TCached<T>): boolean;
+    normalizeCached(id: string, data: T, options?: TCacheOptions): TCached<T>;
+    /**
+     * 获取缓存项
+     * @param id 缓存项的唯一标识
+     * @returns 返回缓存项或 null
+     */
+    get(id: string): MaybePromise<TCached<T> | null>;
+    /**
+     * 设置缓存项
+     * @param id 缓存项的唯一标识
+     * @param data 要缓存的数据
+     * @param options 缓存选项
+     */
+    set(id: string, data: T, options?: TCacheOptions): MaybePromise<void>;
+    /**
+     * 删除缓存项
+     * @param id 缓存项的唯一标识
+     */
+    del(id: string): MaybePromise<void>;
+    /**
+     * 清空缓存
+     */
+    clear(): MaybePromise<void>;
+}
+/**
+ * 内存缓存实现类
+ * @template T 缓存数据的类型
+ */
+export declare class MemoryCache<T> extends AbstractCache<T> {
+    private cache;
+    get(id: string): TCached<T> | null;
+    set(id: string, data: T, options?: TCacheOptions): void;
+    del(id: string): void;
+    clear(): void;
+}
+/**
+ * 创建一个新的内存缓存实例
+ * @template T 缓存数据的类型
+ * @returns 返回一个新的 MemoryCache 实例
+ */
+export declare function createMemCache<T>(): MemoryCache<T>;

package/dist/cache.mjs

@@ -0,0 +1,79 @@
+var __defProp = Object.defineProperty;
+var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
+import { d as dateParse } from "./core.mjs";
+class AbstractCache {
+  isExpired(cached) {
+    return cached.expiredAt > 0 && Date.now() > cached.expiredAt;
+  }
+  normalizeCached(id, data, options) {
+    const { expiredAt = 0, maxAge = 0 } = options || {};
+    const now = Date.now();
+    return {
+      id,
+      data,
+      createdAt: now,
+      expiredAt: expiredAt ? dateParse(expiredAt).getTime() : maxAge > 0 ? now + maxAge : 0
+    };
+  }
+  /**
+   * 获取缓存项
+   * @param id 缓存项的唯一标识
+   * @returns 返回缓存项或 null
+   */
+  get(id) {
+    return null;
+  }
+  /**
+   * 设置缓存项
+   * @param id 缓存项的唯一标识
+   * @param data 要缓存的数据
+   * @param options 缓存选项
+   */
+  set(id, data, options) {
+  }
+  /**
+   * 删除缓存项
+   * @param id 缓存项的唯一标识
+   */
+  del(id) {
+  }
+  /**
+   * 清空缓存
+   */
+  clear() {
+  }
+}
+class MemoryCache extends AbstractCache {
+  constructor() {
+    super(...arguments);
+    __publicField(this, "cache", /* @__PURE__ */ new Map());
+  }
+  get(id) {
+    const cached = this.cache.get(id);
+    if (!cached) return null;
+    if (this.isExpired(cached)) {
+      this.del(id);
+      return null;
+    }
+    return cached;
+  }
+  set(id, data, options) {
+    this.cache.set(id, this.normalizeCached(id, data, options));
+  }
+  del(id) {
+    this.cache.delete(id);
+  }
+  clear() {
+    this.cache.clear();
+  }
+}
+function createMemCache() {
+  return new MemoryCache();
+}
+export {
+  AbstractCache,
+  MemoryCache,
+  createMemCache
+};
+//# sourceMappingURL=cache.mjs.map

package/dist/cache.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.mjs","sources":["../src/cache.ts"],"sourcesContent":["import { type TDateValue, dateParse } from './date';\nimport type { MaybePromise } from './types';\n\n/**\n * 缓存选项\n */\nexport type TCacheOptions = {\n  /**\n   * 缓存的最大时长（毫秒），为 0 时表示永久缓存\n   */\n  maxAge?: number;\n\n  /**\n   * 缓存的过期时间（时间戳、日期字符串、日期对象等）\n   * 优先级比 maxAge 更高\n   */\n  expiredAt?: TDateValue;\n};\n\n/**\n * 缓存项\n * @template T 缓存数据的类型\n */\nexport type TCached<T> = {\n  /**\n   * 缓存项的唯一标识\n   */\n  id: string;\n  /**\n   * 缓存的数据\n   */\n  data: T;\n  /**\n   * 缓存项的创建时间（时间戳）\n   */\n  createdAt: number;\n  /**\n   * 缓存项的过期时间（时间戳）\n   */\n  expiredAt: number;\n};\n\nexport type TCache<T> = {\n  get(id: string): MaybePromise<TCached<T> | null>;\n\n  set(id: string, data: T, options?: TCacheOptions): MaybePromise<void>;\n\n  del(id: string): MaybePromise<void>;\n};\n\n/**\n * 缓存抽象类\n * @template T 缓存数据的类型\n */\nexport class AbstractCache<T> implements TCache<T> {\n  isExpired(cached: TCached<T>) {\n    return cached.expiredAt > 0 && Date.now() > cached.expiredAt;\n  }\n\n  normalizeCached(id: string, data: T, options?: TCacheOptions): TCached<T> {\n    const { expiredAt = 0, maxAge = 0 } = options || {};\n    const now = Date.now();\n    return {\n      id,\n      data,\n      createdAt: now,\n      expiredAt: expiredAt ? dateParse(expiredAt).getTime() : maxAge > 0 ? now + maxAge : 0,\n    };\n  }\n\n  /**\n   * 获取缓存项\n   * @param id 缓存项的唯一标识\n   * @returns 返回缓存项或 null\n   */\n  get(id: string): MaybePromise<TCached<T> | null> {\n    return null;\n  }\n\n  /**\n   * 设置缓存项\n   * @param id 缓存项的唯一标识\n   * @param data 要缓存的数据\n   * @param options 缓存选项\n   */\n  set(id: string, data: T, options?: TCacheOptions): MaybePromise<void> {\n    //\n  }\n\n  /**\n   * 删除缓存项\n   * @param id 缓存项的唯一标识\n   */\n  del(id: string): MaybePromise<void> {\n    //\n  }\n\n  /**\n   * 清空缓存\n   */\n  clear(): MaybePromise<void> {\n    //\n  }\n}\n\n/**\n * 内存缓存实现类\n * @template T 缓存数据的类型\n */\nexport class MemoryCache<T> extends AbstractCache<T> {\n  private cache: Map<string, TCached<T>> = new Map();\n\n  get(id: string) {\n    const cached = this.cache.get(id);\n\n    if (!cached) return null;\n\n    if (this.isExpired(cached)) {\n      this.del(id);\n      return null;\n    }\n\n    return cached;\n  }\n\n  set(id: string, data: T, options?: TCacheOptions) {\n    this.cache.set(id, this.normalizeCached(id, data, options));\n  }\n\n  del(id: string) {\n    this.cache.delete(id);\n  }\n\n  clear() {\n    this.cache.clear();\n  }\n}\n\n/**\n * 创建一个新的内存缓存实例\n * @template T 缓存数据的类型\n * @returns 返回一个新的 MemoryCache 实例\n */\nexport function createMemCache<T>() {\n  return new MemoryCache<T>();\n}\n"],"names":[],"mappings":";;;;AAsDO,MAAM,cAAsC;AAAA,EACjD,UAAU,QAAoB;AAC5B,WAAO,OAAO,YAAY,KAAK,KAAK,IAAA,IAAQ,OAAO;AAAA,EAAA;AAAA,EAGrD,gBAAgB,IAAY,MAAS,SAAqC;AACxE,UAAM,EAAE,YAAY,GAAG,SAAS,EAAE,IAAI,WAAW,CAAC;AAC5C,UAAA,MAAM,KAAK,IAAI;AACd,WAAA;AAAA,MACL;AAAA,MACA;AAAA,MACA,WAAW;AAAA,MACX,WAAW,YAAY,UAAU,SAAS,EAAE,QAAY,IAAA,SAAS,IAAI,MAAM,SAAS;AAAA,IACtF;AAAA,EAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQF,IAAI,IAA6C;AACxC,WAAA;AAAA,EAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAST,IAAI,IAAY,MAAS,SAA6C;AAAA,EAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQtE,IAAI,IAAgC;AAAA,EAAA;AAAA;AAAA;AAAA;AAAA,EAOpC,QAA4B;AAAA,EAAA;AAG9B;AAMO,MAAM,oBAAuB,cAAiB;AAAA,EAA9C;AAAA;AACG,qDAAqC,IAAI;AAAA;AAAA,EAEjD,IAAI,IAAY;AACd,UAAM,SAAS,KAAK,MAAM,IAAI,EAAE;AAE5B,QAAA,CAAC,OAAe,QAAA;AAEhB,QAAA,KAAK,UAAU,MAAM,GAAG;AAC1B,WAAK,IAAI,EAAE;AACJ,aAAA;AAAA,IAAA;AAGF,WAAA;AAAA,EAAA;AAAA,EAGT,IAAI,IAAY,MAAS,SAAyB;AAC3C,SAAA,MAAM,IAAI,IAAI,KAAK,gBAAgB,IAAI,MAAM,OAAO,CAAC;AAAA,EAAA;AAAA,EAG5D,IAAI,IAAY;AACT,SAAA,MAAM,OAAO,EAAE;AAAA,EAAA;AAAA,EAGtB,QAAQ;AACN,SAAK,MAAM,MAAM;AAAA,EAAA;AAErB;AAOO,SAAS,iBAAoB;AAClC,SAAO,IAAI,YAAe;AAC5B;"}

package/dist/color/contrast.d.ts

@@ -0,0 +1,10 @@
+import { RGB } from './types';
+/**
+ * 计算两个颜色之间的对比度比率（符合WCAG 2.1标准）
+ * @param rgb1 第一个RGB颜色对象（分量范围0-255）
+ * @param rgb2 第二个RGB颜色对象（分量范围0-255）
+ * @returns {number} 对比度比率，范围1-21（1:1 到 21:1）
+ * @example
+ * contrast({r: 0, g: 0, b: 0}, {r: 255, g: 255, b: 255}) // 返回21
+ */
+export declare function contrast(rgb1: RGB, rgb2: RGB): number;

package/dist/color/distance.d.ts

@@ -0,0 +1,8 @@
+import { LAB } from './types';
+/**
+ * 计算两个颜色之间的距离（距离越小相似度越高），值范围 [0, 1]
+ * @param {LAB} labA
+ * @param {LAB} labB
+ * @returns {number}
+ */
+export declare function distance(labA: LAB, labB: LAB): number;

package/dist/color/helpers.d.ts

@@ -0,0 +1,2 @@
+import { RGB } from './types';
+export declare function rgbToHue({ r, g, b }: RGB): [number, number, number, number];

package/dist/color/hex-hsl.d.ts

@@ -0,0 +1,3 @@
+import { HEX, HSL } from './types';
+export declare function hslToHex(hsl: HSL): HEX;
+export declare function hexToHsl(hex: HEX): HSL;

package/dist/color/hex-hsv.d.ts

@@ -0,0 +1,20 @@
+import { HEX, HSV } from './types';
+/**
+ * 将HEX颜色转换为HSV颜色空间
+ * @param hex HEX颜色字符串（支持3位或6位格式）
+ * @returns {HSV} HSV颜色对象，包含：
+ *   h: 色相（0-360度）
+ *   s: 饱和度（0-100%）
+ *   v: 明度（0-100%）
+ * @example
+ * hexToHsv('#ff0000') // returns {h: 0, s: 100, v: 100}
+ */
+export declare function hexToHsv(hex: HEX): HSV;
+/**
+ * 将HSV颜色转换回HEX字符串
+ * @param hsv HSV颜色对象
+ * @returns {HEX} 6位HEX颜色字符串（带#前缀）
+ * @example
+ * hsvToHex({h: 0, s: 100, v: 100}) // returns '#ff0000'
+ */
+export declare function hsvToHex(hsv: HSV): HEX;

package/dist/color/hex-hwb.d.ts

@@ -0,0 +1,23 @@
+import { HEX, HWB } from './types';
+/**
+ * 将HWB颜色转换为HEX字符串
+ * @param hwb HWB颜色对象
+ * @param hwb.h 色相（0-360度）
+ * @param hwb.w 白度（0-100%）
+ * @param hwb.b 黑度（0-100%）
+ * @returns {HEX} 6位HEX颜色字符串（带#前缀）
+ * @example
+ * hwbToHex({h: 0, w: 0, b: 0}) // returns '#ff0000'
+ */
+export declare function hwbToHex(hwb: HWB): HEX;
+/**
+ * 将HEX颜色转换为HWB颜色空间
+ * @param hex HEX颜色字符串（支持3位或6位格式）
+ * @returns {HWB} HWB颜色对象，包含：
+ *   h: 色相（0-360度）
+ *   w: 白度（0-100%）
+ *   b: 黑度（0-100%）
+ * @example
+ * hexToHwb('#ff0000') // returns {h: 0, w: 0, b: 0}
+ */
+export declare function hexToHwb(hex: HEX): HWB;

package/dist/color/hex-rgb.d.ts

@@ -0,0 +1,18 @@
+import { HEX, RGB } from './types';
+/**
+ * 将HEX颜色字符串转换为RGB颜色对象
+ * @param hex HEX颜色字符串，支持3位或6位格式（例如#f00或#ff0000）
+ * @returns {RGB} 对应的RGB颜色对象
+ * @throws {SyntaxError} 当颜色格式不符合规范时抛出
+ * @example
+ * hexToRgb('#f00') // returns {r: 255, g: 0, b: 0}
+ */
+export declare function hexToRgb(hex: HEX): RGB;
+/**
+ * 将RGB颜色对象转换为HEX颜色字符串
+ * @param rgb RGB颜色对象
+ * @returns {HEX} 6位HEX颜色字符串（带#前缀）
+ * @example
+ * rgbToHex({r: 255, g: 0, b: 0}) // returns '#ff0000'
+ */
+export declare function rgbToHex(rgb: RGB): HEX;

package/dist/color/hsl-lighten.d.ts

@@ -0,0 +1,10 @@
+import { HSL } from './types';
+/**
+ * 通过HSL颜色空间调整颜色亮度
+ * @param hsl 原始 HSL 颜色
+ * @param value 亮度调整系数（0-1之间，0.1表示增加10%亮度）
+ * @returns {HSL} 调整后的 HSL 颜色
+ * @example
+ * hslLighten({h: 300, s: 33, l: 44}, 0.2) // 返回亮度增加20%后的颜色
+ */
+export declare function hslLighten(hsl: HSL, value: number): HSL;

package/dist/color/hsv-brighten.d.ts

@@ -0,0 +1,12 @@
+import { HSV } from './types';
+/**
+ * 通过HSV颜色空间调整颜色明度
+ * @param hsv 原始HSV颜色对象
+ * @param value 明度调整系数（-1到1之间）：
+ *   - 正值增加明度（如0.2表示+20%）
+ *   - 负值降低明度（如-0.1表示-10%）
+ * @returns {HSV} 调整后的HSV颜色对象（v值范围0-100%）
+ * @example
+ * hsvBrighten({h: 0, s: 100, v: 50}, 0.3) // 返回{h: 0, s: 100, v: 65}
+ */
+export declare function hsvBrighten(hsv: HSV, value: number): HSV;

package/dist/color/luminance.d.ts

@@ -0,0 +1,10 @@
+import { RGB } from './types';
+/**
+ * 计算RGB颜色的相对亮度（符合WCAG 2.1标准）
+ * @param rgb RGB颜色对象（分量范围0-255）
+ * @returns {number} 相对亮度值（0-1之间）
+ * @see https://www.w3.org/TR/WCAG21/#dfn-relative-luminance
+ * @example
+ * luminance({r: 255, g: 255, b: 255}) // 返回1
+ */
+export declare function luminance({ r, g, b }: RGB): number;

package/dist/color/mix.d.ts

@@ -0,0 +1,18 @@
+import { HSL, HSV, RGB } from './types';
+/**
+ * 颜色混合函数（支持RGB/HSL/HSV色彩模型）
+ * @template T 颜色类型，支持RGB、HSL或HSV对象
+ * @param {T} a 第一个颜色对象
+ * @param {T} b 第二个颜色对象
+ * @param {number} [weight=0.5] 混合权重（0-1之间）：
+ *   - 0 表示完全使用第一个颜色
+ *   - 1 表示完全使用第二个颜色
+ * @returns {T} 线性混合后的新颜色对象
+ * @example
+ * // RGB混合示例
+ * mix({r: 255, g: 0, b: 0}, {r: 0, g: 0, b: 255}, 0.5) // 返回紫色
+ *
+ * // HSL混合示例
+ * mix({h: 0, s: 100, l: 50}, {h: 120, s: 100, l: 50}, 0.3)
+ */
+export declare function mix<T extends RGB | HSV | HSL>(a: T, b: T, weight?: number): T;

package/dist/color/rgb-hsl.d.ts

@@ -0,0 +1,23 @@
+import { HSL, RGB } from './types';
+/**
+ * 将RGB颜色转换为HSL颜色空间
+ * @param rgb RGB颜色对象（分量范围0-255）
+ * @returns {HSL} HSL颜色对象，其中：
+ *   h: 色相（0-360度）
+ *   s: 饱和度（0-100%）
+ *   l: 亮度（0-100%）
+ * @example
+ * rgbToHsl({r: 255, g: 0, b: 0}) // returns {h: 0, s: 100, l: 50}
+ */
+export declare function rgbToHsl(rgb: RGB): HSL;
+/**
+ * 将HSL颜色转换回RGB颜色空间
+ * @param hsl HSL颜色对象
+ * @param hsl.h 色相（0-360度）
+ * @param hsl.s 饱和度（0-100%）
+ * @param hsl.l 亮度（0-100%）
+ * @returns {RGB} RGB颜色对象（分量范围0-255）
+ * @example
+ * hslToRgb({h: 0, s: 100, l: 50}) // returns {r: 255, g: 0, b: 0}
+ */
+export declare function hslToRgb({ h, s, l }: HSL): RGB;

package/dist/color/rgb-hsv.d.ts

@@ -0,0 +1,25 @@
+import { HSV, RGB } from './types';
+/**
+ * 将RGB颜色转换为HSV颜色空间
+ * @param rgb RGB颜色对象（分量范围0-255）
+ * @returns {HSV} HSV颜色对象：
+ *   h: 色相（0-360度）
+ *   s: 饱和度（0-100%）
+ *   v: 明度（0-100%）
+ * @see https://en.wikipedia.org/wiki/HSL_and_HSV
+ * @example
+ * rgbToHsv({r: 255, g: 0, b: 0}) // {h: 0, s: 100, v: 100}
+ */
+export declare function rgbToHsv(rgb: RGB): HSV;
+/**
+ * 将HSV颜色转换回RGB颜色空间
+ * @param hsv HSV颜色对象
+ * @param hsv.h 色相（0-360度）
+ * @param hsv.s 饱和度（0-100%）
+ * @param hsv.v 明度（0-100%）
+ * @returns {RGB} RGB颜色对象（分量范围0-255）
+ * @see https://www.rapidtables.com/convert/color/hsv-to-rgb.html
+ * @example
+ * hsvToRgb({h: 0, s: 100, v: 100}) // {r: 255, g: 0, b: 0}
+ */
+export declare function hsvToRgb({ h, s, v }: HSV): RGB;

package/dist/color/rgb-hwb.d.ts

@@ -0,0 +1,29 @@
+import { HWB, RGB } from './types';
+/**
+ * 将RGB颜色转换为HWB颜色空间
+ * @param rgb RGB颜色对象（分量范围0-255）
+ * @returns {HWB} HWB颜色对象：
+ *   h: 色相（0-360度）
+ *   w: 白度（0-100%）
+ *   b: 黑度（0-100%）
+ * @see https://www.w3.org/TR/css-color-4/#hwb-to-rgb
+ * @example
+ * rgbToHwb({r: 255, g: 0, b: 0}) // {h: 0, w: 0, b: 0}
+ */
+export declare function rgbToHwb(rgb: RGB): HWB;
+/**
+ * 将HWB颜色转换回RGB颜色空间
+ * @param hwb HWB颜色对象
+ * @param hwb.h 色相（0-360度）
+ * @param hwb.w 白度（0-100%）
+ * @param hwb.b 黑度（0-100%）
+ * @returns {RGB} RGB颜色对象（分量范围0-255）
+ * @see https://en.wikipedia.org/wiki/HWB_color_model
+ * @example
+ * hwbToRgb({h: 0, w: 0, b: 0}) // {r: 255, g: 0, b: 0}
+ */
+export declare function hwbToRgb({ h, w: white, b: black }: HWB): {
+    r: number;
+    g: number;
+    b: number;
+};

package/dist/color/rgb-lab.d.ts

@@ -0,0 +1,25 @@
+import { LAB, RGB } from './types';
+/**
+ * 将RGB颜色转换为Lab颜色空间（CIE 1976标准）
+ * @param rgb RGB颜色对象（分量范围0-255）
+ * @returns {LAB} Lab颜色对象：
+ *   l: 明度（0-100）
+ *   a: 绿-红分量（-128到127）
+ *   b: 蓝-黄分量（-128到127）
+ * @see https://en.wikipedia.org/wiki/CIELAB_color_space
+ * @example
+ * rgbToLab({r: 255, g: 0, b: 0}) // {l: 53.24, a: 80.09, b: 67.20}
+ */
+export declare function rgbToLab(rgb: RGB): LAB;
+/**
+ * 将Lab颜色转换回RGB颜色空间
+ * @param lab Lab颜色对象
+ * @param lab.l 明度（0-100）
+ * @param lab.a 绿-红分量（-128到127）
+ * @param lab.b 蓝-黄分量（-128到127）
+ * @returns {RGB} RGB颜色对象（分量可能超出0-255范围）
+ * @see https://www.easyrgb.com/en/math.php
+ * @example
+ * labToRgb({l: 53.24, a: 80.09, b: 67.20}) // {r: 255, g: 0, b: 0}
+ */
+export declare function labToRgb(lab: LAB): RGB;

package/dist/color/rgb-whiter.d.ts

@@ -0,0 +1,12 @@
+import { RGB } from './types';
+/**
+ * 通过混合颜色调整明暗度
+ * @param rgb 原始RGB颜色对象
+ * @param value 调整强度（-1到1之间）：
+ *   - 正值时与黑色混合（增加暗度）
+ *   - 负值时与白色混合（增加亮度）
+ * @returns {RGB} 调整后的RGB颜色对象
+ * @example
+ * rgbDarken({r: 100, g: 150, b: 200}, 0.2) // 变暗20%
+ */
+export declare function rgbWhiter(rgb: RGB, value: number): RGB;

package/dist/color/rgb-xyz.d.ts

@@ -0,0 +1,22 @@
+import { RGB, XYZ } from './types';
+/**
+ * 将RGB颜色转换为CIE 1931 XYZ颜色空间（D65白点，2°观察者）
+ * @param rgb RGB颜色对象（分量范围0-255）
+ * @returns {XYZ} XYZ颜色对象：
+ *   x: 约0-95.047
+ *   y: 约0-100.0
+ *   z: 约0-108.883
+ * @see https://en.wikipedia.org/wiki/CIE_1931_color_space
+ * @example
+ * rgbToXyz({r: 255, g: 255, b: 255}) // {x: 95.047, y: 100.0, z: 108.883}
+ */
+export declare function rgbToXyz(rgb: RGB): XYZ;
+/**
+ * 将XYZ颜色转换回RGB颜色空间（可能超出常规范围）
+ * @param xyz XYZ颜色对象
+ * @returns {RGB} RGB颜色对象（分量可能超出0-255范围）
+ * @see https://www.brucelindbloom.com/index.html?Eqn_XYZ_to_RGB.html
+ * @example
+ * xyzToRgb({x: 95.047, y: 100.0, z: 108.883}) // {r: 255, g: 255, b: 255}
+ */
+export declare function xyzToRgb(xyz: XYZ): RGB;

package/dist/color/types.d.ts

@@ -0,0 +1,83 @@
+/**
+ * HEX颜色字符串类型（带#前缀）
+ * @example "#ff0000" // 红色
+ * @example "#0f0"    // 绿色简写
+ */
+export type HEX = `#${string}`;
+/**
+ * RGB颜色空间类型
+ * @property r 红色分量（0-255）
+ * @property g 绿色分量（0-255）
+ * @property b 蓝色分量（0-255）
+ * @example {r: 255, g: 0, b: 0} // 纯红色
+ */
+export type RGB = {
+    r: number;
+    g: number;
+    b: number;
+};
+/**
+ * HSV/HSB颜色空间类型
+ * @property h 色相（0-360度）
+ * @property s 饱和度（0-100%）
+ * @property v 明度（0-100%）
+ * @see https://zh.wikipedia.org/wiki/HSL%E5%92%8CHSV%E8%89%B2%E5%BD%A9%E7%A9%BA%E9%97%B4
+ * @example {h: 0, s: 100, v: 100} // 纯红色
+ */
+export type HSV = {
+    h: number;
+    s: number;
+    v: number;
+};
+/**
+ * HSL颜色空间类型
+ * @property h 色相（0-360度）
+ * @property s 饱和度（0-100%）
+ * @property l 亮度（0-100%）
+ * @see https://developer.mozilla.org/en-US/docs/Web/CSS/color_value/hsl
+ * @example {h: 120, s: 100, l: 50} // 纯绿色
+ */
+export type HSL = {
+    h: number;
+    s: number;
+    l: number;
+};
+/**
+ * HWB颜色空间类型（W3C标准）
+ * @property h 色相（0-360度）
+ * @property w 白度（0-100%）
+ * @property b 黑度（0-100%）
+ * @see https://zh.wikipedia.org/zh-hans/HWB%E8%89%B2%E5%BD%A9%E7%A9%BA%E9%97%B4
+ * @example {h: 0, w: 0, b: 0} // 纯红色
+ */
+export type HWB = {
+    h: number;
+    w: number;
+    b: number;
+};
+/**
+ * CIE LAB颜色空间类型（L*a*b*）
+ * @property l 明度（0-100）
+ * @property a 绿-红分量（典型范围-128到127）
+ * @property b 蓝-黄分量（典型范围-128到127）
+ * @see https://zh.m.wikipedia.org/wiki/CIELAB%E8%89%B2%E5%BD%A9%E7%A9%BA%E9%97%B4
+ * @example {l: 53.24, a: 80.09, b: 67.20} // 亮红色
+ */
+export type LAB = {
+    l: number;
+    a: number;
+    b: number;
+};
+/**
+ * CIE 1931 XYZ颜色空间类型
+ * @property x XYZ三刺激值X分量
+ * @property y XYZ三刺激值Y分量（亮度基准）
+ * @property z XYZ三刺激值Z分量
+ * @see // https://zh.m.wikipedia.org/wiki/CIE_1931%E8%89%B2%E5%BD%A9%E7%A9%BA%E9%97%B4
+ * @example {x: 95.047, y: 100.0, z: 108.883} // D65标准白点
+ */
+export type XYZ = {
+    x: number;
+    y: number;
+    z: number;
+};