colorlip 0.1.0

package/dist/index.cjs

@@ -0,0 +1,380 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  DEFAULT_OPTIONS: () => DEFAULT_OPTIONS,
+  aggregateColors: () => aggregateColors,
+  colorlip: () => colorlip,
+  createDominantColor: () => createDominantColor,
+  extractFallbackPalette: () => extractFallbackPalette,
+  getHueCategory: () => getHueCategory,
+  rgbToHex: () => rgbToHex,
+  rgbToHsl: () => rgbToHsl
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/constants.ts
+var DEFAULT_OPTIONS = {
+  numColors: 3,
+  saturationThreshold: 0.15,
+  brightnessMin: 20,
+  brightnessMax: 235,
+  quantizationStep: 12
+};
+var FALLBACK_QUANTIZATION_STEP = 16;
+var ALPHA_THRESHOLD = 16;
+var EDGE_STRENGTH_DIVISOR = 100;
+var BORDER_EDGE_WEIGHT = 1.5;
+
+// src/core.ts
+function rgbToLab(r, g, b) {
+  let rl = r / 255;
+  let gl = g / 255;
+  let bl = b / 255;
+  rl = rl > 0.04045 ? ((rl + 0.055) / 1.055) ** 2.4 : rl / 12.92;
+  gl = gl > 0.04045 ? ((gl + 0.055) / 1.055) ** 2.4 : gl / 12.92;
+  bl = bl > 0.04045 ? ((bl + 0.055) / 1.055) ** 2.4 : bl / 12.92;
+  let x = (rl * 0.4124564 + gl * 0.3575761 + bl * 0.1804375) / 0.95047;
+  let y = rl * 0.2126729 + gl * 0.7151522 + bl * 0.072175;
+  let z = (rl * 0.0193339 + gl * 0.119192 + bl * 0.9503041) / 1.08883;
+  const epsilon = 8856e-6;
+  const kappa = 903.3;
+  x = x > epsilon ? Math.cbrt(x) : (kappa * x + 16) / 116;
+  y = y > epsilon ? Math.cbrt(y) : (kappa * y + 16) / 116;
+  z = z > epsilon ? Math.cbrt(z) : (kappa * z + 16) / 116;
+  return {
+    L: 116 * y - 16,
+    a: 500 * (x - y),
+    b: 200 * (y - z)
+  };
+}
+function deltaE76(lab1, lab2) {
+  return Math.sqrt((lab1.L - lab2.L) ** 2 + (lab1.a - lab2.a) ** 2 + (lab1.b - lab2.b) ** 2);
+}
+function analyzeImageStats(data, width, height, channels) {
+  const pixelCount = width * height;
+  if (pixelCount === 0) return { medianSaturation: 0, edgeCentrality: 0.5 };
+  const sampleCount = Math.min(Math.max(Math.floor(pixelCount * 0.1), 100), 2e3);
+  const stride = Math.max(1, Math.floor(pixelCount / sampleCount));
+  const saturations = [];
+  const centerX = width / 2;
+  const centerY = height / 2;
+  const maxDist = Math.sqrt(centerX ** 2 + centerY ** 2);
+  let edgeWeightedCenterDist = 0;
+  let totalEdgeStrength = 0;
+  for (let idx = 0; idx < pixelCount; idx += stride) {
+    const x = idx % width;
+    const y = Math.floor(idx / width);
+    const i = idx * channels;
+    const r = data[i] ?? 0;
+    const g = data[i + 1] ?? 0;
+    const b = data[i + 2] ?? 0;
+    const max = Math.max(r, g, b);
+    const min = Math.min(r, g, b);
+    saturations.push(max === 0 ? 0 : (max - min) / max);
+    if (x > 0 && x < width - 1 && y > 0 && y < height - 1) {
+      const getGray = (px, py) => {
+        const j = (py * width + px) * channels;
+        return ((data[j] ?? 0) + (data[j + 1] ?? 0) + (data[j + 2] ?? 0)) / 3;
+      };
+      const center = getGray(x, y);
+      const strength = Math.abs(center - getGray(x - 1, y)) + Math.abs(center - getGray(x + 1, y)) + Math.abs(center - getGray(x, y - 1)) + Math.abs(center - getGray(x, y + 1));
+      if (strength > 10) {
+        const distFromCenter = Math.sqrt((x - centerX) ** 2 + (y - centerY) ** 2);
+        const normalizedDist = maxDist > 0 ? distFromCenter / maxDist : 0;
+        edgeWeightedCenterDist += normalizedDist * strength;
+        totalEdgeStrength += strength;
+      }
+    }
+  }
+  saturations.sort((a, b) => a - b);
+  const medianSaturation = saturations[Math.floor(saturations.length / 2)] ?? 0;
+  const avgEdgeDist = totalEdgeStrength > 0 ? edgeWeightedCenterDist / totalEdgeStrength : 0.5;
+  const edgeCentrality = 1 - avgEdgeDist;
+  return { medianSaturation, edgeCentrality };
+}
+function colorlip(data, width, height, channels, options) {
+  const opts = resolveOptions(options);
+  const result = extractAdvanced(data, width, height, channels, opts);
+  if (result.length > 0) return result;
+  return extractFallbackPalette(data, width, height, channels, opts);
+}
+function extractFallbackPalette(data, width, height, channels, options) {
+  const opts = resolveOptions(options);
+  const pixelCount = width * height;
+  if (pixelCount === 0) return [];
+  const colorCounts = /* @__PURE__ */ new Map();
+  let validPixels = 0;
+  for (let y = 0; y < height; y++) {
+    for (let x = 0; x < width; x++) {
+      const index = (y * width + x) * channels;
+      const alpha = channels >= 4 ? data[index + 3] ?? 255 : 255;
+      if (alpha < ALPHA_THRESHOLD) continue;
+      const r = data[index] ?? 0;
+      const g = data[index + 1] ?? 0;
+      const b = data[index + 2] ?? 0;
+      const qr = Math.round(r / FALLBACK_QUANTIZATION_STEP) * FALLBACK_QUANTIZATION_STEP;
+      const qg = Math.round(g / FALLBACK_QUANTIZATION_STEP) * FALLBACK_QUANTIZATION_STEP;
+      const qb = Math.round(b / FALLBACK_QUANTIZATION_STEP) * FALLBACK_QUANTIZATION_STEP;
+      const key = qr << 16 | qg << 8 | qb;
+      colorCounts.set(key, (colorCounts.get(key) ?? 0) + 1);
+      validPixels++;
+    }
+  }
+  if (validPixels === 0) return [];
+  if (colorCounts.size === 0) {
+    const avg = calculateAverageColor(data, width, height, channels);
+    return avg ? [avg] : [];
+  }
+  const sorted = Array.from(colorCounts.entries()).sort((a, b) => b[1] - a[1]);
+  return sorted.slice(0, opts.numColors).map(([key, count]) => {
+    const r = key >> 16 & 255;
+    const g = key >> 8 & 255;
+    const b = key & 255;
+    return createDominantColor(r, g, b, count / validPixels);
+  });
+}
+function rgbToHex(r, g, b) {
+  return `#${[r, g, b].map((x) => {
+    const hex = x.toString(16);
+    return hex.length === 1 ? `0${hex}` : hex;
+  }).join("").toUpperCase()}`;
+}
+function rgbToHsl(r, g, b) {
+  const rn = r / 255;
+  const gn = g / 255;
+  const bn = b / 255;
+  const max = Math.max(rn, gn, bn);
+  const min = Math.min(rn, gn, bn);
+  let h = 0;
+  let s = 0;
+  const l = (max + min) / 2;
+  if (max !== min) {
+    const d = max - min;
+    s = l > 0.5 ? d / (2 - max - min) : d / (max + min);
+    switch (max) {
+      case rn:
+        h = (gn - bn) / d + (gn < bn ? 6 : 0);
+        break;
+      case gn:
+        h = (bn - rn) / d + 2;
+        break;
+      case bn:
+        h = (rn - gn) / d + 4;
+        break;
+    }
+    h /= 6;
+  }
+  return {
+    h: Math.round(h * 360),
+    s: Math.round(s * 100),
+    l: Math.round(l * 100)
+  };
+}
+function getHueCategory(hue) {
+  let h = hue % 360;
+  if (h < 0) h += 360;
+  if (h >= 345 || h < 15) return "red";
+  if (h < 45) return "orange";
+  if (h < 75) return "yellow";
+  if (h < 135) return "green";
+  if (h < 195) return "cyan";
+  if (h < 255) return "blue";
+  if (h < 345) return "violet";
+  return "gray";
+}
+function createDominantColor(r, g, b, percentage) {
+  const hsl = rgbToHsl(r, g, b);
+  const hueCategory = hsl.s <= 5 ? "gray" : getHueCategory(hsl.h);
+  return {
+    r,
+    g,
+    b,
+    hex: rgbToHex(r, g, b),
+    percentage,
+    hue: hsl.h,
+    saturation: hsl.s,
+    lightness: hsl.l,
+    hueCategory
+  };
+}
+function aggregateColors(colorSets, numColors = 3) {
+  const colorMap = /* @__PURE__ */ new Map();
+  for (const colors of colorSets) {
+    for (const color of colors) {
+      const key = color.hex;
+      const existing = colorMap.get(key);
+      if (existing) {
+        existing.weight += color.percentage;
+      } else {
+        colorMap.set(key, { color: { ...color }, weight: color.percentage });
+      }
+    }
+  }
+  return Array.from(colorMap.values()).sort((a, b) => b.weight - a.weight).slice(0, numColors).map(
+    (item) => createDominantColor(item.color.r, item.color.g, item.color.b, item.weight / colorSets.length)
+  );
+}
+function resolveOptions(options) {
+  return { ...DEFAULT_OPTIONS, ...options };
+}
+function calculateSaturation(r, g, b) {
+  const max = Math.max(r, g, b);
+  const min = Math.min(r, g, b);
+  if (max === 0) return 0;
+  return (max - min) / max;
+}
+function calculateEdgeWeight(data, x, y, width, height, channels) {
+  if (x === 0 || y === 0 || x === width - 1 || y === height - 1) {
+    return BORDER_EDGE_WEIGHT;
+  }
+  const getGray = (px, py) => {
+    const i = (py * width + px) * channels;
+    return ((data[i] ?? 0) + (data[i + 1] ?? 0) + (data[i + 2] ?? 0)) / 3;
+  };
+  const center = getGray(x, y);
+  const edgeStrength = Math.abs(center - getGray(x - 1, y)) + Math.abs(center - getGray(x + 1, y)) + Math.abs(center - getGray(x, y - 1)) + Math.abs(center - getGray(x, y + 1));
+  return 1 + Math.min(edgeStrength / EDGE_STRENGTH_DIVISOR, 1);
+}
+function calculateAverageColor(data, width, height, channels) {
+  let sumR = 0;
+  let sumG = 0;
+  let sumB = 0;
+  let counted = 0;
+  for (let y = 0; y < height; y++) {
+    for (let x = 0; x < width; x++) {
+      const index = (y * width + x) * channels;
+      const alpha = channels >= 4 ? data[index + 3] ?? 255 : 255;
+      if (alpha < ALPHA_THRESHOLD) continue;
+      sumR += data[index] ?? 0;
+      sumG += data[index + 1] ?? 0;
+      sumB += data[index + 2] ?? 0;
+      counted++;
+    }
+  }
+  if (counted === 0) return null;
+  return createDominantColor(
+    Math.round(sumR / counted),
+    Math.round(sumG / counted),
+    Math.round(sumB / counted),
+    1
+  );
+}
+var DEFAULT_MERGE_DELTA_E = 15;
+function extractAdvanced(data, width, height, channels, opts) {
+  const pixelCount = width * height;
+  if (pixelCount === 0) return [];
+  const stats = analyzeImageStats(data, width, height, channels);
+  const adaptedSatThreshold = stats.medianSaturation < 0.1 ? Math.min(opts.saturationThreshold, 0.05) : opts.saturationThreshold;
+  const centerWeightScale = 0.3 + 0.7 * stats.edgeCentrality;
+  const centerX = Math.floor(width / 2);
+  const centerY = Math.floor(height / 2);
+  const maxDistance = Math.sqrt(centerX * centerX + centerY * centerY);
+  const colorMap = /* @__PURE__ */ new Map();
+  for (let y = 0; y < height; y++) {
+    for (let x = 0; x < width; x++) {
+      const i = (y * width + x) * channels;
+      const r = data[i] ?? 0;
+      const g = data[i + 1] ?? 0;
+      const b = data[i + 2] ?? 0;
+      const saturation = calculateSaturation(r, g, b);
+      if (saturation < adaptedSatThreshold) continue;
+      const brightness = (r + g + b) / 3;
+      if (brightness < opts.brightnessMin || brightness > opts.brightnessMax) continue;
+      const distanceFromCenter = Math.sqrt((x - centerX) ** 2 + (y - centerY) ** 2);
+      const rawCenterWeight = maxDistance > 0 ? 1 - distanceFromCenter / maxDistance : 0;
+      const centerWeight = 1 + rawCenterWeight * centerWeightScale;
+      const edgeWeight = calculateEdgeWeight(data, x, y, width, height, channels);
+      const step = opts.quantizationStep;
+      const qr = Math.round(r / step) * step;
+      const qg = Math.round(g / step) * step;
+      const qb = Math.round(b / step) * step;
+      const key = qr << 16 | qg << 8 | qb;
+      const totalWeight = centerWeight * edgeWeight * (1 + saturation);
+      const existing = colorMap.get(key);
+      if (existing) {
+        existing.weight += totalWeight;
+        existing.sumX += x;
+        existing.sumY += y;
+        existing.sumX2 += x * x;
+        existing.sumY2 += y * y;
+        existing.count++;
+      } else {
+        colorMap.set(key, {
+          weight: totalWeight,
+          saturation,
+          sumX: x,
+          sumY: y,
+          sumX2: x * x,
+          sumY2: y * y,
+          count: 1
+        });
+      }
+    }
+  }
+  const colorEntries = Array.from(colorMap.entries()).map(([key, entry]) => {
+    const r = key >> 16 & 255;
+    const g = key >> 8 & 255;
+    const b = key & 255;
+    let variance = 0;
+    if (entry.count >= 2) {
+      const n = entry.count;
+      variance = entry.sumX2 / n - (entry.sumX / n) ** 2 + (entry.sumY2 / n - (entry.sumY / n) ** 2);
+    }
+    const normalizedVariance = Math.min(variance / (width * height), 1);
+    const score = entry.weight * (1 + entry.saturation) * (1 + normalizedVariance * 0.5);
+    const lab = rgbToLab(r, g, b);
+    return { r, g, b, score, weight: entry.weight, key, lab };
+  });
+  const sortedColors = colorEntries.sort((a, b) => b.score - a.score);
+  const dominantColors = [];
+  const usedEntries = [];
+  for (const color of sortedColors) {
+    if (dominantColors.length >= opts.numColors) break;
+    if (usedEntries.some((u) => u.key === color.key)) continue;
+    let merged = false;
+    for (const used of usedEntries) {
+      if (deltaE76(color.lab, used.lab) < DEFAULT_MERGE_DELTA_E) {
+        merged = true;
+        break;
+      }
+    }
+    if (!merged) {
+      usedEntries.push({ key: color.key, lab: color.lab });
+      dominantColors.push(
+        createDominantColor(color.r, color.g, color.b, color.weight / pixelCount)
+      );
+    }
+  }
+  return dominantColors;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  DEFAULT_OPTIONS,
+  aggregateColors,
+  colorlip,
+  createDominantColor,
+  extractFallbackPalette,
+  getHueCategory,
+  rgbToHex,
+  rgbToHsl
+});
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/constants.ts","../src/core.ts"],"sourcesContent":["// Types\nexport type {\n  DominantColor,\n  ExtractOptions,\n  HSL,\n  HueCategory,\n  ImageInfo,\n  PixelData,\n} from \"./types\";\n\n// Constants\nexport { DEFAULT_OPTIONS } from \"./constants\";\n\n// Core functions\nexport {\n  aggregateColors,\n  createDominantColor,\n  extractFallbackPalette,\n  colorlip,\n  getHueCategory,\n  rgbToHex,\n  rgbToHsl,\n} from \"./core\";\n","import type { ExtractOptions } from \"./types\";\n\nexport const DEFAULT_OPTIONS: Required<ExtractOptions> = {\n  numColors: 3,\n  saturationThreshold: 0.15,\n  brightnessMin: 20,\n  brightnessMax: 235,\n  quantizationStep: 12,\n} as const;\n\n/** フォールバック時の量子化ステップ */\nexport const FALLBACK_QUANTIZATION_STEP = 16;\n\n/** アルファ値の最小閾値（これ未満は透明扱い） */\nexport const ALPHA_THRESHOLD = 16;\n\n/** エッジ重みの正規化係数 */\nexport const EDGE_STRENGTH_DIVISOR = 100;\n\n/** 境界ピクセルのエッジ重み */\nexport const BORDER_EDGE_WEIGHT = 1.5;\n\n/** sharp アダプター用リサイズ上限 */\nexport const MAX_RESIZE = 150;\n","import {\n  ALPHA_THRESHOLD,\n  BORDER_EDGE_WEIGHT,\n  DEFAULT_OPTIONS,\n  EDGE_STRENGTH_DIVISOR,\n  FALLBACK_QUANTIZATION_STEP,\n} from \"./constants\";\nimport type { DominantColor, ExtractOptions, HSL, HueCategory, PixelData } from \"./types\";\n\n// ---------------------------------------------------------------------------\n// CIELAB color space\n// ---------------------------------------------------------------------------\n\ninterface Lab {\n  L: number;\n  a: number;\n  b: number;\n}\n\n/** RGB (0-255) → CIELAB。D65 白色点使用。 */\nfunction rgbToLab(r: number, g: number, b: number): Lab {\n  // sRGB → linear RGB\n  let rl = r / 255;\n  let gl = g / 255;\n  let bl = b / 255;\n\n  rl = rl > 0.04045 ? ((rl + 0.055) / 1.055) ** 2.4 : rl / 12.92;\n  gl = gl > 0.04045 ? ((gl + 0.055) / 1.055) ** 2.4 : gl / 12.92;\n  bl = bl > 0.04045 ? ((bl + 0.055) / 1.055) ** 2.4 : bl / 12.92;\n\n  // linear RGB → XYZ (D65)\n  let x = (rl * 0.4124564 + gl * 0.3575761 + bl * 0.1804375) / 0.95047;\n  let y = rl * 0.2126729 + gl * 0.7151522 + bl * 0.072175;\n  let z = (rl * 0.0193339 + gl * 0.119192 + bl * 0.9503041) / 1.08883;\n\n  // XYZ → Lab\n  const epsilon = 0.008856;\n  const kappa = 903.3;\n\n  x = x > epsilon ? Math.cbrt(x) : (kappa * x + 16) / 116;\n  y = y > epsilon ? Math.cbrt(y) : (kappa * y + 16) / 116;\n  z = z > epsilon ? Math.cbrt(z) : (kappa * z + 16) / 116;\n\n  return {\n    L: 116 * y - 16,\n    a: 500 * (x - y),\n    b: 200 * (y - z),\n  };\n}\n\n/** CIE76 Delta E（Lab 空間でのユークリッド距離） */\nfunction deltaE76(lab1: Lab, lab2: Lab): number {\n  return Math.sqrt((lab1.L - lab2.L) ** 2 + (lab1.a - lab2.a) ** 2 + (lab1.b - lab2.b) ** 2);\n}\n\n// ---------------------------------------------------------------------------\n// Image analysis (sampling pass)\n// ---------------------------------------------------------------------------\n\ninterface ImageStats {\n  /** 彩度の中央値 (0-1) */\n  medianSaturation: number;\n  /** エッジの中央集中度 (0-1, 1=完全に中央集中) */\n  edgeCentrality: number;\n}\n\n/** ストライドサンプリングで画像統計を計算 */\nfunction analyzeImageStats(\n  data: PixelData,\n  width: number,\n  height: number,\n  channels: number,\n): ImageStats {\n  const pixelCount = width * height;\n  if (pixelCount === 0) return { medianSaturation: 0, edgeCentrality: 0.5 };\n\n  // ~10% サンプリング（最低100、最大2000ピクセル）\n  const sampleCount = Math.min(Math.max(Math.floor(pixelCount * 0.1), 100), 2000);\n  const stride = Math.max(1, Math.floor(pixelCount / sampleCount));\n\n  const saturations: number[] = [];\n\n  const centerX = width / 2;\n  const centerY = height / 2;\n  const maxDist = Math.sqrt(centerX ** 2 + centerY ** 2);\n\n  let edgeWeightedCenterDist = 0;\n  let totalEdgeStrength = 0;\n\n  for (let idx = 0; idx < pixelCount; idx += stride) {\n    const x = idx % width;\n    const y = Math.floor(idx / width);\n    const i = idx * channels;\n\n    const r = data[i] ?? 0;\n    const g = data[i + 1] ?? 0;\n    const b = data[i + 2] ?? 0;\n\n    // 彩度を収集\n    const max = Math.max(r, g, b);\n    const min = Math.min(r, g, b);\n    saturations.push(max === 0 ? 0 : (max - min) / max);\n\n    // エッジ強度を計算（境界でなければ）\n    if (x > 0 && x < width - 1 && y > 0 && y < height - 1) {\n      const getGray = (px: number, py: number): number => {\n        const j = (py * width + px) * channels;\n        return ((data[j] ?? 0) + (data[j + 1] ?? 0) + (data[j + 2] ?? 0)) / 3;\n      };\n      const center = getGray(x, y);\n      const strength =\n        Math.abs(center - getGray(x - 1, y)) +\n        Math.abs(center - getGray(x + 1, y)) +\n        Math.abs(center - getGray(x, y - 1)) +\n        Math.abs(center - getGray(x, y + 1));\n\n      if (strength > 10) {\n        const distFromCenter = Math.sqrt((x - centerX) ** 2 + (y - centerY) ** 2);\n        const normalizedDist = maxDist > 0 ? distFromCenter / maxDist : 0;\n        edgeWeightedCenterDist += normalizedDist * strength;\n        totalEdgeStrength += strength;\n      }\n    }\n  }\n\n  // 彩度の中央値\n  saturations.sort((a, b) => a - b);\n  const medianSaturation = saturations[Math.floor(saturations.length / 2)] ?? 0;\n\n  // エッジ集中度: 平均重み付き距離が小さいほど中央集中\n  // 0 = 全エッジが中央、1 = 全エッジが辺縁\n  const avgEdgeDist = totalEdgeStrength > 0 ? edgeWeightedCenterDist / totalEdgeStrength : 0.5;\n  const edgeCentrality = 1 - avgEdgeDist;\n\n  return { medianSaturation, edgeCentrality };\n}\n\n// ---------------------------------------------------------------------------\n// Public API\n// ---------------------------------------------------------------------------\n\n/**\n * ピクセルデータから代表色を抽出する（メインエントリ）。\n *\n * 内部で高度なアルゴリズム → フォールバック → 平均色 の順にフォールバックする。\n */\nexport function colorlip(\n  data: PixelData,\n  width: number,\n  height: number,\n  channels: number,\n  options?: ExtractOptions,\n): DominantColor[] {\n  const opts = resolveOptions(options);\n\n  const result = extractAdvanced(data, width, height, channels, opts);\n  if (result.length > 0) return result;\n\n  return extractFallbackPalette(data, width, height, channels, opts);\n}\n\n/**\n * フォールバック用パレット抽出。\n * グレースケール画像など、メインアルゴリズムで色が取れない場合に使用。\n */\nexport function extractFallbackPalette(\n  data: PixelData,\n  width: number,\n  height: number,\n  channels: number,\n  options?: ExtractOptions,\n): DominantColor[] {\n  const opts = resolveOptions(options);\n  const pixelCount = width * height;\n  if (pixelCount === 0) return [];\n\n  const colorCounts = new Map<number, number>();\n  let validPixels = 0;\n\n  for (let y = 0; y < height; y++) {\n    for (let x = 0; x < width; x++) {\n      const index = (y * width + x) * channels;\n      const alpha = channels >= 4 ? (data[index + 3] ?? 255) : 255;\n      if (alpha < ALPHA_THRESHOLD) continue;\n\n      const r = data[index] ?? 0;\n      const g = data[index + 1] ?? 0;\n      const b = data[index + 2] ?? 0;\n\n      const qr = Math.round(r / FALLBACK_QUANTIZATION_STEP) * FALLBACK_QUANTIZATION_STEP;\n      const qg = Math.round(g / FALLBACK_QUANTIZATION_STEP) * FALLBACK_QUANTIZATION_STEP;\n      const qb = Math.round(b / FALLBACK_QUANTIZATION_STEP) * FALLBACK_QUANTIZATION_STEP;\n      const key = (qr << 16) | (qg << 8) | qb;\n\n      colorCounts.set(key, (colorCounts.get(key) ?? 0) + 1);\n      validPixels++;\n    }\n  }\n\n  if (validPixels === 0) return [];\n\n  if (colorCounts.size === 0) {\n    const avg = calculateAverageColor(data, width, height, channels);\n    return avg ? [avg] : [];\n  }\n\n  const sorted = Array.from(colorCounts.entries()).sort((a, b) => b[1] - a[1]);\n  return sorted.slice(0, opts.numColors).map(([key, count]) => {\n    const r = (key >> 16) & 0xff;\n    const g = (key >> 8) & 0xff;\n    const b = key & 0xff;\n    return createDominantColor(r, g, b, count / validPixels);\n  });\n}\n\n/**\n * RGB → 16進数カラーコード（例: `#FF00AA`）。\n */\nexport function rgbToHex(r: number, g: number, b: number): string {\n  return `#${[r, g, b]\n    .map((x) => {\n      const hex = x.toString(16);\n      return hex.length === 1 ? `0${hex}` : hex;\n    })\n    .join(\"\")\n    .toUpperCase()}`;\n}\n\n/**\n * RGB → HSL 変換。\n */\nexport function rgbToHsl(r: number, g: number, b: number): HSL {\n  const rn = r / 255;\n  const gn = g / 255;\n  const bn = b / 255;\n\n  const max = Math.max(rn, gn, bn);\n  const min = Math.min(rn, gn, bn);\n  let h = 0;\n  let s = 0;\n  const l = (max + min) / 2;\n\n  if (max !== min) {\n    const d = max - min;\n    s = l > 0.5 ? d / (2 - max - min) : d / (max + min);\n\n    switch (max) {\n      case rn:\n        h = (gn - bn) / d + (gn < bn ? 6 : 0);\n        break;\n      case gn:\n        h = (bn - rn) / d + 2;\n        break;\n      case bn:\n        h = (rn - gn) / d + 4;\n        break;\n    }\n    h /= 6;\n  }\n\n  return {\n    h: Math.round(h * 360),\n    s: Math.round(s * 100),\n    l: Math.round(l * 100),\n  };\n}\n\n/**\n * 色相値から色相カテゴリを判定。\n */\nexport function getHueCategory(hue: number): HueCategory {\n  let h = hue % 360;\n  if (h < 0) h += 360;\n\n  if (h >= 345 || h < 15) return \"red\";\n  if (h < 45) return \"orange\";\n  if (h < 75) return \"yellow\";\n  if (h < 135) return \"green\";\n  if (h < 195) return \"cyan\";\n  if (h < 255) return \"blue\";\n  if (h < 345) return \"violet\";\n\n  return \"gray\";\n}\n\n/**\n * RGB + percentage から DominantColor オブジェクトを生成。\n */\nexport function createDominantColor(\n  r: number,\n  g: number,\n  b: number,\n  percentage: number,\n): DominantColor {\n  const hsl = rgbToHsl(r, g, b);\n  const hueCategory: HueCategory = hsl.s <= 5 ? \"gray\" : getHueCategory(hsl.h);\n  return {\n    r,\n    g,\n    b,\n    hex: rgbToHex(r, g, b),\n    percentage,\n    hue: hsl.h,\n    saturation: hsl.s,\n    lightness: hsl.l,\n    hueCategory,\n  };\n}\n\n/**\n * 複数画像の色セットを集約し、上位 numColors 色を返す。\n */\nexport function aggregateColors(colorSets: DominantColor[][], numColors = 3): DominantColor[] {\n  const colorMap = new Map<string, { color: DominantColor; weight: number }>();\n\n  for (const colors of colorSets) {\n    for (const color of colors) {\n      const key = color.hex;\n      const existing = colorMap.get(key);\n\n      if (existing) {\n        existing.weight += color.percentage;\n      } else {\n        colorMap.set(key, { color: { ...color }, weight: color.percentage });\n      }\n    }\n  }\n\n  return Array.from(colorMap.values())\n    .sort((a, b) => b.weight - a.weight)\n    .slice(0, numColors)\n    .map((item) =>\n      createDominantColor(item.color.r, item.color.g, item.color.b, item.weight / colorSets.length),\n    );\n}\n\n// ---------------------------------------------------------------------------\n// Internal helpers\n// ---------------------------------------------------------------------------\n\nfunction resolveOptions(options?: ExtractOptions): Required<ExtractOptions> {\n  return { ...DEFAULT_OPTIONS, ...options };\n}\n\n/** HSV 彩度を計算 */\nfunction calculateSaturation(r: number, g: number, b: number): number {\n  const max = Math.max(r, g, b);\n  const min = Math.min(r, g, b);\n  if (max === 0) return 0;\n  return (max - min) / max;\n}\n\n/** エッジ重みを計算（簡易ソーベルフィルタ） */\nfunction calculateEdgeWeight(\n  data: PixelData,\n  x: number,\n  y: number,\n  width: number,\n  height: number,\n  channels: number,\n): number {\n  if (x === 0 || y === 0 || x === width - 1 || y === height - 1) {\n    return BORDER_EDGE_WEIGHT;\n  }\n\n  const getGray = (px: number, py: number): number => {\n    const i = (py * width + px) * channels;\n    return ((data[i] ?? 0) + (data[i + 1] ?? 0) + (data[i + 2] ?? 0)) / 3;\n  };\n\n  const center = getGray(x, y);\n  const edgeStrength =\n    Math.abs(center - getGray(x - 1, y)) +\n    Math.abs(center - getGray(x + 1, y)) +\n    Math.abs(center - getGray(x, y - 1)) +\n    Math.abs(center - getGray(x, y + 1));\n\n  return 1 + Math.min(edgeStrength / EDGE_STRENGTH_DIVISOR, 1);\n}\n\n/** 画像全体の平均色を計算 */\nfunction calculateAverageColor(\n  data: PixelData,\n  width: number,\n  height: number,\n  channels: number,\n): DominantColor | null {\n  let sumR = 0;\n  let sumG = 0;\n  let sumB = 0;\n  let counted = 0;\n\n  for (let y = 0; y < height; y++) {\n    for (let x = 0; x < width; x++) {\n      const index = (y * width + x) * channels;\n      const alpha = channels >= 4 ? (data[index + 3] ?? 255) : 255;\n      if (alpha < ALPHA_THRESHOLD) continue;\n\n      sumR += data[index] ?? 0;\n      sumG += data[index + 1] ?? 0;\n      sumB += data[index + 2] ?? 0;\n      counted++;\n    }\n  }\n\n  if (counted === 0) return null;\n\n  return createDominantColor(\n    Math.round(sumR / counted),\n    Math.round(sumG / counted),\n    Math.round(sumB / counted),\n    1,\n  );\n}\n\n// ---------------------------------------------------------------------------\n// Main algorithm (CIELAB Delta E + adaptive thresholds)\n// ---------------------------------------------------------------------------\n\n/** Delta E のデフォルトマージ閾値 */\nconst DEFAULT_MERGE_DELTA_E = 15;\n\n/** 高度な色抽出アルゴリズム（メインロジック） */\nfunction extractAdvanced(\n  data: PixelData,\n  width: number,\n  height: number,\n  channels: number,\n  opts: Required<ExtractOptions>,\n): DominantColor[] {\n  const pixelCount = width * height;\n  if (pixelCount === 0) return [];\n\n  // サンプリングパスで画像特性を分析\n  const stats = analyzeImageStats(data, width, height, channels);\n\n  // 適応的彩度閾値\n  const adaptedSatThreshold =\n    stats.medianSaturation < 0.1\n      ? Math.min(opts.saturationThreshold, 0.05)\n      : opts.saturationThreshold;\n\n  // 適応的中央重み係数 (0.3 〜 1.0)\n  // edgeCentrality が高い → イラスト型 → 中央重み強め\n  // edgeCentrality が低い → 写真型 → 中央重み弱め\n  const centerWeightScale = 0.3 + 0.7 * stats.edgeCentrality;\n\n  const centerX = Math.floor(width / 2);\n  const centerY = Math.floor(height / 2);\n  const maxDistance = Math.sqrt(centerX * centerX + centerY * centerY);\n\n  const colorMap = new Map<\n    number,\n    {\n      weight: number;\n      saturation: number;\n      sumX: number;\n      sumY: number;\n      sumX2: number;\n      sumY2: number;\n      count: number;\n    }\n  >();\n\n  for (let y = 0; y < height; y++) {\n    for (let x = 0; x < width; x++) {\n      const i = (y * width + x) * channels;\n      const r = data[i] ?? 0;\n      const g = data[i + 1] ?? 0;\n      const b = data[i + 2] ?? 0;\n\n      // 適応的彩度フィルタ\n      const saturation = calculateSaturation(r, g, b);\n      if (saturation < adaptedSatThreshold) continue;\n\n      const brightness = (r + g + b) / 3;\n      if (brightness < opts.brightnessMin || brightness > opts.brightnessMax) continue;\n\n      // 適応的中央重み\n      const distanceFromCenter = Math.sqrt((x - centerX) ** 2 + (y - centerY) ** 2);\n      const rawCenterWeight = maxDistance > 0 ? 1 - distanceFromCenter / maxDistance : 0;\n      const centerWeight = 1 + rawCenterWeight * centerWeightScale;\n\n      const edgeWeight = calculateEdgeWeight(data, x, y, width, height, channels);\n\n      const step = opts.quantizationStep;\n      const qr = Math.round(r / step) * step;\n      const qg = Math.round(g / step) * step;\n      const qb = Math.round(b / step) * step;\n      const key = (qr << 16) | (qg << 8) | qb;\n\n      const totalWeight = centerWeight * edgeWeight * (1 + saturation);\n\n      const existing = colorMap.get(key);\n      if (existing) {\n        existing.weight += totalWeight;\n        existing.sumX += x;\n        existing.sumY += y;\n        existing.sumX2 += x * x;\n        existing.sumY2 += y * y;\n        existing.count++;\n      } else {\n        colorMap.set(key, {\n          weight: totalWeight,\n          saturation,\n          sumX: x,\n          sumY: y,\n          sumX2: x * x,\n          sumY2: y * y,\n          count: 1,\n        });\n      }\n    }\n  }\n\n  // スコアリング\n  const colorEntries = Array.from(colorMap.entries()).map(([key, entry]) => {\n    const r = (key >> 16) & 0xff;\n    const g = (key >> 8) & 0xff;\n    const b = key & 0xff;\n\n    // オンライン分散: Var(X) + Var(Y) = (sumX2/n - (sumX/n)^2) + (sumY2/n - (sumY/n)^2)\n    let variance = 0;\n    if (entry.count >= 2) {\n      const n = entry.count;\n      variance =\n        entry.sumX2 / n - (entry.sumX / n) ** 2 + (entry.sumY2 / n - (entry.sumY / n) ** 2);\n    }\n    const normalizedVariance = Math.min(variance / (width * height), 1);\n    const score = entry.weight * (1 + entry.saturation) * (1 + normalizedVariance * 0.5);\n\n    // Lab を事前計算してマージで使う\n    const lab = rgbToLab(r, g, b);\n\n    return { r, g, b, score, weight: entry.weight, key, lab };\n  });\n\n  // スコア順ソート → Lab ベースの類似色マージ\n  const sortedColors = colorEntries.sort((a, b) => b.score - a.score);\n  const dominantColors: DominantColor[] = [];\n  const usedEntries: Array<{ key: number; lab: Lab }> = [];\n\n  for (const color of sortedColors) {\n    if (dominantColors.length >= opts.numColors) break;\n    if (usedEntries.some((u) => u.key === color.key)) continue;\n\n    // Delta E によるマージ判定\n    let merged = false;\n    for (const used of usedEntries) {\n      if (deltaE76(color.lab, used.lab) < DEFAULT_MERGE_DELTA_E) {\n        merged = true;\n        break;\n      }\n    }\n\n    if (!merged) {\n      usedEntries.push({ key: color.key, lab: color.lab });\n      dominantColors.push(\n        createDominantColor(color.r, color.g, color.b, color.weight / pixelCount),\n      );\n    }\n  }\n\n  return dominantColors;\n}\n\n// ---------------------------------------------------------------------------\n// Test exports (internal functions exposed for testing)\n// ---------------------------------------------------------------------------\n\nexport const _internals = {\n  rgbToLab,\n  deltaE76,\n  analyzeImageStats,\n};\n"],"mappings":"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","names":[]}

