@xivdyetools/svg 1.0.0

package/dist/gradient.js

@@ -0,0 +1,131 @@
+/**
+ * Gradient Bar SVG Generator
+ *
+ * Generates a color gradient visualization showing steps between two colors
+ * with hex codes and matched dye names below each step.
+ */
+import { createSvgDocument, rect, line, text, getContrastTextColor, THEME, FONTS, } from './base.js';
+/**
+ * Generates a gradient bar SVG showing color progression with dye matches
+ */
+export function generateGradientBar(options) {
+    const { steps, width = 800, height = 200, showTicks = true, showEndLabels = true, startLabel = 'START', endLabel = 'END', } = options;
+    if (steps.length < 2) {
+        throw new Error('Gradient requires at least 2 steps');
+    }
+    const elements = [];
+    // Layout constants
+    const padding = 20;
+    const barHeight = 60;
+    const barY = 40;
+    const hexLabelY = barY + barHeight + 20;
+    const nameLabelY = hexLabelY + 18;
+    const endLabelY = barY - 10;
+    const barWidth = width - padding * 2;
+    const stepWidth = barWidth / steps.length;
+    // Background
+    elements.push(rect(0, 0, width, height, THEME.background, { rx: 12 }));
+    // Draw each color step
+    steps.forEach((step, i) => {
+        const x = padding + i * stepWidth;
+        // Color rectangle
+        elements.push(rect(x, barY, stepWidth, barHeight, step.hex, {
+            stroke: i === 0 || i === steps.length - 1 ? '#ffffff' : undefined,
+            strokeWidth: i === 0 || i === steps.length - 1 ? 2 : undefined,
+        }));
+        // Hex label below the bar
+        const centerX = x + stepWidth / 2;
+        elements.push(text(centerX, hexLabelY, step.hex.toUpperCase(), {
+            fill: THEME.textMuted,
+            fontSize: 11,
+            fontFamily: FONTS.mono,
+            textAnchor: 'middle',
+        }));
+        // Dye name below hex (if available)
+        // Uses primaryCjk font for CJK language support (Japanese/Korean/Chinese dye names)
+        if (step.dyeName) {
+            const truncatedName = truncateName(step.dyeName, 12);
+            elements.push(text(centerX, nameLabelY, truncatedName, {
+                fill: THEME.text,
+                fontSize: 10,
+                fontFamily: FONTS.primaryCjk,
+                textAnchor: 'middle',
+            }));
+        }
+    });
+    // Draw tick marks between steps
+    if (showTicks) {
+        for (let i = 1; i < steps.length; i++) {
+            const tickX = padding + i * stepWidth;
+            elements.push(line(tickX, barY - 5, tickX, barY, THEME.textDim, 1));
+            elements.push(line(tickX, barY + barHeight, tickX, barY + barHeight + 5, THEME.textDim, 1));
+        }
+    }
+    // Draw START/END labels (localized)
+    // Uses primaryCjk font for CJK language support (e.g., 開始/終了 in Japanese)
+    if (showEndLabels) {
+        elements.push(text(padding + stepWidth / 2, endLabelY, startLabel, {
+            fill: THEME.textMuted,
+            fontSize: 10,
+            fontFamily: FONTS.primaryCjk,
+            textAnchor: 'middle',
+            fontWeight: 'bold',
+        }));
+        elements.push(text(padding + (steps.length - 0.5) * stepWidth, endLabelY, endLabel, {
+            fill: THEME.textMuted,
+            fontSize: 10,
+            fontFamily: FONTS.primaryCjk,
+            textAnchor: 'middle',
+            fontWeight: 'bold',
+        }));
+    }
+    // Outer border around the gradient bar
+    elements.push(rect(padding, barY, barWidth, barHeight, 'none', {
+        stroke: THEME.border,
+        strokeWidth: 1,
+    }));
+    return createSvgDocument(width, height, elements.join('\n'));
+}
+/**
+ * Truncates a name to fit within the step width
+ */
+function truncateName(name, maxLength) {
+    if (name.length <= maxLength)
+        return name;
+    return name.slice(0, maxLength - 2) + '..';
+}
+/**
+ * Interpolates between two colors in RGB space
+ * @param color1 Starting hex color
+ * @param color2 Ending hex color
+ * @param ratio Interpolation ratio (0 = color1, 1 = color2)
+ */
+export function interpolateColor(color1, color2, ratio) {
+    const hex1 = color1.replace('#', '');
+    const hex2 = color2.replace('#', '');
+    const r1 = parseInt(hex1.slice(0, 2), 16);
+    const g1 = parseInt(hex1.slice(2, 4), 16);
+    const b1 = parseInt(hex1.slice(4, 6), 16);
+    const r2 = parseInt(hex2.slice(0, 2), 16);
+    const g2 = parseInt(hex2.slice(2, 4), 16);
+    const b2 = parseInt(hex2.slice(4, 6), 16);
+    const r = Math.round(r1 + (r2 - r1) * ratio);
+    const g = Math.round(g1 + (g2 - g1) * ratio);
+    const b = Math.round(b1 + (b2 - b1) * ratio);
+    return `#${r.toString(16).padStart(2, '0')}${g.toString(16).padStart(2, '0')}${b.toString(16).padStart(2, '0')}`;
+}
+/**
+ * Generates an array of interpolated colors between start and end
+ * @param startColor Starting hex color
+ * @param endColor Ending hex color
+ * @param stepCount Number of steps (including start and end)
+ */
+export function generateGradientColors(startColor, endColor, stepCount) {
+    const colors = [];
+    for (let i = 0; i < stepCount; i++) {
+        const ratio = i / (stepCount - 1);
+        colors.push(interpolateColor(startColor, endColor, ratio));
+    }
+    return colors;
+}
+//# sourceMappingURL=gradient.js.map

