@xivdyetools/svg 1.0.0

package/dist/random-dyes-grid.js

@@ -0,0 +1,143 @@
+/**
+ * Random Dyes Grid SVG Generator (V4)
+ *
+ * Generates a visual infographic grid for the /dye random command.
+ * Shows 5 randomly selected dyes in an attractive card layout.
+ *
+ * Layout:
+ * +--------------------------------------------------+
+ * |  🎲 Random Dyes                                  |
+ * +--------------------------------------------------+
+ * |  [Swatch 1]  [Swatch 2]  [Swatch 3]             |
+ * |  Name        Name        Name                    |
+ * |  Category    Category    Category                |
+ * +--------------------------------------------------+
+ * |  [Swatch 4]  [Swatch 5]                         |
+ * |  Name        Name                                |
+ * |  Category    Category                            |
+ * +--------------------------------------------------+
+ *
+ * @module services/svg/random-dyes-grid
+ */
+import { createSvgDocument, rect, text, THEME, FONTS, escapeXml, getContrastTextColor, } from './base.js';
+// ============================================================================
+// Constants
+// ============================================================================
+const DEFAULT_WIDTH = 600;
+const PADDING = 20;
+const TITLE_HEIGHT = 50;
+const CARD_WIDTH = 170;
+const CARD_HEIGHT = 140;
+const CARD_GAP = 20;
+// ============================================================================
+// SVG Generation
+// ============================================================================
+/**
+ * Generate a visual grid of random dyes
+ */
+export function generateRandomDyesGrid(options) {
+    const { dyes, title = '🎲 Random Dyes', width = DEFAULT_WIDTH, uniqueCategories = false, } = options;
+    // Calculate layout
+    const cardsPerRow = 3;
+    const rows = Math.ceil(dyes.length / cardsPerRow);
+    const gridHeight = rows * (CARD_HEIGHT + CARD_GAP) - CARD_GAP;
+    const height = TITLE_HEIGHT + gridHeight + PADDING * 2;
+    const elements = [];
+    // Background
+    elements.push(rect(0, 0, width, height, THEME.background, { rx: 16, ry: 16 }));
+    // Title
+    elements.push(text(width / 2, PADDING + 24, title, {
+        fill: THEME.text,
+        fontSize: 22,
+        fontFamily: FONTS.headerCjk,
+        fontWeight: 600,
+        textAnchor: 'middle',
+    }));
+    // Subtitle based on mode
+    const subtitle = uniqueCategories
+        ? 'One from each category'
+        : `${dyes.length} randomly selected dyes`;
+    elements.push(text(width / 2, PADDING + 42, subtitle, {
+        fill: THEME.textMuted,
+        fontSize: 12,
+        fontFamily: FONTS.primary,
+        textAnchor: 'middle',
+    }));
+    // Calculate starting position for cards (centered)
+    const totalGridWidth = Math.min(dyes.length, cardsPerRow) * (CARD_WIDTH + CARD_GAP) - CARD_GAP;
+    const startX = (width - totalGridWidth) / 2;
+    const startY = TITLE_HEIGHT + PADDING;
+    // Draw dye cards
+    dyes.forEach((dyeInfo, index) => {
+        const row = Math.floor(index / cardsPerRow);
+        const col = index % cardsPerRow;
+        // Center the last row if it has fewer cards
+        const cardsInThisRow = Math.min(cardsPerRow, dyes.length - row * cardsPerRow);
+        const rowWidth = cardsInThisRow * (CARD_WIDTH + CARD_GAP) - CARD_GAP;
+        const rowStartX = (width - rowWidth) / 2;
+        const cardX = rowStartX + col * (CARD_WIDTH + CARD_GAP);
+        const cardY = startY + row * (CARD_HEIGHT + CARD_GAP);
+        elements.push(generateDyeCard(dyeInfo, cardX, cardY));
+    });
+    // Footer
+    elements.push(text(width / 2, height - 8, 'XIV Dye Tools • Run again for new results', {
+        fill: THEME.textDim,
+        fontSize: 10,
+        fontFamily: FONTS.primary,
+        textAnchor: 'middle',
+    }));
+    return createSvgDocument(width, height, elements.join('\n'));
+}
+/**
+ * Generate a single dye card
+ */
+function generateDyeCard(dyeInfo, x, y) {
+    const { dye, localizedName, localizedCategory } = dyeInfo;
+    const elements = [];
+    const swatchHeight = 80;
+    const infoHeight = CARD_HEIGHT - swatchHeight;
+    // Card background
+    elements.push(rect(x, y, CARD_WIDTH, CARD_HEIGHT, THEME.backgroundLight, {
+        rx: 12,
+        ry: 12,
+    }));
+    // Color swatch (top portion)
+    elements.push(rect(x, y, CARD_WIDTH, swatchHeight, dye.hex, {
+        rx: 12,
+        ry: 12,
+    }));
+    // Flatten bottom corners of swatch
+    elements.push(rect(x, y + swatchHeight - 12, CARD_WIDTH, 12, dye.hex));
+    // Hex value on swatch
+    const textColor = getContrastTextColor(dye.hex);
+    elements.push(text(x + CARD_WIDTH / 2, y + swatchHeight / 2 + 4, dye.hex.toUpperCase(), {
+        fill: textColor,
+        fontSize: 14,
+        fontFamily: FONTS.mono,
+        fontWeight: 600,
+        textAnchor: 'middle',
+    }));
+    // Info section
+    const infoY = y + swatchHeight + 12;
+    // Dye name (truncate if too long)
+    const maxNameLength = 18;
+    const displayName = localizedName.length > maxNameLength
+        ? localizedName.substring(0, maxNameLength - 1) + '…'
+        : localizedName;
+    elements.push(text(x + CARD_WIDTH / 2, infoY, escapeXml(displayName), {
+        fill: THEME.text,
+        fontSize: 13,
+        fontFamily: FONTS.primaryCjk,
+        fontWeight: 600,
+        textAnchor: 'middle',
+    }));
+    // Category
+    elements.push(text(x + CARD_WIDTH / 2, infoY + 18, localizedCategory, {
+        fill: THEME.textMuted,
+        fontSize: 11,
+        fontFamily: FONTS.primaryCjk,
+        textAnchor: 'middle',
+    }));
+    return elements.join('\n');
+}
+//# sourceMappingURL=random-dyes-grid.js.map

package/dist/random-dyes-grid.js.map

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

package/package.json

@@ -0,0 +1,56 @@
+{
+  "name": "@xivdyetools/svg",
+  "version": "1.0.0",
+  "description": "Platform-agnostic SVG card generators for the XIV Dye Tools ecosystem (pure functions: data in → SVG string out)",
+  "author": "XIV Dye Tools",
+  "license": "MIT",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "sideEffects": false,
+  "dependencies": {
+    "@xivdyetools/color-blending": "1.0.0",
+    "@xivdyetools/core": "1.17.0",
+    "@xivdyetools/types": "1.8.0"
+  },
+  "devDependencies": {
+    "@vitest/coverage-v8": "^4.0.18",
+    "vitest": "^4.0.18",
+    "@xivdyetools/test-utils": "1.1.1"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "keywords": [
+    "xivdyetools",
+    "svg",
+    "card",
+    "generator",
+    "ffxiv",
+    "typescript"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/FlashGalatine/xivdyetools.git",
+    "directory": "packages/svg"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "type-check": "tsc --noEmit",
+    "clean": "rimraf dist coverage",
+    "lint": "eslint src",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage"
+  }
+}