package/dist/index.d.cts

@@ -0,0 +1,84 @@
+/** 色相カテゴリ（7色 + gray） */
+type HueCategory = "red" | "orange" | "yellow" | "green" | "cyan" | "blue" | "violet" | "gray";
+/** HSL 色空間 */
+interface HSL {
+    /** 色相 (0–360) */
+    h: number;
+    /** 彩度 (0–100) */
+    s: number;
+    /** 明度 (0–100) */
+    l: number;
+}
+/** 画像のピクセルバッファ情報 */
+interface ImageInfo {
+    width: number;
+    height: number;
+    channels: number;
+}
+/** 抽出された代表色 */
+interface DominantColor {
+    r: number;
+    g: number;
+    b: number;
+    hex: string;
+    percentage: number;
+    /** 色相 (0–360) */
+    hue: number;
+    /** 彩度 (0–100) */
+    saturation: number;
+    /** 明度 (0–100) */
+    lightness: number;
+    /** 色相カテゴリ */
+    hueCategory: HueCategory;
+}
+/** 抽出オプション */
+interface ExtractOptions {
+    /** 抽出する色の数（デフォルト: 3） */
+    numColors?: number;
+    /** 彩度フィルタの閾値（デフォルト: 0.15） */
+    saturationThreshold?: number;
+    /** 明度の下限（デフォルト: 20） */
+    brightnessMin?: number;
+    /** 明度の上限（デフォルト: 235） */
+    brightnessMax?: number;
+    /** 量子化ステップ（デフォルト: 12） */
+    quantizationStep?: number;
+}
+/** ピクセルデータの型（Node.js Buffer / ブラウザ Uint8ClampedArray 双方対応） */
+type PixelData = Uint8Array | Uint8ClampedArray;
+
+declare const DEFAULT_OPTIONS: Required<ExtractOptions>;
+
+/**
+ * ピクセルデータから代表色を抽出する（メインエントリ）。
+ *
+ * 内部で高度なアルゴリズム → フォールバック → 平均色 の順にフォールバックする。
+ */
+declare function colorlip(data: PixelData, width: number, height: number, channels: number, options?: ExtractOptions): DominantColor[];
+/**
+ * フォールバック用パレット抽出。
+ * グレースケール画像など、メインアルゴリズムで色が取れない場合に使用。
+ */
+declare function extractFallbackPalette(data: PixelData, width: number, height: number, channels: number, options?: ExtractOptions): DominantColor[];
+/**
+ * RGB → 16進数カラーコード（例: `#FF00AA`）。
+ */
+declare function rgbToHex(r: number, g: number, b: number): string;
+/**
+ * RGB → HSL 変換。
+ */
+declare function rgbToHsl(r: number, g: number, b: number): HSL;
+/**
+ * 色相値から色相カテゴリを判定。
+ */
+declare function getHueCategory(hue: number): HueCategory;
+/**
+ * RGB + percentage から DominantColor オブジェクトを生成。
+ */
+declare function createDominantColor(r: number, g: number, b: number, percentage: number): DominantColor;
+/**
+ * 複数画像の色セットを集約し、上位 numColors 色を返す。
+ */
+declare function aggregateColors(colorSets: DominantColor[][], numColors?: number): DominantColor[];
+
+export { DEFAULT_OPTIONS, type DominantColor, type ExtractOptions, type HSL, type HueCategory, type ImageInfo, type PixelData, aggregateColors, colorlip, createDominantColor, extractFallbackPalette, getHueCategory, rgbToHex, rgbToHsl };

