@xivdyetools/svg 1.0.0

package/README.md

@@ -0,0 +1,136 @@
+# @xivdyetools/svg
+
+> Platform-agnostic SVG card generators for the XIV Dye Tools ecosystem — pure functions: data in, SVG string out.
+
+[![npm version](https://img.shields.io/npm/v/@xivdyetools/svg)](https://www.npmjs.com/package/@xivdyetools/svg)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+## Overview
+
+`@xivdyetools/svg` generates all visual output for XIV Dye Tools bots and the web app as SVG strings. Every generator is a **pure function** — it takes data and returns an SVG string. PNG rasterization is handled by consumers using their platform's renderer (`@resvg/resvg-wasm` for Cloudflare Workers, `@resvg/resvg-js` for Node.js).
+
+## Installation
+
+```bash
+npm install @xivdyetools/svg
+```
+
+## Generators
+
+### Card Generators
+
+| Function | Description |
+|----------|-------------|
+| `generateDyeInfoCard(options)` | Single dye info card with color values |
+| `generateRandomDyesGrid(options)` | Grid of randomly selected dyes |
+| `generateComparisonGrid(options)` | Side-by-side dye comparison |
+| `generatePresetSwatch(options)` | Full preset swatch with all dye slots |
+| `generateCompactPresetSwatch(options)` | Compact single-row preset swatch |
+
+### Color Tool Generators
+
+| Function | Description |
+|----------|-------------|
+| `generateHarmonyWheel(options)` | Color harmony wheel (triadic, complementary, etc.) |
+| `generateGradientBar(options)` | Gradient bar between two colors |
+| `generatePaletteGrid(options)` | Color match palette grid with quality labels |
+| `generateAccessibilityComparison(options)` | Colorblind simulation comparison |
+| `generateCompactAccessibilityRow(options)` | Compact single-row accessibility view |
+| `generateContrastMatrix(options)` | WCAG contrast ratio matrix |
+| `generateBudgetComparison(options)` | Market price comparison chart |
+
+### Utility Generators
+
+| Function | Description |
+|----------|-------------|
+| `generateErrorSvg(message)` | Generic error message SVG |
+| `generateNoWorldSetSvg()` | "No world set" prompt SVG |
+
+## Usage
+
+```typescript
+import { generateDyeInfoCard, generateHarmonyWheel } from '@xivdyetools/svg';
+
+// Generate a dye info card
+const svg = generateDyeInfoCard({
+  dye: { name: 'Snow White', hex: '#FFFFFF', rgb: { r: 255, g: 255, b: 255 }, ... },
+  localizedName: 'Snow White',
+  localizedCategory: 'White',
+});
+// → '<svg xmlns="http://www.w3.org/2000/svg" ...>...</svg>'
+
+// Generate a harmony wheel
+const wheelSvg = generateHarmonyWheel({
+  baseDye: { name: 'Coral Pink', hex: '#FF6B6B', ... },
+  harmonyDyes: [/* complementary, triadic dyes */],
+  harmonyType: 'triadic',
+});
+```
+
+### SVG Primitives
+
+The package also exports low-level SVG building blocks for custom compositions:
+
+```typescript
+import { createSvgDocument, rect, circle, text, group, THEME, FONTS } from '@xivdyetools/svg';
+
+// Build custom SVG
+const svg = createSvgDocument(400, 300,
+  rect(0, 0, 400, 300, { fill: THEME.background }),
+  circle(200, 150, 50, { fill: '#FF6B6B' }),
+  text(200, 150, 'Hello', { fill: '#FFFFFF', fontFamily: FONTS.primary }),
+);
+```
+
+### Color Utilities
+
+```typescript
+import {
+  hexToRgb, rgbToHex,
+  getLuminance, getContrastTextColor,
+  interpolateColor, generateGradientColors,
+  calculateContrast, getMatchQuality,
+  escapeXml, formatGil,
+} from '@xivdyetools/svg';
+
+// Contrast-safe text color
+const textColor = getContrastTextColor('#1a1a2e');
+// → '#FFFFFF' (white text on dark background)
+
+// WCAG contrast ratio
+const ratio = calculateContrast('#FFFFFF', '#000000');
+// → 21 (maximum contrast)
+
+// Gradient interpolation
+const colors = generateGradientColors('#FF0000', '#0000FF', 5);
+// → ['#FF0000', '#BF003F', '#7F007F', '#3F00BF', '#0000FF']
+```
+
+## Constants
+
+| Export | Description |
+|--------|-------------|
+| `THEME` | Shared theme (background, text, accent colors, spacing) |
+| `FONTS` | Font family definitions (primary, mono, CJK) |
+| `MATCH_QUALITIES` | Color match quality thresholds |
+| `CATEGORY_DISPLAY` | Dye category display name mapping |
+
+## Design Principles
+
+- **Pure functions** — no side effects, no file I/O, no network calls
+- **No rendering** — outputs SVG strings only; consumers handle PNG rasterization
+- **CJK support** — subset Noto Sans SC/KR fonts for Chinese and Korean text
+- **Consistent theming** — all generators share `THEME` and `FONTS` constants
+- **Accessible** — contrast-safe text colors, WCAG ratio calculations built in
+
+## Dependencies
+
+| Package | Purpose |
+|---------|---------|
+| `@xivdyetools/core` | Dye database, color algorithms |
+| `@xivdyetools/types` | Shared type definitions (Dye, RGB, HSV) |
+| `@xivdyetools/color-blending` | Color interpolation for gradients |
+
+## License
+
+MIT

package/dist/accessibility-comparison.d.ts

@@ -0,0 +1,66 @@
+/**
+ * Accessibility Comparison SVG Generator
+ *
+ * Generates a visual comparison showing how a dye color appears
+ * under different types of color vision deficiency.
+ *
+ * Layout (2x2 grid):
+ * +------------------------------------------+
+ * |              Dalamud Red                 |
+ * +------------------------------------------+
+ * | [Normal Vision]   | [Protanopia]         |
+ * | #AA1111           | #967D34              |
+ * +------------------------------------------+
+ * | [Deuteranopia]    | [Tritanopia]         |
+ * | #8F8020           | #A81825              |
+ * +------------------------------------------+
+ *
+ * @module services/svg/accessibility-comparison
+ */
+/**
+ * Vision types for colorblind simulation
+ */
+export type VisionType = 'protanopia' | 'deuteranopia' | 'tritanopia';
+/**
+ * All vision types including normal
+ */
+export type AllVisionTypes = 'normal' | VisionType;
+/**
+ * Options for generating the accessibility comparison
+ */
+export interface AccessibilityComparisonOptions {
+    /** Hex color of the dye */
+    dyeHex: string;
+    /** Name of the dye */
+    dyeName: string;
+    /** Vision types to show (default: all) */
+    visionTypes?: VisionType[];
+    /** Canvas width (default: 500) */
+    width?: number;
+}
+/**
+ * Generate an accessibility comparison SVG showing colorblind simulations
+ *
+ * @param options - Comparison configuration
+ * @returns SVG string
+ *
+ * @example
+ * ```typescript
+ * const svg = generateAccessibilityComparison({
+ *   dyeHex: '#AA1111',
+ *   dyeName: 'Dalamud Red',
+ * });
+ * const png = await renderSvgToPng(svg);
+ * ```
+ */
+export declare function generateAccessibilityComparison(options: AccessibilityComparisonOptions): string;
+/**
+ * Generate a compact accessibility comparison (single row)
+ * Useful for inline display in other components
+ */
+export declare function generateCompactAccessibilityRow(hex: string, visionTypes?: VisionType[]): {
+    type: AllVisionTypes;
+    hex: string;
+    label: string;
+}[];
+//# sourceMappingURL=accessibility-comparison.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"accessibility-comparison.d.ts","sourceRoot":"","sources":["../src/accessibility-comparison.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAmBH;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG,YAAY,GAAG,cAAc,GAAG,YAAY,CAAC;AAEtE;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,QAAQ,GAAG,UAAU,CAAC;AAEnD;;GAEG;AACH,MAAM,WAAW,8BAA8B;IAC7C,2BAA2B;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,sBAAsB;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,0CAA0C;IAC1C,WAAW,CAAC,EAAE,UAAU,EAAE,CAAC;IAC3B,kCAAkC;IAClC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAoDD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,+BAA+B,CAC7C,OAAO,EAAE,8BAA8B,GACtC,MAAM,CAwDR;AA+FD;;;GAGG;AACH,wBAAgB,+BAA+B,CAC7C,GAAG,EAAE,MAAM,EACX,WAAW,GAAE,UAAU,EAAiD,GACvE;IAAE,IAAI,EAAE,cAAc,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,EAAE,CAwBxD"}

package/dist/accessibility-comparison.js

@@ -0,0 +1,201 @@
+/**
+ * Accessibility Comparison SVG Generator
+ *
+ * Generates a visual comparison showing how a dye color appears
+ * under different types of color vision deficiency.
+ *
+ * Layout (2x2 grid):
+ * +------------------------------------------+
+ * |              Dalamud Red                 |
+ * +------------------------------------------+
+ * | [Normal Vision]   | [Protanopia]         |
+ * | #AA1111           | #967D34              |
+ * +------------------------------------------+
+ * | [Deuteranopia]    | [Tritanopia]         |
+ * | #8F8020           | #A81825              |
+ * +------------------------------------------+
+ *
+ * @module services/svg/accessibility-comparison
+ */
+import { ColorService } from '@xivdyetools/core';
+import { createSvgDocument, rect, text, THEME, FONTS, escapeXml, getContrastTextColor, rgbToHex, hexToRgb, } from './base.js';
+// ============================================================================
+// Constants
+// ============================================================================
+const DEFAULT_WIDTH = 500;
+const PADDING = 20;
+const TITLE_HEIGHT = 50;
+const SWATCH_SIZE = 140;
+const SWATCH_GAP = 20;
+const LABEL_HEIGHT = 60;
+/**
+ * Vision type metadata
+ */
+const VISION_LABELS = {
+    normal: {
+        label: 'Normal Vision',
+        description: 'Full color perception',
+    },
+    protanopia: {
+        label: 'Protanopia',
+        description: 'Red-blind (~1% of males)',
+    },
+    deuteranopia: {
+        label: 'Deuteranopia',
+        description: 'Green-blind (~1% of males)',
+    },
+    tritanopia: {
+        label: 'Tritanopia',
+        description: 'Blue-blind (rare)',
+    },
+};
+// ColorService methods are static - no need for instance
+// ============================================================================
+// SVG Generation
+// ============================================================================
+/**
+ * Generate an accessibility comparison SVG showing colorblind simulations
+ *
+ * @param options - Comparison configuration
+ * @returns SVG string
+ *
+ * @example
+ * ```typescript
+ * const svg = generateAccessibilityComparison({
+ *   dyeHex: '#AA1111',
+ *   dyeName: 'Dalamud Red',
+ * });
+ * const png = await renderSvgToPng(svg);
+ * ```
+ */
+export function generateAccessibilityComparison(options) {
+    const { dyeHex, dyeName, visionTypes = ['protanopia', 'deuteranopia', 'tritanopia'], width = DEFAULT_WIDTH, } = options;
+    // Simulate colors for all vision types
+    const simulations = simulateAllVisions(dyeHex, visionTypes);
+    // Calculate dimensions for 2x2 grid
+    const gridCols = 2;
+    const gridRows = Math.ceil(simulations.length / gridCols);
+    const cellWidth = (width - PADDING * 3) / gridCols;
+    const cellHeight = SWATCH_SIZE + LABEL_HEIGHT;
+    const gridHeight = gridRows * (cellHeight + SWATCH_GAP) - SWATCH_GAP;
+    const height = PADDING * 2 + TITLE_HEIGHT + gridHeight;
+    const elements = [];
+    // Background
+    elements.push(rect(0, 0, width, height, THEME.background, { rx: 12, ry: 12 }));
+    // Title
+    elements.push(text(width / 2, PADDING + 24, escapeXml(dyeName), {
+        fill: THEME.text,
+        fontSize: 22,
+        fontFamily: FONTS.headerCjk,
+        fontWeight: 600,
+        textAnchor: 'middle',
+    }));
+    elements.push(text(width / 2, PADDING + 44, 'Color Vision Accessibility', {
+        fill: THEME.textMuted,
+        fontSize: 12,
+        fontFamily: FONTS.primary,
+        textAnchor: 'middle',
+    }));
+    // Render grid of swatches
+    const gridStartY = PADDING + TITLE_HEIGHT;
+    simulations.forEach((sim, index) => {
+        const col = index % gridCols;
+        const row = Math.floor(index / gridCols);
+        const x = PADDING + col * (cellWidth + SWATCH_GAP);
+        const y = gridStartY + row * (cellHeight + SWATCH_GAP);
+        elements.push(generateVisionSwatch(sim, x, y, cellWidth));
+    });
+    return createSvgDocument(width, height, elements.join('\n'));
+}
+/**
+ * Simulate a color for all requested vision types (plus normal)
+ */
+function simulateAllVisions(hex, visionTypes) {
+    const results = [];
+    const rgb = hexToRgb(hex);
+    // Always include normal vision first
+    results.push({
+        type: 'normal',
+        ...VISION_LABELS.normal,
+        hex,
+        rgb,
+    });
+    // Add simulated versions
+    for (const visionType of visionTypes) {
+        const simulated = ColorService.simulateColorblindness(rgb, visionType);
+        const simHex = rgbToHex(simulated.r, simulated.g, simulated.b);
+        results.push({
+            type: visionType,
+            ...VISION_LABELS[visionType],
+            hex: simHex,
+            rgb: simulated,
+        });
+    }
+    return results;
+}
+/**
+ * Generate a single vision swatch
+ */
+function generateVisionSwatch(sim, x, y, width) {
+    const elements = [];
+    const swatchX = x + (width - SWATCH_SIZE) / 2;
+    // Swatch background (slightly larger for border effect)
+    elements.push(rect(swatchX - 2, y - 2, SWATCH_SIZE + 4, SWATCH_SIZE + 4, THEME.border, {
+        rx: 10,
+        ry: 10,
+    }));
+    // Color swatch
+    elements.push(rect(swatchX, y, SWATCH_SIZE, SWATCH_SIZE, sim.hex, {
+        rx: 8,
+        ry: 8,
+    }));
+    // Vision type label
+    elements.push(text(x + width / 2, y + SWATCH_SIZE + 20, sim.label, {
+        fill: THEME.text,
+        fontSize: 13,
+        fontFamily: FONTS.primary,
+        fontWeight: 600,
+        textAnchor: 'middle',
+    }));
+    // Hex code
+    elements.push(text(x + width / 2, y + SWATCH_SIZE + 38, sim.hex.toUpperCase(), {
+        fill: THEME.textMuted,
+        fontSize: 12,
+        fontFamily: FONTS.mono,
+        textAnchor: 'middle',
+    }));
+    // Description
+    elements.push(text(x + width / 2, y + SWATCH_SIZE + 54, sim.description, {
+        fill: THEME.textDim,
+        fontSize: 10,
+        fontFamily: FONTS.primary,
+        textAnchor: 'middle',
+    }));
+    return elements.join('\n');
+}
+/**
+ * Generate a compact accessibility comparison (single row)
+ * Useful for inline display in other components
+ */
+export function generateCompactAccessibilityRow(hex, visionTypes = ['protanopia', 'deuteranopia', 'tritanopia']) {
+    const rgb = hexToRgb(hex);
+    const results = [];
+    // Normal vision
+    results.push({
+        type: 'normal',
+        hex,
+        label: 'Normal',
+    });
+    // Simulated versions
+    for (const visionType of visionTypes) {
+        const simulated = ColorService.simulateColorblindness(rgb, visionType);
+        const simHex = rgbToHex(simulated.r, simulated.g, simulated.b);
+        results.push({
+            type: visionType,
+            hex: simHex,
+            label: VISION_LABELS[visionType].label.split(' ')[0], // Just "Protanopia" etc
+        });
+    }
+    return results;
+}
+//# sourceMappingURL=accessibility-comparison.js.map

package/dist/accessibility-comparison.js.map

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

package/dist/base.d.ts

@@ -0,0 +1,115 @@
+/**
+ * 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 declare function escapeXml(str: string): string;
+/**
+ * Converts a hex color to RGB components
+ */
+export declare function hexToRgb(hex: string): {
+    r: number;
+    g: number;
+    b: number;
+};
+/**
+ * Converts RGB to hex color string
+ */
+export declare function rgbToHex(r: number, g: number, b: number): string;
+/**
+ * Calculates the luminance of a color (for contrast calculations)
+ */
+export declare function getLuminance(hex: string): number;
+/**
+ * Determines if text should be light or dark based on background color
+ */
+export declare function getContrastTextColor(bgHex: string): string;
+/**
+ * Creates an SVG document wrapper
+ */
+export declare function createSvgDocument(width: number, height: number, content: string): string;
+/**
+ * Creates a rectangle element
+ */
+export declare function rect(x: number, y: number, width: number, height: number, fill: string, options?: {
+    rx?: number;
+    ry?: number;
+    stroke?: string;
+    strokeWidth?: number;
+    opacity?: number;
+}): string;
+/**
+ * Creates a circle element
+ */
+export declare function circle(cx: number, cy: number, r: number, fill: string, options?: {
+    stroke?: string;
+    strokeWidth?: number;
+    opacity?: number;
+}): string;
+/**
+ * Creates a line element
+ */
+export declare function line(x1: number, y1: number, x2: number, y2: number, stroke: string, strokeWidth?: number, options?: {
+    opacity?: number;
+    dashArray?: string;
+}): string;
+/**
+ * Creates a text element
+ */
+export declare function text(x: number, y: number, content: string, options?: {
+    fill?: string;
+    fontSize?: number;
+    fontFamily?: string;
+    fontWeight?: number | string;
+    textAnchor?: 'start' | 'middle' | 'end';
+    dominantBaseline?: 'auto' | 'middle' | 'hanging';
+}): string;
+/**
+ * Creates an arc path for pie/donut charts
+ */
+export declare function arcPath(cx: number, cy: number, radius: number, startAngle: number, endAngle: number): string;
+/**
+ * Creates a group element
+ */
+export declare function group(content: string, transform?: string): string;
+/**
+ * Theme colors for consistent styling
+ */
+export declare const THEME: {
+    readonly background: "#1a1a2e";
+    readonly backgroundLight: "#2d2d3d";
+    readonly text: "#ffffff";
+    readonly textMuted: "#909090";
+    readonly textDim: "#666666";
+    readonly accent: "#5865f2";
+    readonly border: "#404050";
+    readonly success: "#57f287";
+    readonly warning: "#fee75c";
+    readonly 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 declare const FONTS: {
+    readonly header: "Space Grotesk";
+    readonly primary: "Onest";
+    readonly mono: "Habibi";
+    readonly cjk: "Noto Sans SC, Noto Sans KR";
+    /** Use this for headings that may contain CJK characters (e.g., dye names) */
+    readonly headerCjk: "Space Grotesk, Noto Sans SC, Noto Sans KR";
+    /** Use this for body text that may contain CJK characters (e.g., dye names) */
+    readonly primaryCjk: "Onest, Noto Sans SC, Noto Sans KR";
+};
+//# sourceMappingURL=base.d.ts.map

package/dist/base.d.ts.map

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