package/dist/gradient.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gradient.js","sourceRoot":"","sources":["../src/gradient.ts"],"names":[],"mappings":"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"}

package/dist/harmony-wheel.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Harmony Wheel SVG Generator (v4 Style)
+ *
+ * Generates a modern color harmony wheel visualization matching the v4 web app design.
+ * Features:
+ * - Large center swatch showing the base color with glow effect
+ * - Smooth conic gradient ring for the color spectrum
+ * - Small colored dot nodes positioned on the ring
+ * - Dashed connection lines between harmony points
+ *
+ * Colors are positioned on the wheel based on their HSV hue value,
+ * matching the traditional color wheel representation.
+ */
+export interface HarmonyDye {
+    id: number;
+    name: string;
+    hex: string;
+    category?: string;
+}
+export interface HarmonyWheelOptions {
+    /** Base color hex */
+    baseColor: string;
+    /** Name of the base color/dye */
+    baseName?: string;
+    /** Type of harmony (triadic, complementary, etc.) */
+    harmonyType: string;
+    /** Matched dyes for the harmony */
+    dyes: HarmonyDye[];
+    /** Width of the output image */
+    width?: number;
+    /** Height of the output image */
+    height?: number;
+}
+/**
+ * Generates a v4-style harmony wheel SVG
+ */
+export declare function generateHarmonyWheel(options: HarmonyWheelOptions): string;
+//# sourceMappingURL=harmony-wheel.d.ts.map

package/dist/harmony-wheel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"harmony-wheel.d.ts","sourceRoot":"","sources":["../src/harmony-wheel.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AASH,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,mBAAmB;IAClC,qBAAqB;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,iCAAiC;IACjC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,qDAAqD;IACrD,WAAW,EAAE,MAAM,CAAC;IACpB,mCAAmC;IACnC,IAAI,EAAE,UAAU,EAAE,CAAC;IACnB,gCAAgC;IAChC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,iCAAiC;IACjC,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAuCD;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,mBAAmB,GAAG,MAAM,CAkGzE"}

package/dist/harmony-wheel.js