package/dist/index.d.ts

@@ -0,0 +1,84 @@
+/** 色相カテゴリ（7色 + gray） */
+type HueCategory = "red" | "orange" | "yellow" | "green" | "cyan" | "blue" | "violet" | "gray";
+/** HSL 色空間 */
+interface HSL {
+    /** 色相 (0–360) */
+    h: number;
+    /** 彩度 (0–100) */
+    s: number;
+    /** 明度 (0–100) */
+    l: number;
+}
+/** 画像のピクセルバッファ情報 */
+interface ImageInfo {
+    width: number;
+    height: number;
+    channels: number;
+}
+/** 抽出された代表色 */
+interface DominantColor {
+    r: number;
+    g: number;
+    b: number;
+    hex: string;
+    percentage: number;
+    /** 色相 (0–360) */
+    hue: number;
+    /** 彩度 (0–100) */
+    saturation: number;
+    /** 明度 (0–100) */
+    lightness: number;
+    /** 色相カテゴリ */
+    hueCategory: HueCategory;
+}
+/** 抽出オプション */
+interface ExtractOptions {
+    /** 抽出する色の数（デフォルト: 3） */
+    numColors?: number;
+    /** 彩度フィルタの閾値（デフォルト: 0.15） */
+    saturationThreshold?: number;
+    /** 明度の下限（デフォルト: 20） */
+    brightnessMin?: number;
+    /** 明度の上限（デフォルト: 235） */
+    brightnessMax?: number;
+    /** 量子化ステップ（デフォルト: 12） */
+    quantizationStep?: number;
+}
+/** ピクセルデータの型（Node.js Buffer / ブラウザ Uint8ClampedArray 双方対応） */
+type PixelData = Uint8Array | Uint8ClampedArray;
+
+declare const DEFAULT_OPTIONS: Required<ExtractOptions>;
+
+/**
+ * ピクセルデータから代表色を抽出する（メインエントリ）。
+ *
+ * 内部で高度なアルゴリズム → フォールバック → 平均色 の順にフォールバックする。
+ */
+declare function colorlip(data: PixelData, width: number, height: number, channels: number, options?: ExtractOptions): DominantColor[];
+/**
+ * フォールバック用パレット抽出。
+ * グレースケール画像など、メインアルゴリズムで色が取れない場合に使用。
+ */
+declare function extractFallbackPalette(data: PixelData, width: number, height: number, channels: number, options?: ExtractOptions): DominantColor[];
+/**
+ * RGB → 16進数カラーコード（例: `#FF00AA`）。
+ */
+declare function rgbToHex(r: number, g: number, b: number): string;
+/**
+ * RGB → HSL 変換。
+ */
+declare function rgbToHsl(r: number, g: number, b: number): HSL;
+/**
+ * 色相値から色相カテゴリを判定。
+ */
+declare function getHueCategory(hue: number): HueCategory;
+/**
+ * RGB + percentage から DominantColor オブジェクトを生成。
+ */
+declare function createDominantColor(r: number, g: number, b: number, percentage: number): DominantColor;
+/**
+ * 複数画像の色セットを集約し、上位 numColors 色を返す。
+ */
+declare function aggregateColors(colorSets: DominantColor[][], numColors?: number): DominantColor[];
+
+export { DEFAULT_OPTIONS, type DominantColor, type ExtractOptions, type HSL, type HueCategory, type ImageInfo, type PixelData, aggregateColors, colorlip, createDominantColor, extractFallbackPalette, getHueCategory, rgbToHex, rgbToHsl };