@cloudcome/utils-core 1.1.1 → 1.2.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/{src/color/contrast.ts → dist/color/contrast.d.ts}

@@ -1,6 +1,4 @@
-import { luminance } from './luminance';
-import type { RGB } from './types';
-
+import { RGB } from './types';
 /**
  * 计算两个颜色之间的对比度比率（符合WCAG 2.1标准）
  * @param rgb1 第一个RGB颜色对象（分量范围0-255）
@@ -9,12 +7,4 @@ import type { RGB } from './types';
  * @example
  * contrast({r: 0, g: 0, b: 0}, {r: 255, g: 255, b: 255}) // 返回21
  */
-export function contrast(rgb1: RGB, rgb2: RGB) {
-  const lum1 = luminance(rgb1);
-  const lum2 = luminance(rgb2);
-
-  const brightest = Math.max(lum1, lum2);
-  const darkest = Math.min(lum1, lum2);
-
-  return (brightest + 0.05) / (darkest + 0.05);
-}
+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/{src/color/hex-hsv.ts → dist/color/hex-hsv.d.ts}

@@ -1,7 +1,4 @@
-import { hexToRgb, rgbToHex } from './hex-rgb';
-import { hsvToRgb, rgbToHsv } from './rgb-hsv';
-import type { HEX, HSV } from './types';
-
+import { HEX, HSV } from './types';
 /**
  * 将HEX颜色转换为HSV颜色空间
  * @param hex HEX颜色字符串（支持3位或6位格式）
@@ -12,10 +9,7 @@ import type { HEX, HSV } from './types';
  * @example
  * hexToHsv('#ff0000') // returns {h: 0, s: 100, v: 100}
  */
-export function hexToHsv(hex: HEX): HSV {
-  return rgbToHsv(hexToRgb(hex));
-}
-
+export declare function hexToHsv(hex: HEX): HSV;
 /**
  * 将HSV颜色转换回HEX字符串
  * @param hsv HSV颜色对象
@@ -23,6 +17,4 @@ export function hexToHsv(hex: HEX): HSV {
  * @example
  * hsvToHex({h: 0, s: 100, v: 100}) // returns '#ff0000'
  */
-export function hsvToHex(hsv: HSV): HEX {
-  return rgbToHex(hsvToRgb(hsv));
-}
+export declare function hsvToHex(hsv: HSV): HEX;

package/{src/color/hex-hwb.ts → dist/color/hex-hwb.d.ts}

@@ -1,7 +1,4 @@
-import { hexToRgb, rgbToHex } from './hex-rgb';
-import { hwbToRgb, rgbToHwb } from './rgb-hwb';
-import type { HEX, HWB } from './types';
-
+import { HEX, HWB } from './types';
 /**
  * 将HWB颜色转换为HEX字符串
  * @param hwb HWB颜色对象
@@ -12,10 +9,7 @@ import type { HEX, HWB } from './types';
  * @example
  * hwbToHex({h: 0, w: 0, b: 0}) // returns '#ff0000'
  */
-export function hwbToHex(hwb: HWB): HEX {
-  return rgbToHex(hwbToRgb(hwb));
-}
-
+export declare function hwbToHex(hwb: HWB): HEX;
 /**
  * 将HEX颜色转换为HWB颜色空间
  * @param hex HEX颜色字符串（支持3位或6位格式）
@@ -26,6 +20,4 @@ export function hwbToHex(hwb: HWB): HEX {
  * @example
  * hexToHwb('#ff0000') // returns {h: 0, w: 0, b: 0}
  */
-export function hexToHwb(hex: HEX): HWB {
-  return rgbToHwb(hexToRgb(hex));
-}
+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/{src/color/hsl-lighten.ts → dist/color/hsl-lighten.d.ts}

@@ -1,5 +1,4 @@
-import type { HSL } from './types';
-
+import { HSL } from './types';
 /**
  * 通过HSL颜色空间调整颜色亮度
  * @param hsl 原始 HSL 颜色
@@ -8,8 +7,4 @@ import type { HSL } from './types';
  * @example
  * hslLighten({h: 300, s: 33, l: 44}, 0.2) // 返回亮度增加20%后的颜色
  */
-export function hslLighten(hsl: HSL, value: number): HSL {
-  const hslFinal = { ...hsl };
-  hslFinal.l = hslFinal.l * (1 + value);
-  return hslFinal;
-}
+export declare function hslLighten(hsl: HSL, value: number): HSL;

package/{src/color/hsv-brighten.ts → dist/color/hsv-brighten.d.ts}

@@ -1,5 +1,4 @@
-import type { HSV } from './types';
-
+import { HSV } from './types';
 /**
  * 通过HSV颜色空间调整颜色明度
  * @param hsv 原始HSV颜色对象
@@ -10,8 +9,4 @@ import type { HSV } from './types';
  * @example
  * hsvBrighten({h: 0, s: 100, v: 50}, 0.3) // 返回{h: 0, s: 100, v: 65}
  */
-export function hsvBrighten(hsv: HSV, value: number): HSV {
-  const hsvFinal = { ...hsv };
-  hsvFinal.v = hsvFinal.v * (1 + value);
-  return hsvFinal;
-}
+export declare function hsvBrighten(hsv: HSV, value: number): HSV;