@@ -0,0 +1,158 @@
+/**
+ * Harmony Wheel SVG Generator (v4 Style)
+ *
+ * Generates a modern color harmony wheel visualization matching the v4 web app design.
+ * Features:
+ * - Large center swatch showing the base color with glow effect
+ * - Smooth conic gradient ring for the color spectrum
+ * - Small colored dot nodes positioned on the ring
+ * - Dashed connection lines between harmony points
+ *
+ * Colors are positioned on the wheel based on their HSV hue value,
+ * matching the traditional color wheel representation.
+ */
+import { createSvgDocument, rect, hexToRgb, THEME, } from './base.js';
+/**
+ * Converts RGB to HSV and returns the hue (0-360)
+ */
+function rgbToHue(r, g, b) {
+    r /= 255;
+    g /= 255;
+    b /= 255;
+    const max = Math.max(r, g, b);
+    const min = Math.min(r, g, b);
+    const delta = max - min;
+    let hue = 0;
+    if (delta === 0) {
+        hue = 0; // Achromatic (gray)
+    }
+    else if (max === r) {
+        hue = 60 * (((g - b) / delta) % 6);
+    }
+    else if (max === g) {
+        hue = 60 * ((b - r) / delta + 2);
+    }
+    else {
+        hue = 60 * ((r - g) / delta + 4);
+    }
+    if (hue < 0)
+        hue += 360;
+    return hue;
+}
+/**
+ * Gets the hue angle from a hex color
+ */
+function getHueFromHex(hex) {
+    const { r, g, b } = hexToRgb(hex);
+    return rgbToHue(r, g, b);
+}
+/**
+ * Generates a v4-style harmony wheel SVG
+ */
+export function generateHarmonyWheel(options) {
+    const { baseColor, baseName, harmonyType, dyes, width = 400, height = 400, } = options;
+    const centerX = width / 2;
+    const centerY = height / 2;
+    const wheelRadius = Math.min(width, height) / 2 - 30;
+    // v4 style sizing
+    const innerRadiusRatio = 0.6; // Thinner ring
+    const nodeRadiusRatio = 0.8; // Where nodes sit on the ring
+    const centerSwatchRadius = wheelRadius * 0.4; // Large center swatch (v4 style: 120px equivalent)
+    const harmonyNodeRadius = 10; // Small nodes (v4 style: 14px)
+    const baseNodeRadius = 12; // Slightly larger for base (v4 style: 18px)
+    const elements = [];
+    // Background with rounded corners
+    elements.push(rect(0, 0, width, height, THEME.background, { rx: 16 }));
+    // Generate defs for glow filter and drop shadow
+    elements.push(`<defs>
+    <filter id="centerGlow" x="-50%" y="-50%" width="200%" height="200%">
+      <feGaussianBlur in="SourceGraphic" stdDeviation="20" result="blur"/>
+      <feColorMatrix in="blur" type="matrix" values="1 0 0 0 0  0 1 0 0 0  0 0 1 0 0  0 0 0 0.4 0"/>
+      <feMerge>
+        <feMergeNode/>
+        <feMergeNode in="SourceGraphic"/>
+      </feMerge>
+    </filter>
+    <filter id="nodeShadow" x="-50%" y="-50%" width="200%" height="200%">
+      <feDropShadow dx="0" dy="2" stdDeviation="3" flood-opacity="0.5"/>
+    </filter>
+  </defs>`);
+    // Color wheel ring (v4 style: smoother gradient with reduced opacity)
+    elements.push(generateColorWheelRing(centerX, centerY, wheelRadius, innerRadiusRatio));
+    // Get base color hue for positioning
+    const baseHue = getHueFromHex(baseColor);
+    // Calculate positions for all nodes
+    const baseAngle = baseHue - 90; // -90 to start from top
+    const baseRad = (baseAngle * Math.PI) / 180;
+    const baseX = centerX + Math.cos(baseRad) * wheelRadius * nodeRadiusRatio;
+    const baseY = centerY + Math.sin(baseRad) * wheelRadius * nodeRadiusRatio;
+    // Draw dashed connection lines (v4 style)
+    // Line from center to base node
+    elements.push(createDashedLine(centerX, centerY, baseX, baseY, 'rgba(255, 255, 255, 0.4)', 1.5));
+    // Lines to harmony nodes
+    dyes.forEach((dye) => {
+        const dyeHue = getHueFromHex(dye.hex);
+        const dyeAngle = dyeHue - 90;
+        const dyeRad = (dyeAngle * Math.PI) / 180;
+        const dyeX = centerX + Math.cos(dyeRad) * wheelRadius * nodeRadiusRatio;
+        const dyeY = centerY + Math.sin(dyeRad) * wheelRadius * nodeRadiusRatio;
+        elements.push(createDashedLine(centerX, centerY, dyeX, dyeY, 'rgba(255, 255, 255, 0.4)', 1.5));
+    });
+    // Center swatch with glow effect (v4 style: prominent center display)
+    // Glow layer
+    elements.push(`<circle cx="${centerX}" cy="${centerY}" r="${centerSwatchRadius}" fill="${baseColor}" filter="url(#centerGlow)"/>`);
+    // Main center circle with border
+    elements.push(`<circle cx="${centerX}" cy="${centerY}" r="${centerSwatchRadius}" fill="${baseColor}" stroke="${THEME.background}" stroke-width="4"/>`);
+    // Draw harmony dye nodes (small colored dots)
+    dyes.forEach((dye) => {
+        const dyeHue = getHueFromHex(dye.hex);
+        const dyeAngle = dyeHue - 90;
+        const dyeRad = (dyeAngle * Math.PI) / 180;
+        const dyeX = centerX + Math.cos(dyeRad) * wheelRadius * nodeRadiusRatio;
+        const dyeY = centerY + Math.sin(dyeRad) * wheelRadius * nodeRadiusRatio;
+        // Small colored node with white border
+        elements.push(`<circle cx="${dyeX}" cy="${dyeY}" r="${harmonyNodeRadius}" fill="${dye.hex}" stroke="#ffffff" stroke-width="2" filter="url(#nodeShadow)"/>`);
+    });
+    // Draw base color node (slightly larger)
+    elements.push(`<circle cx="${baseX}" cy="${baseY}" r="${baseNodeRadius}" fill="${baseColor}" stroke="#ffffff" stroke-width="3" filter="url(#nodeShadow)"/>`);
+    return createSvgDocument(width, height, elements.join('\n'));
+}
+/**
+ * Creates a dashed line SVG element
+ */
+function createDashedLine(x1, y1, x2, y2, color, strokeWidth) {
+    return `<line x1="${x1}" y1="${y1}" x2="${x2}" y2="${y2}" stroke="${color}" stroke-width="${strokeWidth}" stroke-dasharray="6,4"/>`;
+}
+/**
+ * Generates a smooth color wheel ring (v4 style with reduced opacity)
+ */
+function generateColorWheelRing(cx, cy, radius, innerRadiusRatio = 0.6) {
+    const segments = [];
+    const segmentCount = 90; // More segments for smoother gradient
+    const segmentAngle = 360 / segmentCount;
+    const innerRadius = radius * innerRadiusRatio;
+    for (let i = 0; i < segmentCount; i++) {
+        const startAngle = i * segmentAngle;
+        const endAngle = startAngle + segmentAngle + 0.5; // Slight overlap to prevent gaps
+        const hue = startAngle;
+        // Calculate arc points
+        const startRad = ((startAngle - 90) * Math.PI) / 180;
+        const endRad = ((endAngle - 90) * Math.PI) / 180;
+        // Outer arc points
+        const ox1 = cx + radius * Math.cos(startRad);
+        const oy1 = cy + radius * Math.sin(startRad);
+        const ox2 = cx + radius * Math.cos(endRad);
+        const oy2 = cy + radius * Math.sin(endRad);
+        // Inner arc points
+        const ix1 = cx + innerRadius * Math.cos(startRad);
+        const iy1 = cy + innerRadius * Math.sin(startRad);
+        const ix2 = cx + innerRadius * Math.cos(endRad);
+        const iy2 = cy + innerRadius * Math.sin(endRad);
+        // Create wedge path
+        const path = `M ${ix1} ${iy1} L ${ox1} ${oy1} A ${radius} ${radius} 0 0 1 ${ox2} ${oy2} L ${ix2} ${iy2} A ${innerRadius} ${innerRadius} 0 0 0 ${ix1} ${iy1} Z`;
+        // v4 style: slightly reduced saturation (85%) and opacity (0.8) for softer look
+        segments.push(`<path d="${path}" fill="hsl(${hue}, 85%, 50%)" opacity="0.8" stroke="none"/>`);
+    }
+    return segments.join('\n');
+}
+//# sourceMappingURL=harmony-wheel.js.map

