@xivdyetools/svg 1.0.0

package/dist/base.js

@@ -0,0 +1,201 @@
+/**
+ * SVG Base Utilities
+ *
+ * Core utilities for generating SVG graphics as strings.
+ * These SVGs are later converted to PNG using a platform-specific renderer
+ * (e.g., resvg-wasm for Cloudflare Workers, @resvg/resvg-js for Node.js).
+ */
+/**
+ * XML-escapes a string for safe SVG inclusion
+ */
+export function escapeXml(str) {
+    return str
+        .replace(/&/g, '&')
+        .replace(/</g, '&lt;')
+        .replace(/>/g, '&gt;')
+        .replace(/"/g, '&quot;')
+        .replace(/'/g, '&apos;');
+}
+/**
+ * Converts a hex color to RGB components
+ */
+export function hexToRgb(hex) {
+    const cleanHex = hex.replace('#', '');
+    return {
+        r: parseInt(cleanHex.slice(0, 2), 16),
+        g: parseInt(cleanHex.slice(2, 4), 16),
+        b: parseInt(cleanHex.slice(4, 6), 16),
+    };
+}
+/**
+ * Converts RGB to hex color string
+ */
+export function rgbToHex(r, g, b) {
+    return `#${r.toString(16).padStart(2, '0')}${g.toString(16).padStart(2, '0')}${b.toString(16).padStart(2, '0')}`;
+}
+/**
+ * Calculates the luminance of a color (for contrast calculations)
+ */
+export function getLuminance(hex) {
+    const { r, g, b } = hexToRgb(hex);
+    // Relative luminance formula
+    const [rs, gs, bs] = [r, g, b].map((c) => {
+        const s = c / 255;
+        return s <= 0.03928 ? s / 12.92 : Math.pow((s + 0.055) / 1.055, 2.4);
+    });
+    return 0.2126 * rs + 0.7152 * gs + 0.0722 * bs;
+}
+/**
+ * Determines if text should be light or dark based on background color
+ */
+export function getContrastTextColor(bgHex) {
+    const luminance = getLuminance(bgHex);
+    return luminance > 0.179 ? '#000000' : '#ffffff';
+}
+/**
+ * Creates an SVG document wrapper
+ */
+export function createSvgDocument(width, height, content) {
+    return `<svg xmlns="http://www.w3.org/2000/svg" width="${width}" height="${height}" viewBox="0 0 ${width} ${height}">
+${content}
+</svg>`;
+}
+/**
+ * Creates a rectangle element
+ */
+export function rect(x, y, width, height, fill, options = {}) {
+    const attrs = [
+        `x="${x}"`,
+        `y="${y}"`,
+        `width="${width}"`,
+        `height="${height}"`,
+        `fill="${fill}"`,
+    ];
+    if (options.rx)
+        attrs.push(`rx="${options.rx}"`);
+    if (options.ry)
+        attrs.push(`ry="${options.ry}"`);
+    if (options.stroke)
+        attrs.push(`stroke="${options.stroke}"`);
+    if (options.strokeWidth)
+        attrs.push(`stroke-width="${options.strokeWidth}"`);
+    if (options.opacity !== undefined)
+        attrs.push(`opacity="${options.opacity}"`);
+    return `<rect ${attrs.join(' ')}/>`;
+}
+/**
+ * Creates a circle element
+ */
+export function circle(cx, cy, r, fill, options = {}) {
+    const attrs = [
+        `cx="${cx}"`,
+        `cy="${cy}"`,
+        `r="${r}"`,
+        `fill="${fill}"`,
+    ];
+    if (options.stroke)
+        attrs.push(`stroke="${options.stroke}"`);
+    if (options.strokeWidth)
+        attrs.push(`stroke-width="${options.strokeWidth}"`);
+    if (options.opacity !== undefined)
+        attrs.push(`opacity="${options.opacity}"`);
+    return `<circle ${attrs.join(' ')}/>`;
+}
+/**
+ * Creates a line element
+ */
+export function line(x1, y1, x2, y2, stroke, strokeWidth = 1, options = {}) {
+    const attrs = [
+        `x1="${x1}"`,
+        `y1="${y1}"`,
+        `x2="${x2}"`,
+        `y2="${y2}"`,
+        `stroke="${stroke}"`,
+        `stroke-width="${strokeWidth}"`,
+    ];
+    if (options.opacity !== undefined)
+        attrs.push(`opacity="${options.opacity}"`);
+    if (options.dashArray)
+        attrs.push(`stroke-dasharray="${options.dashArray}"`);
+    return `<line ${attrs.join(' ')}/>`;
+}
+/**
+ * Creates a text element
+ */
+export function text(x, y, content, options = {}) {
+    const attrs = [
+        `x="${x}"`,
+        `y="${y}"`,
+    ];
+    if (options.fill)
+        attrs.push(`fill="${options.fill}"`);
+    if (options.fontSize)
+        attrs.push(`font-size="${options.fontSize}"`);
+    if (options.fontFamily)
+        attrs.push(`font-family="${options.fontFamily}"`);
+    if (options.fontWeight)
+        attrs.push(`font-weight="${options.fontWeight}"`);
+    if (options.textAnchor)
+        attrs.push(`text-anchor="${options.textAnchor}"`);
+    if (options.dominantBaseline)
+        attrs.push(`dominant-baseline="${options.dominantBaseline}"`);
+    return `<text ${attrs.join(' ')}>${escapeXml(content)}</text>`;
+}
+/**
+ * Creates an arc path for pie/donut charts
+ */
+export function arcPath(cx, cy, radius, startAngle, endAngle) {
+    const startRad = (startAngle - 90) * (Math.PI / 180);
+    const endRad = (endAngle - 90) * (Math.PI / 180);
+    const x1 = cx + radius * Math.cos(startRad);
+    const y1 = cy + radius * Math.sin(startRad);
+    const x2 = cx + radius * Math.cos(endRad);
+    const y2 = cy + radius * Math.sin(endRad);
+    const largeArc = endAngle - startAngle > 180 ? 1 : 0;
+    return `M ${cx} ${cy} L ${x1} ${y1} A ${radius} ${radius} 0 ${largeArc} 1 ${x2} ${y2} Z`;
+}
+/**
+ * Creates a group element
+ */
+export function group(content, transform) {
+    if (transform) {
+        return `<g transform="${transform}">${content}</g>`;
+    }
+    return `<g>${content}</g>`;
+}
+/**
+ * Theme colors for consistent styling
+ */
+export const THEME = {
+    background: '#1a1a2e',
+    backgroundLight: '#2d2d3d',
+    text: '#ffffff',
+    textMuted: '#909090',
+    textDim: '#666666',
+    accent: '#5865f2', // Discord Blurple
+    border: '#404050',
+    success: '#57f287',
+    warning: '#fee75c',
+    error: '#ed4245',
+};
+/**
+ * Font families for consistent typography.
+ * These names match the bundled font files loaded by the renderer.
+ *
+ * - header: Space Grotesk (variable 300-700) - titles, headers
+ * - primary: Onest (variable 100-900) - body text, labels
+ * - mono: Habibi (regular only) - hex codes, monospace-like text
+ * - cjk: Noto Sans SC + Noto Sans KR - Japanese, Korean, Chinese text
+ * - primaryCjk: Onest with CJK/KR fallback - for localized text that may contain CJK
+ */
+export const FONTS = {
+    header: 'Space Grotesk',
+    primary: 'Onest',
+    mono: 'Habibi',
+    cjk: 'Noto Sans SC, Noto Sans KR',
+    /** Use this for headings that may contain CJK characters (e.g., dye names) */
+    headerCjk: 'Space Grotesk, Noto Sans SC, Noto Sans KR',
+    /** Use this for body text that may contain CJK characters (e.g., dye names) */
+    primaryCjk: 'Onest, Noto Sans SC, Noto Sans KR',
+};
+//# sourceMappingURL=base.js.map

package/dist/base.js.map

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

package/dist/budget-comparison.d.ts

@@ -0,0 +1,121 @@
+/**
+ * Budget Comparison SVG Generator
+ *
+ * Generates a visual comparison of target dye vs budget alternatives.
+ * Used by the /budget command to display results.
+ *
+ * Layout:
+ * +----------------------------------------------------------+
+ * |  BUDGET ALTERNATIVES FOR                                  |
+ * |  [Target Swatch] Pure White    Target Price: 85,000 Gil   |
+ * +----------------------------------------------------------+
+ * |  [Alt Swatch] Snow White       Price: 5,000    Save: 94%  |
+ * |               #E4DFD0          Distance: 12 (Excellent)   |
+ * +----------------------------------------------------------+
+ * |  [Alt Swatch] Ash Grey         Price: 2,500    Save: 97%  |
+ * |               #8B8B8B          Distance: 28 (Good)        |
+ * +----------------------------------------------------------+
+ *
+ * @module svg/budget-comparison
+ */
+import type { Dye } from '@xivdyetools/core';
+/**
+ * Price data for a dye on the market board.
+ * This interface is structurally compatible with the discord-worker's
+ * richer DyePriceData type — only the fields needed for SVG rendering
+ * are declared here.
+ */
+export interface DyePriceData {
+    currentMinPrice: number;
+    world: string;
+    listingCount: number;
+}
+/**
+ * A budget alternative suggestion.
+ */
+export interface BudgetSuggestion {
+    dye: Dye;
+    price: DyePriceData | null;
+    colorDistance: number;
+    savings: number;
+    savingsPercent: number;
+    valueScore: number;
+}
+/**
+ * Sort option for budget results.
+ */
+export type BudgetSortOption = 'price' | 'color_match' | 'value_score';
+/**
+ * Format a Gil amount with locale-appropriate separators.
+ */
+export declare function formatGil(amount: number): string;
+/**
+ * Translated labels for the budget comparison SVG
+ *
+ * Pre-resolved strings are ready to render as-is.
+ * Template strings use {var} placeholders for per-row interpolation.
+ */
+export interface BudgetSvgLabels {
+    /** Header title (e.g., "BUDGET ALTERNATIVES FOR") */
+    headerLabel: string;
+    /** Label above target price (e.g., "Target Price") */
+    targetPriceLabel: string;
+    /** No listings available (e.g., "No listings") */
+    noListings: string;
+    /** No alternatives found (e.g., "No cheaper alternatives found") */
+    noAlternatives: string;
+    /** Pre-resolved sort indicator (e.g., "Sorted by: Best Value") */
+    sortedBy: string;
+    /** Pre-resolved world subtitle (e.g., "on Aether") */
+    onWorld: string;
+    /** Template: "{amount} Gil" */
+    gilAmountTemplate: string;
+    /** Template: "Save {amount} ({percent}%)" */
+    saveAmountTemplate: string;
+    /** Template: "{count} listings" */
+    listingCountTemplate: string;
+    /** Translated distance quality labels */
+    distanceQuality: {
+        perfect: string;
+        excellent: string;
+        good: string;
+        fair: string;
+        approximate: string;
+    };
+    /** Localized dye names keyed by itemID (falls back to Dye.name if missing) */
+    dyeNames: Record<number, string>;
+    /** Localized category names keyed by English category (falls back to raw category if missing) */
+    categoryNames: Record<string, string>;
+}
+/**
+ * Options for generating the budget comparison SVG
+ */
+export interface BudgetComparisonOptions {
+    /** The target dye (expensive one) */
+    targetDye: Dye;
+    /** Target dye's price (null if no listings) */
+    targetPrice: DyePriceData | null;
+    /** Alternative dye suggestions */
+    alternatives: BudgetSuggestion[];
+    /** World/datacenter used for prices */
+    world: string;
+    /** How results are sorted */
+    sortBy: BudgetSortOption;
+    /** Translated labels for all text in the SVG */
+    labels: BudgetSvgLabels;
+    /** Canvas width in pixels (default: 800) */
+    width?: number;
+}
+/**
+ * Generate a budget comparison SVG showing target vs alternatives
+ */
+export declare function generateBudgetComparison(options: BudgetComparisonOptions): string;
+/**
+ * Generate an empty state SVG when no world is set
+ */
+export declare function generateNoWorldSetSvg(width?: number): string;
+/**
+ * Generate an error state SVG
+ */
+export declare function generateErrorSvg(message: string, width?: number): string;
+//# sourceMappingURL=budget-comparison.d.ts.map

package/dist/budget-comparison.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"budget-comparison.d.ts","sourceRoot":"","sources":["../src/budget-comparison.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,mBAAmB,CAAC;AAgB7C;;;;;GAKG;AACH,MAAM,WAAW,YAAY;IAC3B,eAAe,EAAE,MAAM,CAAC;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,GAAG,EAAE,GAAG,CAAC;IACT,KAAK,EAAE,YAAY,GAAG,IAAI,CAAC;IAC3B,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,EAAE,MAAM,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG,OAAO,GAAG,aAAa,GAAG,aAAa,CAAC;AAEvE;;GAEG;AACH,wBAAgB,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAEhD;AAMD;;;;;GAKG;AACH,MAAM,WAAW,eAAe;IAC9B,qDAAqD;IACrD,WAAW,EAAE,MAAM,CAAC;IACpB,sDAAsD;IACtD,gBAAgB,EAAE,MAAM,CAAC;IACzB,kDAAkD;IAClD,UAAU,EAAE,MAAM,CAAC;IACnB,oEAAoE;IACpE,cAAc,EAAE,MAAM,CAAC;IACvB,kEAAkE;IAClE,QAAQ,EAAE,MAAM,CAAC;IACjB,sDAAsD;IACtD,OAAO,EAAE,MAAM,CAAC;IAChB,+BAA+B;IAC/B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,6CAA6C;IAC7C,kBAAkB,EAAE,MAAM,CAAC;IAC3B,mCAAmC;IACnC,oBAAoB,EAAE,MAAM,CAAC;IAC7B,yCAAyC;IACzC,eAAe,EAAE;QACf,OAAO,EAAE,MAAM,CAAC;QAChB,SAAS,EAAE,MAAM,CAAC;QAClB,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,EAAE,MAAM,CAAC;KACrB,CAAC;IACF,8EAA8E;IAC9E,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,iGAAiG;IACjG,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACvC;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,qCAAqC;IACrC,SAAS,EAAE,GAAG,CAAC;IACf,+CAA+C;IAC/C,WAAW,EAAE,YAAY,GAAG,IAAI,CAAC;IACjC,kCAAkC;IAClC,YAAY,EAAE,gBAAgB,EAAE,CAAC;IACjC,uCAAuC;IACvC,KAAK,EAAE,MAAM,CAAC;IACd,6BAA6B;IAC7B,MAAM,EAAE,gBAAgB,CAAC;IACzB,gDAAgD;IAChD,MAAM,EAAE,eAAe,CAAC;IACxB,4CAA4C;IAC5C,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAyCD;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,uBAAuB,GAAG,MAAM,CA4DjF;AA0PD;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,GAAE,MAAsB,GAAG,MAAM,CAmC3E;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,GAAE,MAAsB,GAAG,MAAM,CA0BvF"}

package/dist/budget-comparison.js

@@ -0,0 +1,331 @@
+/**
+ * Budget Comparison SVG Generator
+ *
+ * Generates a visual comparison of target dye vs budget alternatives.
+ * Used by the /budget command to display results.
+ *
+ * Layout:
+ * +----------------------------------------------------------+
+ * |  BUDGET ALTERNATIVES FOR                                  |
+ * |  [Target Swatch] Pure White    Target Price: 85,000 Gil   |
+ * +----------------------------------------------------------+
+ * |  [Alt Swatch] Snow White       Price: 5,000    Save: 94%  |
+ * |               #E4DFD0          Distance: 12 (Excellent)   |
+ * +----------------------------------------------------------+
+ * |  [Alt Swatch] Ash Grey         Price: 2,500    Save: 97%  |
+ * |               #8B8B8B          Distance: 28 (Good)        |
+ * +----------------------------------------------------------+
+ *
+ * @module svg/budget-comparison
+ */
+import { createSvgDocument, rect, text, line, THEME, FONTS, escapeXml, getContrastTextColor, } from './base.js';
+/**
+ * Format a Gil amount with locale-appropriate separators.
+ */
+export function formatGil(amount) {
+    return amount.toLocaleString('en-US');
+}
+// ============================================================================
+// Constants
+// ============================================================================
+const DEFAULT_WIDTH = 800;
+const PADDING = 24;
+const HEADER_HEIGHT = 120;
+const ROW_HEIGHT = 90;
+const SWATCH_SIZE = 56;
+const TARGET_SWATCH_SIZE = 72;
+// ============================================================================
+// Helpers
+// ============================================================================
+/**
+ * Fill a template string with variable values
+ *
+ * @example fillTemplate("{amount} Gil", { amount: "5,000" }) → "5,000 Gil"
+ */
+function fillTemplate(template, vars) {
+    return template.replace(/\{(\w+)\}/g, (_, key) => String(vars[key] ?? ''));
+}
+/**
+ * Map a color distance value to a quality tier key
+ */
+function getDistanceQualityKey(distance) {
+    if (distance === 0)
+        return 'perfect';
+    if (distance < 10)
+        return 'excellent';
+    if (distance < 25)
+        return 'good';
+    if (distance < 50)
+        return 'fair';
+    return 'approximate';
+}
+// ============================================================================
+// SVG Generation
+// ============================================================================
+/**
+ * Generate a budget comparison SVG showing target vs alternatives
+ */
+export function generateBudgetComparison(options) {
+    const { targetDye, targetPrice, alternatives, labels, width = DEFAULT_WIDTH, } = options;
+    // Calculate dimensions
+    const hasAlternatives = alternatives.length > 0;
+    const contentHeight = hasAlternatives ? alternatives.length * ROW_HEIGHT : 60;
+    const height = PADDING * 2 + HEADER_HEIGHT + contentHeight;
+    const elements = [];
+    // Background
+    elements.push(rect(0, 0, width, height, THEME.background, { rx: 12, ry: 12 }));
+    // Header section
+    elements.push(generateHeader(targetDye, targetPrice, labels, width));
+    // Separator after header
+    elements.push(line(PADDING, HEADER_HEIGHT, width - PADDING, HEADER_HEIGHT, THEME.border, 2));
+    // Alternatives section
+    if (hasAlternatives) {
+        alternatives.forEach((alt, index) => {
+            const rowY = HEADER_HEIGHT + index * ROW_HEIGHT;
+            elements.push(generateAlternativeRow(alt, PADDING, rowY, width - PADDING * 2, targetPrice, labels));
+            // Separator line (except after last row)
+            if (index < alternatives.length - 1) {
+                elements.push(line(PADDING + 20, rowY + ROW_HEIGHT, width - PADDING - 20, rowY + ROW_HEIGHT, THEME.border, 1));
+            }
+        });
+    }
+    else {
+        // No alternatives found message
+        elements.push(text(width / 2, HEADER_HEIGHT + 30, labels.noAlternatives, {
+            fill: THEME.textMuted,
+            fontSize: 16,
+            fontFamily: FONTS.primaryCjk,
+            textAnchor: 'middle',
+        }));
+    }
+    return createSvgDocument(width, height, elements.join('\n'));
+}
+/**
+ * Generate the header section with target dye info
+ */
+function generateHeader(targetDye, targetPrice, labels, width) {
+    const elements = [];
+    // Title
+    elements.push(text(PADDING, 35, labels.headerLabel, {
+        fill: THEME.textMuted,
+        fontSize: 12,
+        fontFamily: FONTS.primaryCjk,
+        fontWeight: 500,
+    }));
+    // Target dye swatch
+    const swatchY = 50;
+    elements.push(rect(PADDING, swatchY, TARGET_SWATCH_SIZE, TARGET_SWATCH_SIZE, targetDye.hex, {
+        rx: 8,
+        ry: 8,
+        stroke: THEME.accent,
+        strokeWidth: 3,
+    }));
+    // Hex value on swatch
+    const swatchTextColor = getContrastTextColor(targetDye.hex);
+    elements.push(text(PADDING + TARGET_SWATCH_SIZE / 2, swatchY + TARGET_SWATCH_SIZE - 8, targetDye.hex.toUpperCase(), {
+        fill: swatchTextColor,
+        fontSize: 10,
+        fontFamily: FONTS.mono,
+        textAnchor: 'middle',
+    }));
+    // Target dye name (localized)
+    const infoX = PADDING + TARGET_SWATCH_SIZE + 16;
+    const targetName = labels.dyeNames[targetDye.itemID] ?? targetDye.name;
+    elements.push(text(infoX, 70, escapeXml(targetName), {
+        fill: THEME.text,
+        fontSize: 24,
+        fontFamily: FONTS.headerCjk,
+        fontWeight: 600,
+    }));
+    // Category (localized)
+    const targetCategory = labels.categoryNames[targetDye.category] ?? targetDye.category;
+    elements.push(text(infoX, 92, escapeXml(targetCategory), {
+        fill: THEME.textMuted,
+        fontSize: 14,
+        fontFamily: FONTS.primaryCjk,
+    }));
+    // Price section (right side)
+    const priceX = width - PADDING;
+    if (targetPrice) {
+        elements.push(text(priceX, 55, labels.targetPriceLabel, {
+            fill: THEME.textMuted,
+            fontSize: 10,
+            fontFamily: FONTS.primaryCjk,
+            fontWeight: 500,
+            textAnchor: 'end',
+        }));
+        elements.push(text(priceX, 80, fillTemplate(labels.gilAmountTemplate, { amount: formatGil(targetPrice.currentMinPrice) }), {
+            fill: THEME.warning,
+            fontSize: 22,
+            fontFamily: FONTS.header,
+            fontWeight: 600,
+            textAnchor: 'end',
+        }));
+        elements.push(text(priceX, 100, labels.onWorld, {
+            fill: THEME.textDim,
+            fontSize: 12,
+            fontFamily: FONTS.primaryCjk,
+            textAnchor: 'end',
+        }));
+    }
+    else {
+        elements.push(text(priceX, 70, labels.noListings, {
+            fill: THEME.textMuted,
+            fontSize: 16,
+            fontFamily: FONTS.primaryCjk,
+            textAnchor: 'end',
+        }));
+        elements.push(text(priceX, 92, labels.onWorld, {
+            fill: THEME.textDim,
+            fontSize: 12,
+            fontFamily: FONTS.primaryCjk,
+            textAnchor: 'end',
+        }));
+    }
+    // Sort indicator
+    elements.push(text(width / 2, HEADER_HEIGHT - 8, labels.sortedBy, {
+        fill: THEME.textDim,
+        fontSize: 11,
+        fontFamily: FONTS.primaryCjk,
+        textAnchor: 'middle',
+    }));
+    return elements.join('\n');
+}
+/**
+ * Generate a row for an alternative dye
+ */
+function generateAlternativeRow(alt, x, y, width, targetPrice, labels) {
+    const elements = [];
+    const rowPadding = 12;
+    // Row background
+    elements.push(rect(x, y + 6, width, ROW_HEIGHT - 12, THEME.backgroundLight, {
+        rx: 8,
+        ry: 8,
+        opacity: 0.5,
+    }));
+    // Dye swatch
+    const swatchX = x + rowPadding;
+    const swatchY = y + (ROW_HEIGHT - SWATCH_SIZE) / 2;
+    elements.push(rect(swatchX, swatchY, SWATCH_SIZE, SWATCH_SIZE, alt.dye.hex, {
+        rx: 6,
+        ry: 6,
+        stroke: THEME.border,
+        strokeWidth: 2,
+    }));
+    // Dye name (localized) and hex
+    const infoX = swatchX + SWATCH_SIZE + 14;
+    const altName = labels.dyeNames[alt.dye.itemID] ?? alt.dye.name;
+    elements.push(text(infoX, y + 35, escapeXml(altName), {
+        fill: THEME.text,
+        fontSize: 16,
+        fontFamily: FONTS.primaryCjk,
+        fontWeight: 600,
+    }));
+    elements.push(text(infoX, y + 55, alt.dye.hex.toUpperCase(), {
+        fill: THEME.textDim,
+        fontSize: 12,
+        fontFamily: FONTS.mono,
+    }));
+    // Color distance badge (no emoji/Δ — fonts lack those glyphs in resvg)
+    const qualityKey = getDistanceQualityKey(alt.colorDistance);
+    const qualityLabel = labels.distanceQuality[qualityKey];
+    const distanceText = `${qualityLabel} (dE ${alt.colorDistance.toFixed(1)})`;
+    elements.push(text(infoX, y + 75, distanceText, {
+        fill: THEME.textMuted,
+        fontSize: 11,
+        fontFamily: FONTS.primaryCjk,
+    }));
+    // Price section (right side)
+    const priceX = x + width - rowPadding;
+    if (alt.price) {
+        // Price
+        elements.push(text(priceX, y + 35, fillTemplate(labels.gilAmountTemplate, { amount: formatGil(alt.price.currentMinPrice) }), {
+            fill: THEME.success,
+            fontSize: 18,
+            fontFamily: FONTS.header,
+            fontWeight: 600,
+            textAnchor: 'end',
+        }));
+        // Savings
+        if (targetPrice && alt.savings > 0) {
+            const savingsText = fillTemplate(labels.saveAmountTemplate, {
+                amount: formatGil(alt.savings),
+                percent: alt.savingsPercent.toFixed(0),
+            });
+            elements.push(text(priceX, y + 55, savingsText, {
+                fill: THEME.accent,
+                fontSize: 13,
+                fontFamily: FONTS.primaryCjk,
+                fontWeight: 500,
+                textAnchor: 'end',
+            }));
+        }
+        // Listings count
+        elements.push(text(priceX, y + 75, fillTemplate(labels.listingCountTemplate, { count: alt.price.listingCount }), {
+            fill: THEME.textDim,
+            fontSize: 11,
+            fontFamily: FONTS.primaryCjk,
+            textAnchor: 'end',
+        }));
+    }
+    else {
+        elements.push(text(priceX, y + 50, labels.noListings, {
+            fill: THEME.textMuted,
+            fontSize: 14,
+            fontFamily: FONTS.primaryCjk,
+            textAnchor: 'end',
+        }));
+    }
+    return elements.join('\n');
+}
+/**
+ * Generate an empty state SVG when no world is set
+ */
+export function generateNoWorldSetSvg(width = DEFAULT_WIDTH) {
+    const height = 160;
+    const elements = [];
+    elements.push(rect(0, 0, width, height, THEME.background, { rx: 12, ry: 12 }));
+    elements.push(text(width / 2, 60, 'No World Set', {
+        fill: THEME.warning,
+        fontSize: 24,
+        fontFamily: FONTS.header,
+        fontWeight: 600,
+        textAnchor: 'middle',
+    }));
+    elements.push(text(width / 2, 95, 'Use /budget set_world to set your preferred', {
+        fill: THEME.textMuted,
+        fontSize: 14,
+        fontFamily: FONTS.primary,
+        textAnchor: 'middle',
+    }));
+    elements.push(text(width / 2, 115, 'world or datacenter for price lookups.', {
+        fill: THEME.textMuted,
+        fontSize: 14,
+        fontFamily: FONTS.primary,
+        textAnchor: 'middle',
+    }));
+    return createSvgDocument(width, height, elements.join('\n'));
+}
+/**
+ * Generate an error state SVG
+ */
+export function generateErrorSvg(message, width = DEFAULT_WIDTH) {
+    const height = 120;
+    const elements = [];
+    elements.push(rect(0, 0, width, height, THEME.background, { rx: 12, ry: 12 }));
+    elements.push(text(width / 2, 50, 'Error', {
+        fill: THEME.error,
+        fontSize: 20,
+        fontFamily: FONTS.header,
+        fontWeight: 600,
+        textAnchor: 'middle',
+    }));
+    elements.push(text(width / 2, 80, escapeXml(message), {
+        fill: THEME.textMuted,
+        fontSize: 14,
+        fontFamily: FONTS.primary,
+        textAnchor: 'middle',
+    }));
+    return createSvgDocument(width, height, elements.join('\n'));
+}
+//# sourceMappingURL=budget-comparison.js.map