package/{src/color/luminance.ts → dist/color/luminance.d.ts}

@@ -1,5 +1,4 @@
-import type { RGB } from './types';
-
+import { RGB } from './types';
 /**
  * 计算RGB颜色的相对亮度（符合WCAG 2.1标准）
  * @param rgb RGB颜色对象（分量范围0-255）
@@ -8,10 +7,4 @@ import type { RGB } from './types';
  * @example
  * luminance({r: 255, g: 255, b: 255}) // 返回1
  */
-export function luminance({ r, g, b }: RGB) {
-  const a = [r, g, b].map((v) => {
-    const vFinal = v / 255;
-    return vFinal <= 0.03928 ? vFinal / 12.92 : ((vFinal + 0.055) / 1.055) ** 2.4;
-  });
-  return a[0] * 0.2126 + a[1] * 0.7152 + a[2] * 0.0722;
-}
+export declare function luminance({ r, g, b }: RGB): number;

package/{src/color/mix.ts → dist/color/mix.d.ts}

@@ -1,5 +1,4 @@
-import type { HSL, HSV, RGB } from './types';
-
+import { HSL, HSV, RGB } from './types';
 /**
  * 颜色混合函数（支持RGB/HSL/HSV色彩模型）
  * @template T 颜色类型，支持RGB、HSL或HSV对象
@@ -16,11 +15,4 @@ import type { HSL, HSV, RGB } from './types';
  * // HSL混合示例
  * mix({h: 0, s: 100, l: 50}, {h: 120, s: 100, l: 50}, 0.3)
  */
-export function mix<T extends RGB | HSV | HSL>(a: T, b: T, weight = 0.5): T {
-  return Object.keys(a).reduce((acc, key) => {
-    // eslint-disable-next-line @typescript-eslint/ban-ts-comment
-    // @ts-ignore
-    acc[key] = (b[key] - a[key]) * weight + a[key];
-    return acc;
-  }, {} as T);
-}
+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/{src/color/rgb-hsv.ts → dist/color/rgb-hsv.d.ts}

@@ -1,9 +1,4 @@
-import { rgbToHue } from './helpers';
-import type { HSV, RGB } from './types';
-
-const { abs, min, max, round } = Math;
-
-// @ref https://www.30secondsofcode.org/js/s/rgb-to-hsb/
+import { HSV, RGB } from './types';
 /**
  * 将RGB颜色转换为HSV颜色空间
  * @param rgb RGB颜色对象（分量范围0-255）
@@ -15,17 +10,7 @@ const { abs, min, max, round } = Math;
  * @example
  * rgbToHsv({r: 255, g: 0, b: 0}) // {h: 0, s: 100, v: 100}
  */
-export function rgbToHsv(rgb: RGB): HSV {
-  const [hue, max, min, diff] = rgbToHue(rgb);
-
-  return {
-    h: hue,
-    s: max && (diff / max) * 100,
-    v: max * 100,
-  };
-}
-
-// @ref https://www.30secondsofcode.org/js/s/hsb-to-rgb/
+export declare function rgbToHsv(rgb: RGB): HSV;
 /**
  * 将HSV颜色转换回RGB颜色空间
  * @param hsv HSV颜色对象
@@ -37,16 +22,4 @@ export function rgbToHsv(rgb: RGB): HSV {
  * @example
  * hsvToRgb({h: 0, s: 100, v: 100}) // {r: 255, g: 0, b: 0}
  */
-export function hsvToRgb({ h, s, v }: HSV): RGB {
-  s /= 100;
-  v /= 100;
-
-  const k = (n: number) => (n + h / 60) % 6;
-  const f = (n: number) => v * (1 - s * max(0, min(k(n), 4 - k(n), 1)));
-
-  return {
-    r: 255 * f(5),
-    g: 255 * f(3),
-    b: 255 * f(1),
-  };
-}
+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/{src/color/rgb-lab.ts → dist/color/rgb-lab.d.ts}

@@ -1,7 +1,4 @@
-import { rgbToXyz, xyzToRgb } from './rgb-xyz';
-import type { LAB, RGB } from './types';
-import { labToXyz, xyzToLab } from './xyz-lab';
-
+import { LAB, RGB } from './types';
 /**
  * 将RGB颜色转换为Lab颜色空间（CIE 1976标准）
  * @param rgb RGB颜色对象（分量范围0-255）
@@ -13,10 +10,7 @@ import { labToXyz, xyzToLab } from './xyz-lab';
  * @example
  * rgbToLab({r: 255, g: 0, b: 0}) // {l: 53.24, a: 80.09, b: 67.20}
  */
-export function rgbToLab(rgb: RGB): LAB {
-  return xyzToLab(rgbToXyz(rgb));
-}
-
+export declare function rgbToLab(rgb: RGB): LAB;
 /**
  * 将Lab颜色转换回RGB颜色空间
  * @param lab Lab颜色对象
@@ -28,6 +22,4 @@ export function rgbToLab(rgb: RGB): LAB {
  * @example
  * labToRgb({l: 53.24, a: 80.09, b: 67.20}) // {r: 255, g: 0, b: 0}
  */
-export function labToRgb(lab: LAB): RGB {
-  return xyzToRgb(labToXyz(lab));
-}
+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;