package/dist/harmony-wheel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"harmony-wheel.js","sourceRoot":"","sources":["../src/harmony-wheel.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,31 @@
+/**
+ * @xivdyetools/svg
+ *
+ * SVG card generators for XIV Dye Tools.
+ * All functions are pure: data in → SVG string out.
+ * Rendering to PNG (via resvg-wasm, etc.) is handled by each consuming app.
+ *
+ * @module svg
+ */
+export { escapeXml, hexToRgb, rgbToHex, getLuminance, getContrastTextColor, createSvgDocument, rect, circle, line, text, arcPath, group, THEME, FONTS, } from './base.js';
+export { generateHarmonyWheel } from './harmony-wheel.js';
+export type { HarmonyDye, HarmonyWheelOptions } from './harmony-wheel.js';
+export { generateGradientBar, interpolateColor, generateGradientColors, } from './gradient.js';
+export type { GradientStep, GradientBarOptions } from './gradient.js';
+export { generatePaletteGrid, getMatchQuality, MATCH_QUALITIES, } from './palette-grid.js';
+export type { PaletteEntry, PaletteGridOptions, PaletteGridLabels, MatchQuality, } from './palette-grid.js';
+export { generateAccessibilityComparison, generateCompactAccessibilityRow, } from './accessibility-comparison.js';
+export type { AccessibilityComparisonOptions, VisionType, AllVisionTypes, } from './accessibility-comparison.js';
+export { generateContrastMatrix, calculateContrast } from './contrast-matrix.js';
+export type { ContrastDye, ContrastMatrixOptions, ContrastResult, WCAGLevel, } from './contrast-matrix.js';
+export { generateRandomDyesGrid } from './random-dyes-grid.js';
+export type { RandomDyeInfo, RandomDyesGridOptions } from './random-dyes-grid.js';
+export { generateComparisonGrid } from './comparison-grid.js';
+export type { ComparisonGridOptions } from './comparison-grid.js';
+export { generateDyeInfoCard } from './dye-info-card.js';
+export type { DyeInfoCardOptions } from './dye-info-card.js';
+export { generatePresetSwatch, generateCompactPresetSwatch, CATEGORY_DISPLAY, } from './preset-swatch.js';
+export type { PresetSwatchOptions } from './preset-swatch.js';
+export { generateBudgetComparison, generateNoWorldSetSvg, generateErrorSvg, formatGil, } from './budget-comparison.js';
+export type { DyePriceData, BudgetSuggestion, BudgetSortOption, BudgetSvgLabels, BudgetComparisonOptions, } from './budget-comparison.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,EACL,SAAS,EACT,QAAQ,EACR,QAAQ,EACR,YAAY,EACZ,oBAAoB,EACpB,iBAAiB,EACjB,IAAI,EACJ,MAAM,EACN,IAAI,EACJ,IAAI,EACJ,OAAO,EACP,KAAK,EACL,KAAK,EACL,KAAK,GACN,MAAM,WAAW,CAAC;AAGnB,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC1D,YAAY,EAAE,UAAU,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAG1E,OAAO,EACL,mBAAmB,EACnB,gBAAgB,EAChB,sBAAsB,GACvB,MAAM,eAAe,CAAC;AACvB,YAAY,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAGtE,OAAO,EACL,mBAAmB,EACnB,eAAe,EACf,eAAe,GAChB,MAAM,mBAAmB,CAAC;AAC3B,YAAY,EACV,YAAY,EACZ,kBAAkB,EAClB,iBAAiB,EACjB,YAAY,GACb,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EACL,+BAA+B,EAC/B,+BAA+B,GAChC,MAAM,+BAA+B,CAAC;AACvC,YAAY,EACV,8BAA8B,EAC9B,UAAU,EACV,cAAc,GACf,MAAM,+BAA+B,CAAC;AAGvC,OAAO,EAAE,sBAAsB,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AACjF,YAAY,EACV,WAAW,EACX,qBAAqB,EACrB,cAAc,EACd,SAAS,GACV,MAAM,sBAAsB,CAAC;AAG9B,OAAO,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAC/D,YAAY,EAAE,aAAa,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAGlF,OAAO,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AAC9D,YAAY,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAGlE,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AACzD,YAAY,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAG7D,OAAO,EACL,oBAAoB,EACpB,2BAA2B,EAC3B,gBAAgB,GACjB,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAG9D,OAAO,EACL,wBAAwB,EACxB,qBAAqB,EACrB,gBAAgB,EAChB,SAAS,GACV,MAAM,wBAAwB,CAAC;AAChC,YAAY,EACV,YAAY,EACZ,gBAAgB,EAChB,gBAAgB,EAChB,eAAe,EACf,uBAAuB,GACxB,MAAM,wBAAwB,CAAC"}

package/dist/index.js

@@ -0,0 +1,32 @@
+/**
+ * @xivdyetools/svg
+ *
+ * SVG card generators for XIV Dye Tools.
+ * All functions are pure: data in → SVG string out.
+ * Rendering to PNG (via resvg-wasm, etc.) is handled by each consuming app.
+ *
+ * @module svg
+ */
+// Base utilities & primitives
+export { escapeXml, hexToRgb, rgbToHex, getLuminance, getContrastTextColor, createSvgDocument, rect, circle, line, text, arcPath, group, THEME, FONTS, } from './base.js';
+// Harmony Wheel
+export { generateHarmonyWheel } from './harmony-wheel.js';
+// Gradient Bar
+export { generateGradientBar, interpolateColor, generateGradientColors, } from './gradient.js';
+// Palette Grid (color extraction match results)
+export { generatePaletteGrid, getMatchQuality, MATCH_QUALITIES, } from './palette-grid.js';
+// Accessibility / Colorblind Comparison
+export { generateAccessibilityComparison, generateCompactAccessibilityRow, } from './accessibility-comparison.js';
+// WCAG Contrast Matrix
+export { generateContrastMatrix, calculateContrast } from './contrast-matrix.js';
+// Random Dyes Grid
+export { generateRandomDyesGrid } from './random-dyes-grid.js';
+// Dye Comparison Grid
+export { generateComparisonGrid } from './comparison-grid.js';
+// Dye Info Card
+export { generateDyeInfoCard } from './dye-info-card.js';
+// Preset Swatch
+export { generatePresetSwatch, generateCompactPresetSwatch, CATEGORY_DISPLAY, } from './preset-swatch.js';
+// Budget Comparison
+export { generateBudgetComparison, generateNoWorldSetSvg, generateErrorSvg, formatGil, } from './budget-comparison.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,8BAA8B;AAC9B,OAAO,EACL,SAAS,EACT,QAAQ,EACR,QAAQ,EACR,YAAY,EACZ,oBAAoB,EACpB,iBAAiB,EACjB,IAAI,EACJ,MAAM,EACN,IAAI,EACJ,IAAI,EACJ,OAAO,EACP,KAAK,EACL,KAAK,EACL,KAAK,GACN,MAAM,WAAW,CAAC;AAEnB,gBAAgB;AAChB,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAG1D,eAAe;AACf,OAAO,EACL,mBAAmB,EACnB,gBAAgB,EAChB,sBAAsB,GACvB,MAAM,eAAe,CAAC;AAGvB,gDAAgD;AAChD,OAAO,EACL,mBAAmB,EACnB,eAAe,EACf,eAAe,GAChB,MAAM,mBAAmB,CAAC;AAQ3B,wCAAwC;AACxC,OAAO,EACL,+BAA+B,EAC/B,+BAA+B,GAChC,MAAM,+BAA+B,CAAC;AAOvC,uBAAuB;AACvB,OAAO,EAAE,sBAAsB,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAQjF,mBAAmB;AACnB,OAAO,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAG/D,sBAAsB;AACtB,OAAO,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AAG9D,gBAAgB;AAChB,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAGzD,gBAAgB;AAChB,OAAO,EACL,oBAAoB,EACpB,2BAA2B,EAC3B,gBAAgB,GACjB,MAAM,oBAAoB,CAAC;AAG5B,oBAAoB;AACpB,OAAO,EACL,wBAAwB,EACxB,qBAAqB,EACrB,gBAAgB,EAChB,SAAS,GACV,MAAM,wBAAwB,CAAC"}

package/dist/palette-grid.d.ts

@@ -0,0 +1,105 @@
+/**
+ * Palette Grid SVG Generator
+ *
+ * Generates a visual comparison of extracted colors to matched FFXIV dyes.
+ * Used by the /extractor image command to display color extraction results.
+ *
+ * Layout:
+ * +----------------------------------------------------------+
+ * | [Extracted Color] 42%  -->  [Matched Dye] Dalamud Red    |
+ * | #B01515                     #AA1111 Δ8.5     [EXCELLENT] |
+ * +----------------------------------------------------------+
+ *
+ * @module svg/palette-grid
+ */
+import type { RGB, Dye } from '@xivdyetools/core';
+export interface MatchQuality {
+    /** Locale key for translation lookup (e.g., 'perfect', 'excellent') */
+    key: string;
+    /** Human-readable label */
+    label: string;
+    /** Short label for display */
+    shortLabel: string;
+    /** Distance threshold for this quality level */
+    maxDistance: number;
+}
+/**
+ * Match quality thresholds
+ *
+ * Based on Euclidean distance in RGB space:
+ * - Max possible distance: ~441 (black to white)
+ * - Noticeable difference: ~10-15
+ * - Perceptually similar: ~25-30
+ */
+export declare const MATCH_QUALITIES: MatchQuality[];
+/**
+ * Get the quality rating for a color distance
+ */
+export declare function getMatchQuality(distance: number): MatchQuality;
+/**
+ * A single palette entry with extracted and matched colors
+ */
+export interface PaletteEntry {
+    /** The extracted RGB color from the image */
+    extracted: RGB;
+    /** The closest matching FFXIV dye */
+    matchedDye: Dye;
+    /** Color distance (Euclidean in RGB space) */
+    distance: number;
+    /** Percentage of pixels with this color (0-100) */
+    dominance: number;
+}
+/**
+ * Translatable labels for the palette grid SVG.
+ * Pass these from the bot's i18n system to localize the image.
+ */
+export interface PaletteGridLabels {
+    /** Label above extracted color (e.g., "EXTRACTED") */
+    extracted: string;
+    /** Label above matched dye (e.g., "MATCHED DYE") */
+    matchedDye: string;
+    /** Suffix for dominance percentage (e.g., "of image") */
+    ofImage: string;
+    /** Empty state message (e.g., "No colors extracted from image") */
+    noColors: string;
+    /** Quality badge labels keyed by quality key */
+    quality: Record<string, string>;
+}
+/**
+ * Options for generating the palette grid
+ */
+export interface PaletteGridOptions {
+    /** Array of palette entries to display */
+    entries: PaletteEntry[];
+    /** Canvas width in pixels (default: 800) */
+    width?: number;
+    /** Show color distance values (default: true) */
+    showDistance?: boolean;
+    /** Title text (optional) */
+    title?: string;
+    /** Translated labels for i18n (defaults to English if omitted) */
+    labels?: PaletteGridLabels;
+}
+/**
+ * Generate a palette grid SVG showing extracted colors matched to dyes
+ *
+ * @param options - Palette grid configuration
+ * @returns SVG string
+ *
+ * @example
+ * ```typescript
+ * const svg = generatePaletteGrid({
+ *   entries: [
+ *     {
+ *       extracted: { r: 176, g: 21, b: 21 },
+ *       matchedDye: { name: 'Dalamud Red', hex: '#AA1111', ... },
+ *       distance: 8.5,
+ *       dominance: 42,
+ *     },
+ *   ],
+ * });
+ * const png = await renderSvgToPng(svg);
+ * ```
+ */
+export declare function generatePaletteGrid(options: PaletteGridOptions): string;
+//# sourceMappingURL=palette-grid.d.ts.map

package/dist/palette-grid.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"palette-grid.d.ts","sourceRoot":"","sources":["../src/palette-grid.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE,MAAM,mBAAmB,CAAC;AAgBlD,MAAM,WAAW,YAAY;IAC3B,uEAAuE;IACvE,GAAG,EAAE,MAAM,CAAC;IACZ,2BAA2B;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,8BAA8B;IAC9B,UAAU,EAAE,MAAM,CAAC;IACnB,gDAAgD;IAChD,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,eAAe,EAAE,YAAY,EAMzC,CAAC;AAEF;;GAEG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,YAAY,CAO9D;AAMD;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,6CAA6C;IAC7C,SAAS,EAAE,GAAG,CAAC;IACf,qCAAqC;IACrC,UAAU,EAAE,GAAG,CAAC;IAChB,8CAA8C;IAC9C,QAAQ,EAAE,MAAM,CAAC;IACjB,mDAAmD;IACnD,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAChC,sDAAsD;IACtD,SAAS,EAAE,MAAM,CAAC;IAClB,oDAAoD;IACpD,UAAU,EAAE,MAAM,CAAC;IACnB,yDAAyD;IACzD,OAAO,EAAE,MAAM,CAAC;IAChB,mEAAmE;IACnE,QAAQ,EAAE,MAAM,CAAC;IACjB,gDAAgD;IAChD,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACjC;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,0CAA0C;IAC1C,OAAO,EAAE,YAAY,EAAE,CAAC;IACxB,4CAA4C;IAC5C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,iDAAiD;IACjD,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,4BAA4B;IAC5B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,kEAAkE;IAClE,MAAM,CAAC,EAAE,iBAAiB,CAAC;CAC5B;AAkCD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,kBAAkB,GAAG,MAAM,CA2DvE"}