use sharp and improve prompting

.gitignore

@@ -1,3 +1,4 @@
 *.pdf
+*.png
 .env
 node_modules/**

.woodpecker/ci.yml

@@ -30,6 +30,8 @@ steps:
         from_secret: OLLAMA_API_URL
       OLLAMA_API_KEY:
         from_secret: OLLAMA_API_KEY
+      COMFYUI_URL:
+        from_secret: COMFYUI_URL
     commands:
       - npm ci
       - npm start

README.md

@@ -22,12 +22,13 @@ Scrollsmith is a Node.js tool for generating Dungeons & Dragons one-page dungeon
 
 - Node.js 22+
 - Ollama server running and accessible
-- Nextcloud (optional) for PDF uploads
+- Gitea Releases (optional) for PDF uploads
 - `.env` file with:
 
 ```env
 OLLAMA_API_URL=http://localhost:3000/api/chat/completions
 OLLAMA_API_KEY=your_api_key_here
+COMFYUI_URL=http://192.168.1.124:8188
 ````
 
 ---

dungeonGenerator.js

@@ -1,11 +1,6 @@
-const OLLAMA_API_URL = process.env.OLLAMA_API_URL;
+import { callOllama } from "./ollamaClient.js";
-const OLLAMA_API_KEY = process.env.OLLAMA_API_KEY;
 
-async function sleep(ms) {
+// Utility: strip markdown artifacts
-  return new Promise(resolve => setTimeout(resolve, ms));
-}
-
-// --- Utility: strip markdown artifacts ---
 function cleanText(str) {
   return str
     .replace(/^#+\s*/gm, "")          // remove headers
@@ -15,51 +10,6 @@ function cleanText(str) {
     .trim();
 }
 
-async function callOllama(prompt, model = "gemma3n:e4b", retries = 5, stepName = "unknown") {
-  for (let attempt = 1; attempt <= retries; attempt++) {
-    try {
-      const promptCharCount = prompt.length;
-      const promptWordCount = prompt.split(/\s+/).length;
-
-      console.log(`\n📤 [${stepName}] Sending prompt (attempt ${attempt}/${retries})`);
-      console.log(`   Prompt: ${promptCharCount} chars, ~${promptWordCount} words`);
-
-      const response = await fetch(OLLAMA_API_URL, {
-        method: "POST",
-        headers: {
-          "Authorization": `Bearer ${OLLAMA_API_KEY}`,
-          "Content-Type": "application/json",
-        },
-        body: JSON.stringify({
-          model,
-          messages: [{ role: "user", content: prompt }],
-        }),
-      });
-
-      if (!response.ok) throw new Error(`Ollama request failed: ${response.status} ${response.statusText}`);
-
-      const data = await response.json();
-      const rawText = data.choices?.[0]?.message?.content;
-      if (!rawText) throw new Error("No response from Ollama");
-
-      const cleaned = cleanText(rawText);
-
-      console.log(`✅ [${stepName}] Received: ${rawText.length} chars, ~${rawText.split(/\s+/).length} words`);
-      console.log(`--- Raw output ---\n${rawText}\n`);
-      console.log(`--- Cleaned output ---\n${cleaned}\n`);
-
-      return cleaned;
-
-    } catch (err) {
-      console.warn(`⚠️ [${stepName}] Attempt ${attempt} failed: ${err.message}`);
-      if (attempt === retries) throw err;
-      const delay = 1000 * Math.pow(2, attempt) + Math.random() * 500;
-      console.log(`   Retrying in ${Math.round(delay / 1000)}s...`);
-      await sleep(delay);
-    }
-  }
-}
-
 function parseList(raw) {
   return raw
     .split(/\n?\d+[).]\s+/)
@@ -83,11 +33,9 @@ function parseObjects(raw, type = "rooms") {
 }
 
 export async function generateDungeon() {
-  console.log("🏗️ Starting compact dungeon generation with debug logs...\n");
+  // Step 1: Titles
-
+  const generatedTitlesRaw = await callOllama(
-  // --- Step 1: Titles ---
+    `Generate 50 short, punchy dungeon titles (max 5 words each), numbered as a plain text list.
-  const titles10Raw = await callOllama(
-    `Generate 10 short, punchy dungeon titles (max 5 words each), numbered as a plain text list.
 Each title should come from a different style or theme. Make the set varied and evocative. For example:
 
 - OSR / classic tabletop: gritty, mysterious, old-school
@@ -97,59 +45,38 @@ Each title should come from a different style or theme. Make the set varied and
 - Weird fantasy: uncanny, surreal, unsettling
 - Whimsical: fun, quirky, playful
 
-Avoid repeating materials or adjectives. Avoid the words "obsidian" and "clockwork". Do not include explanations, markdown, or preambles. Only the 10 numbered titles.`,
+Avoid repeating materials or adjectives. Absolutely do not use the words "Obsidian" or "Clockwork" in any title. Do not include explanations, markdown, or preambles. Do not include the style or theme in parenthesis. Only the 50 numbered titles.`,
     undefined, 5, "Step 1: Titles"
   );
-  const titles10 = parseList(titles10Raw, 30);
+  const generatedTitles = parseList(generatedTitlesRaw);
-  console.log("🔹 Parsed titles10:", titles10);
+  console.log("Generated Titles:", generatedTitles);
+  const title = generatedTitles[Math.floor(Math.random() * generatedTitles.length)];
+  console.log("Selected title:", title);
 
-  // --- Step 2: Narrow to 5 ---
+  // Step 2: Flavor text
-  const titles5Raw = await callOllama(
-    `Here are 10 dungeon titles:
-${titles10.join("\n")}
-
-Randomly select 3 of the titles from the above list and create 2 additional unique titles. Avoid the words "obsidian" and "clockwork".
-Output exactly 5 titles as a numbered list, plain text only. No explanations.`,
-    undefined, 5, "Step 2: Narrow Titles"
-  );
-  const titles5 = parseList(titles5Raw, 30);
-  console.log("🔹 Parsed titles5:", titles5);
-
-  // --- Step 3: Final title ---
-  const bestTitleRaw = await callOllama(
-    `From the following 5 dungeon titles, randomly select only one of them.
-Output only the title, no explanation, no numbering, no extra text:
-
-${titles5.join("\n")}`,
-    undefined, 5, "Step 3: Final Title"
-  );
-  const title = cleanText(bestTitleRaw.split("\n")[0]);
-  console.log("🔹 Selected title:", title);
-
-  // --- Step 4: Flavor text ---
   const flavorRaw = await callOllama(
-    `Write a single evocative paragraph describing the dungeon titled "${title}".
+    `Write a single evocative paragraph describing the location titled "${title}". Absolutely do not use the words "Obsidian" or "Clockwork" anywhere in the paragraph.
-Do not include hooks, NPCs, treasure, or instructions. Output plain text only, one paragraph. Maximum 4 sentences.`,
+Do not include hooks, NPCs, treasure, or instructions. Do not use bullet points or em-dashes. Output plain text only, one paragraph. Maximum 4 sentences.`,
-    undefined, 5, "Step 4: Flavor"
+    undefined, 5, "Step 2: Flavor"
   );
   const flavor = flavorRaw;
-  console.log("🔹 Flavor text:", flavor);
+  console.log("Flavor text:", flavor);
 
-  // --- Step 5: Hooks & Rumors ---
+  // Step 3: Hooks & Rumors
   const hooksRumorsRaw = await callOllama(
-    `Based only on this dungeon flavor:
+    `Based only on this location's flavor:
 
 ${flavor}
 
 Generate 3 short adventure hooks or rumors (mix them naturally).
-Output as a single numbered list, plain text only.
+Output as a single numbered list, plain text only. Do not use em-dashes.
 Maximum 2 sentences per item. No explanations or extra text.`,
-    undefined, 5, "Step 5: Hooks & Rumors"
+    undefined, 5, "Step 3: Hooks & Rumors"
   );
-  const hooksRumors = parseList(hooksRumorsRaw, 120);
+  const hooksRumors = parseList(hooksRumorsRaw);
-  console.log("🔹 Hooks & Rumors:", hooksRumors);
+  console.log("Hooks & Rumors:", hooksRumors);
 
-  // --- Step 6: Rooms & Encounters ---
+  // Step 4: Rooms & Encounters
   const roomsEncountersRaw = await callOllama(
     `Using the flavor and these hooks/rumors:
 
@@ -159,35 +86,37 @@ ${flavor}
 Hooks & Rumors:
 ${hooksRumors.join("\n")}
 
-Generate 5 rooms (name + short description) and 3 encounters (name + details).
+Generate 5 rooms (name + short description) and 6 encounters (name + details).
 Output two numbered lists, labeled "Rooms:" and "Encounters:". Plain text only. No extra explanation.`,
-    undefined, 5, "Step 6: Rooms & Encounters"
+    undefined, 5, "Step 4: Rooms & Encounters"
   );
   const [roomsSection, encountersSection] = roomsEncountersRaw.split(/Encounters[:\n]/i);
   const rooms = parseObjects(roomsSection.replace(/Rooms[:\n]*/i, ""), "rooms", 120);
   const encounters = parseObjects(encountersSection || "", "encounters", 120);
-  console.log("🔹 Rooms:", rooms);
+  console.log("Rooms:", rooms);
-  console.log("🔹 Encounters:", encounters);
+  console.log("Encounters:", encounters);
 
-  // --- Step 7: Treasure & NPCs ---
+  // Step 5: Treasure & NPCs
   const treasureNpcsRaw = await callOllama(
     `Based only on these rooms and encounters:
 
 ${JSON.stringify({ rooms, encounters }, null, 2)}
 
 Generate 3 treasures and 3 NPCs (name + trait, max 2 sentences each).
+Each NPC has a proper name, not just a title.
+Treasure should sometimes include a danger or side-effect.
 Output numbered lists labeled "Treasure:" and "NPCs:". Plain text only, no extra text.`,
-    undefined, 5, "Step 7: Treasure & NPCs"
+    undefined, 5, "Step 5: Treasure & NPCs"
   );
   const [treasureSection, npcsSection] = treasureNpcsRaw.split(/NPCs[:\n]/i);
-  const treasure = parseList(treasureSection.replace(/Treasures?[:\n]*/i, ""), 120);
+  const treasure = parseList(treasureSection.replace(/Treasures?[:\n]*/i, ""));
   const npcs = parseObjects(npcsSection || "", "npcs", 120);
-  console.log("🔹 Treasure:", treasure);
+  console.log("Treasure:", treasure);
-  console.log("🔹 NPCs:", npcs);
+  console.log("NPCs:", npcs);
 
-  // --- Step 8: Plot Resolutions ---
+  // Step 6: Plot Resolutions
   const plotResolutionsRaw = await callOllama(
-    `Based on the following dungeon flavor and story hooks:
+    `Based on the following location's flavor and story hooks:
 
 Flavor:
 ${flavor}
@@ -198,15 +127,16 @@ ${hooksRumors.join("\n")}
 Major NPCs / Encounters:
 ${[...npcs.map(n => n.name), ...encounters.map(e => e.name)].join(", ")}
 
-Suggest 3 possible, non-conflicting story climaxes or plot resolutions for adventurers exploring this dungeon.
+Suggest 3 possible, non-conflicting story climaxes or plot resolutions for adventurers exploring this location.
-These are prompts and ideas for brainstorming the dungeon's ending, not fixed outcomes.
+These are prompts and ideas for brainstorming the story's ending, not fixed outcomes. Give the players meaningful choices and agency.
-Start each item with phrases like "The adventurers could..." or "The PCs might..." to emphasize their hypothetical nature.
+Start each item with phrases like "The adventurers could" or "The PCs might" to emphasize their hypothetical nature.
+Deepen the narrative texture and allow roleplay and tactical creativity.
 Keep each item short (max 2 sentences). Output as a numbered list, plain text only.`,
-    undefined, 5, "Step 8: Plot Resolutions"
+    undefined, 5, "Step 6: Plot Resolutions"
   );
-  const plotResolutions = parseList(plotResolutionsRaw, 180);
+  const plotResolutions = parseList(plotResolutionsRaw);
-  console.log("🔹 Plot Resolutions:", plotResolutions);
+  console.log("Plot Resolutions:", plotResolutions);
 
-  console.log("\n🎉 Dungeon generation complete!");
+  console.log("\nDungeon generation complete!");
   return { title, flavor, map: "map.png", hooksRumors, rooms, encounters, treasure, npcs, plotResolutions };
 }

dungeonTemplate.js

@@ -11,9 +11,11 @@ export function dungeonTemplate(data) {
   ];
 
   const headingFonts = [
-    "'Cinzel Decorative', cursive",
+    "'New Rocker', system-ui",
-    "'MedievalSharp', cursive",
+    "'UnifrakturCook', cursive",
-    "'Metamorphous', cursive",
+    "'IM Fell DW Pica', serif",
+    "'Cinzel', serif",
+    "'Cormorant Garamond', serif",
     "'Playfair Display', serif"
   ];
 
@@ -25,10 +27,9 @@ export function dungeonTemplate(data) {
   ];
 
   const quoteFonts = [
-    "'Walter Turncoat', cursive",
+    "'Playfair Display', serif",
-    "'Uncial Antiqua', serif",
+    "'Libre Baskerville', serif",
-    "'Beth Ellen', cursive",
+    "'Merriweather', serif"
-    "'Pinyon Script', cursive"
   ];
 
   const bodyFont = pickRandom(bodyFonts);
@@ -40,112 +41,185 @@ export function dungeonTemplate(data) {
 <!DOCTYPE html>
 <html>
 <head>
-<meta charset="UTF-8">
+  <meta charset="UTF-8">
-<title>${data.title}</title>
+  <title>${data.title}</title>
-<link href="https://fonts.googleapis.com/css2?family=Cinzel+Decorative&family=MedievalSharp&family=Metamorphous&family=Playfair+Display&family=Alegreya+Sans&family=Cabin&family=IBM+Plex+Sans&family=Cormorant+Garamond&family=Lora&family=Merriweather&family=Libre+Baskerville&family=Source+Serif+4&family=Walter+Turncoat&family=Uncial+Antiqua&family=Beth+Ellen&family=Pinyon+Script&display=swap" rel="stylesheet">
+  <link
-<style>
+    href="https://fonts.googleapis.com/css2?family=Cinzel+Decorative&family=UnifrakturCook&family=New+Rocker&family=Metamorphous&family=Playfair+Display&family=Alegreya+Sans&family=Cabin&family=IBM+Plex+Sans&family=Cormorant+Garamond&family=Lora&family=Merriweather&family=Libre+Baskerville&family=Source+Serif+4&family=Walter+Turncoat&family=Uncial+Antiqua&family=Beth+Ellen&family=Pinyon+Script&display=swap"
-  @page { size: A4 landscape; margin: 0; }
+    rel="stylesheet">
-  body {
+  <style>
-    margin: 0; padding: 1.5cm;
+    @page {
-    background: #f5f5f5;
+      size: A4 landscape;
-    font-family: ${bodyFont};
+      margin: 0;
-    color: #1a1a1a;
+    }
-    font-size: 0.7em;
+    body {
-    line-height: 1.25em;
+      margin: 0;
-  }
+      padding: 0;
-  h1 {
+      font-family: ${bodyFont};
-    font-family: ${headingFont};
+      color: #1a1a1a;
-    text-align: center;
+      font-size: 0.7em;
-    font-size: 2em;
+      line-height: 1.25em;
-    margin: 0.2em 0 0.3em;
+    }
-    color: #1a1a1a;
+    .content-page {
-    border-bottom: 2px solid #1a1a1a;
+      height: 100vh;
-    padding-bottom: 0.2em;
+      box-sizing: border-box;
-    letter-spacing: 0.1em;
+      padding: 1.5cm;
-  }
+      page-break-after: always;
-  .flavor {
+      overflow: hidden;
-    text-align: center;
+      break-inside: avoid;
-    font-style: italic;
+    }
-    font-family: ${quoteFont};
+    h1 {
-    margin: 0.4em 0 0.8em;
+      font-family: ${headingFont};
-    font-size: 0.9em;
+      text-align: center;
-  }
+      text-transform: uppercase;
-  .columns {
+      font-size: 2em;
-    display: grid;
+      margin: 0.2em 0 0.3em;
-    grid-template-columns: 1fr 1fr 1fr;
+      color: #1a1a1a;
-    gap: 0.5cm;
+      border-bottom: 2px solid #1a1a1a;
-    align-items: start;
+      padding-bottom: 0.2em;
-  }
+      letter-spacing: 0.1em;
-  .col {
+    }
-    display: flex; flex-direction: column;
+    .flavor {
-    gap: 0.15em;
+      text-align: center;
-  }
+      font-style: italic;
-  h2 {
+      font-family: ${quoteFont};
-    font-family: ${headingFont};
+      margin: 0.4em 0 0.8em;
-    font-size: 1.0em;
+      font-size: 0.9em;
-    margin: 0.3em 0 0.1em;
+    }
-    color: #1a1a1a;
+    .columns {
-    border-bottom: 1px solid #1a1a1a;
+      display: grid;
-    padding-bottom: 0.1em;
+      grid-template-columns: 1fr 1fr 1fr;
-    text-transform: uppercase;
+      gap: 0.5cm;
-    letter-spacing: 0.05em;
+      align-items: start;
-  }
+    }
-  .room h3 { margin: 0.2em 0 0.05em; font-size: 0.95em; font-weight: bold; }
+    .col {
-  .room p { text-align: justify; word-wrap: break-word; margin: 0.1em 0 0.3em; }
+      display: flex;
-  ul { padding-left: 1em; margin: 0.1em 0 0.3em; }
+      flex-direction: column;
-  li { margin-bottom: 0.2em; }
+      gap: 0.15em;
-  table { width: 100%; border-collapse: collapse; font-family: ${tableFont}; font-size: 0.8em; }
+    }
-  th, td { border: 1px solid #1a1a1a; padding: 0.2em; text-align: left; vertical-align: top; }
+    h2 {
-  th { background: #e0e0e0; }
+      font-family: ${headingFont};
-  table tr:hover { background: rgba(0, 0, 0, 0.05); }
+      font-size: 1.0em;
-  .map-page {
+      margin: 0.3em 0 0.1em;
-    page-break-before: always;
+      color: #1a1a1a;
-    text-align: center;
+      border-bottom: 1px solid #1a1a1a;
-  }
+      padding-bottom: 0.1em;
-  .map-page img { max-width: 100%; max-height: 27cm; border: 2px solid #1a1a1a; border-radius: 0.2cm; }
+      text-transform: uppercase;
-  footer {
+      letter-spacing: 0.05em;
-    text-align: center; font-size: 0.65em; color: #555; margin-top: 0.5em; font-style: italic;
+    }
-  }
+    .room h3 {
-</style>
+      margin: 0.2em 0 0.05em;
+      font-size: 0.95em;
+      font-weight: bold;
+    }
+    .room p {
+      text-align: justify;
+      word-wrap: break-word;
+      margin: 0.1em 0 0.3em;
+    }
+    ul {
+      padding-left: 1em;
+      margin: 0.1em 0 0.3em;
+    }
+    li {
+      margin-bottom: 0.2em;
+    }
+    table {
+      width: 100%;
+      border-collapse: collapse;
+      font-family: ${tableFont};
+      font-size: 0.8em;
+    }
+    th,
+    td {
+      border: 1px solid #1a1a1a;
+      padding: 0.2em;
+      text-align: left;
+      vertical-align: top;
+    }
+    th {
+      background: #e0e0e0;
+    }
+    table tr:hover {
+      background: rgba(0, 0, 0, 0.05);
+    }
+    .map-page {
+      height: 210mm;
+      width: 297mm;
+      box-sizing: border-box;
+      padding: 1.5cm;
+      position: relative;
+      display: block;
+    }
+    .map-image-container {
+      position: absolute;
+      top: 1.5cm;
+      left: 1.5cm;
+      right: 1.5cm;
+      bottom: 3cm;
+      display: flex;
+      align-items: center;
+      justify-content: center;
+    }
+    .map-page img {
+      max-width: 100%;
+      max-height: 100%;
+      object-fit: contain;
+    }
+    .map-page footer {
+      position: absolute;
+      bottom: 1.5cm;
+      left: 1.5cm;
+      right: 1.5cm;
+      text-align: center;
+      font-size: 0.65em;
+      color: #555;
+      font-style: italic;
+    }
+  </style>
 </head>
 <body>
-<h1>${data.title}</h1>
+  <div class="content-page">
-<p class="flavor">${data.flavor}</p>
+    <h1>${data.title}</h1>
-
+    <p class="flavor">${data.flavor}</p>
-<div class="columns">
+    <div class="columns">
-  <div class="col">
+      <div class="col">
-    <h2>Adventure Hooks & Rumors</h2>
+        <h2>Adventure Hooks & Rumors</h2>
-    <ul>${data.hooksRumors.map(item => `<li>${item}</li>`).join("")}</ul>
+        <ul>${data.hooksRumors.map(item => `<li>${item}</li>`).join("")}</ul>
-
+        <h2>Locations</h2>
-    <h2>Locations</h2>
+        ${data.rooms.map((room, i) => `<div class="room">
-    ${data.rooms.map((room, i) => `<div class="room"><h3>${i + 1}. ${room.name}</h3><p>${room.description}</p></div>`).join("")}
+          <h3>${i + 1}. ${room.name}</h3>
+          <p>${room.description}</p>
+        </div>`).join("")}
+      </div>
+      <div class="col">
+        <h2>Encounters</h2>
+        <table>
+          <tr>
+            <th>Name</th>
+            <th>Details</th>
+          </tr>
+          ${data.encounters.map(e => `<tr>
+            <td>${e.name}</td>
+            <td>${e.details}</td>
+          </tr>`).join("")}
+        </table>
+        <h2>Treasure</h2>
+        <ul>${data.treasure.map(t => `<li>${t}</li>`).join("")}</ul>
+      </div>
+      <div class="col">
+        <h2>NPCs</h2>
+        <ul>${data.npcs.map(n => `<li><b>${n.name}</b>: ${n.trait}</li>`).join("")}</ul>
+        <h2>Plot Resolutions</h2>
+        <ul>${data.plotResolutions.map(p => `<li>${p}</li>`).join("")}</ul>
+      </div>
+    </div>
   </div>
-
+  <div class="map-page">
-  <div class="col">
+    <div class="map-image-container">
-    <h2>Encounters</h2>
+      <img src="${data.map}" alt="Dungeon Map">
-    <table><tr><th>Name</th><th>Details</th></tr>
+    </div>
-      ${data.encounters.map(e => `<tr><td>${e.name}</td><td>${e.details}</td></tr>`).join("")}
+    <footer>Scrollsmith • © ${new Date().getFullYear()}</footer>
-    </table>
-
-    <h2>Treasure</h2>
-    <ul>${data.treasure.map(t => `<li>${t}</li>`).join("")}</ul>
   </div>
-
-  <div class="col">
-    <h2>NPCs</h2>
-    <ul>${data.npcs.map(n => `<li><b>${n.name}</b>: ${n.trait}</li>`).join("")}</ul>
-
-    <h2>Plot Resolutions</h2>
-    <ul>${data.plotResolutions.map(p => `<li>${p}</li>`).join("")}</ul>
-  </div>
-</div>
-
-<div class="map-page">
-  <h2>Dungeon Map</h2>
-  <img src="file://${data.map}" alt="Dungeon Map">
-</div>
-
-<footer>Generated with Scrollsmith • © ${new Date().getFullYear()}</footer>
 </body>
 </html>
   `;

generatePDF.js

@@ -1,12 +1,20 @@
 import puppeteer from "puppeteer";
 import { dungeonTemplate } from "./dungeonTemplate.js";
 
-export async function generateDungeonPDF(data, outputPath = "dungeon.pdf") {
+import fs from 'fs/promises';
+
+export async function generatePDF(data, outputPath = "dungeon.pdf") {
   const browser = await puppeteer.launch({
-        args: ['--no-sandbox', '--disable-setuid-sandbox']
+    args: ['--no-sandbox', '--disable-setuid-sandbox']
-    });
+  });
+
   const page = await browser.newPage();
 
+  // Convert image to base64
+  const imageBuffer = await fs.readFile(data.map);
+  const base64Image = `data:image/png;base64,${imageBuffer.toString("base64")}`;
+  data.map = base64Image;
+
   const html = dungeonTemplate(data);
   await page.setContent(html, { waitUntil: "networkidle0" });
 
@@ -15,6 +23,7 @@ export async function generateDungeonPDF(data, outputPath = "dungeon.pdf") {
     format: "A4",
     landscape: true,
     printBackground: true,
+    preferCSSPageSize: true
   });
 
   await browser.close();

imageGenerator.js

@@ -0,0 +1,235 @@
+import sharp from 'sharp';
+import path from "path";
+import { mkdir, writeFile } from "fs/promises";
+import { fileURLToPath } from "url";
+import { callOllama } from "./ollamaClient.js";
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+const COMFYUI_URL = process.env.COMFYUI_URL || "http://localhost:8188";
+
+// Drawing style prefix
+const STYLE_PREFIX = `clean line art, minimalist sketch, concept art sketch, black and white line drawing, lots of white space, sparse shading, very minimal shading, simple black hatching, very low detail, single accent color`;
+
+async function upscaleImage(inputPath, outputPath, width, height) {
+  try {
+    await sharp(inputPath)
+      .resize(width, height, { kernel: 'lanczos3' })
+      .blur(0.3)
+      .sharpen()
+      .png({
+        compressionLevel: 9,
+        adaptiveFiltering: true,
+        palette: true
+      })
+      .toFile(outputPath);
+    console.log(`Upscaled + compressed PNG saved: ${outputPath}`);
+    return outputPath;
+  } catch (err) {
+    console.error("Error during upscaling:", err.message);
+    return null;
+  }
+}
+
+// 1. Generate engineered visual prompt
+async function generateVisualPrompt(flavor) {
+  const rawPrompt = await callOllama(
+    `You are a prompt engineer specializing in visual prompts for AI image generation. Your goal is to translate fantasy flavor text into a sparse, minimalist scene description.
+
+Your output must be a simple list of visual tags describing only the most essential elements of the scene. Focus on the core subject and mood.
+
+Rules:
+- Describe a sparse scene with a single focal point or area.
+- Use only 3-5 key descriptive phrases or tags.
+- The entire output should be very short, 20-50 words maximum.
+- Do NOT repeat wording from the input.
+- Focus only on visual content, not style, medium, or camera effects.
+- Avoid describing fine details; focus on large forms and the overall impression.
+- Do NOT include phrases like “an image of” or “a scene showing”.
+
+Input:
+${flavor}
+
+Output:`,
+    "gemma3n:e4b", 3, "Generate Visual Prompt"
+  );
+
+  return `${STYLE_PREFIX}, ${rawPrompt.trim().replace(/\n/g, " ")}`;
+}
+
+// 2. Save image buffer
+async function saveImage(buffer, filename) {
+  const filepath = path.join(__dirname, filename);
+  await mkdir(__dirname, { recursive: true });
+  await writeFile(filepath, buffer);
+  console.log(`Saved image: ${filepath}`);
+  return filepath;
+}
+
+// 3. Build workflow payload
+function buildComfyWorkflow(promptText, negativeText = "") {
+  return {
+    "3": {
+      "inputs": {
+        "seed": Math.floor(Math.random() * 100000),
+        "steps": 4,
+        "cfg": 1,
+        "sampler_name": "euler",
+        "scheduler": "simple",
+        "denoise": 1,
+        "model": ["4", 0],
+        "positive": ["6", 0],
+        "negative": ["7", 0],
+        "latent_image": ["5", 0]
+      },
+      "class_type": "KSampler"
+    },
+    "4": {
+      "inputs": {
+        "unet_name": "flux1-schnell-fp8.safetensors",
+        "weight_dtype": "fp8_e4m3fn"
+      },
+      "class_type": "UNETLoader"
+    },
+    "5": {
+      "inputs": {
+        "width": 728,
+        "height": 512,
+        "batch_size": 1
+      },
+      "class_type": "EmptyLatentImage"
+    },
+    "6": {
+      "inputs": {
+        "text": promptText,
+        "clip": ["10", 0]
+      },
+      "class_type": "CLIPTextEncode"
+    },
+    "7": {
+      "inputs": {
+        "text": negativeText,
+        "clip": ["10", 0]
+      },
+      "class_type": "CLIPTextEncode"
+    },
+    "10": {
+      "inputs": {
+        "clip_name1": "clip_l.safetensors",
+        "clip_name2": "t5xxl_fp8_e4m3fn.safetensors",
+        "type": "flux"
+      },
+      "class_type": "DualCLIPLoader"
+    },
+    "11": {
+      "inputs": {
+        "vae_name": "ae.safetensors"
+      },
+      "class_type": "VAELoader"
+    },
+    "8": {
+      "inputs": {
+        "samples": ["3", 0],
+        "vae": ["11", 0]
+      },
+      "class_type": "VAEDecode"
+    },
+    "9": {
+      "inputs": {
+        "filename_prefix": "ComfyUI_Flux",
+        "images": ["8", 0]
+      },
+      "class_type": "SaveImage"
+    }
+  };
+}
+
+
+// 4a. Wait for ComfyUI to finish image generation
+async function waitForImage(promptId, timeout = 900000) {
+  const start = Date.now();
+
+  while (Date.now() - start < timeout) {
+    const res = await fetch(`${COMFYUI_URL}/history`);
+    const data = await res.json();
+    const historyEntry = data[promptId];
+
+    if (historyEntry?.outputs) {
+      const images = Object.values(historyEntry.outputs).flatMap(o => o.images || []);
+      if (images.length > 0) return images.map(i => i.filename);
+    }
+
+    await new Promise(resolve => setTimeout(resolve, 1000));
+  }
+
+  throw new Error("Timed out waiting for ComfyUI image result.");
+}
+
+// 4b. Download image from ComfyUI server
+async function downloadImage(filename, localFilename) {
+  const url = `${COMFYUI_URL}/view?filename=${filename}`;
+  const res = await fetch(url);
+
+  if (!res.ok) throw new Error(`Failed to fetch image: ${res.statusText}`);
+  const buffer = Buffer.from(await res.arrayBuffer());
+
+  return await saveImage(buffer, localFilename);
+}
+
+// 4c. Submit prompt and handle full image pipeline
+async function generateImageViaComfyUI(prompt, filename) {
+  const negativePrompt = `heavy shading, deep blacks, cross-hatching, dark, gritty, shadow-filled, chiaroscuro, scratchy lines, photorealism, hyper-realistic, high detail, 3D render, CGI, polished, smooth shading, detailed textures, noisy, cluttered, blurry, text, logo, signature, watermark, artist name, branding, ugly, deformed, unnatural patterns, perfect curves, repetitive textures`;
+  const workflow = buildComfyWorkflow(prompt, negativePrompt);
+
+  try {
+    console.log("Submitting prompt to ComfyUI...");
+    const res = await fetch(`${COMFYUI_URL}/prompt`, {
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify({ prompt: workflow })
+    });
+
+    if (!res.ok) {
+      throw new Error(`ComfyUI error: ${res.statusText}`);
+    }
+
+    const { prompt_id } = await res.json();
+
+    console.log("Waiting for image result...");
+    const filenames = await waitForImage(prompt_id);
+    if (filenames.length === 0) throw new Error("No image generated");
+
+    const comfyFilename = filenames[0];
+
+    console.log("Downloading image...");
+    const filepath = await downloadImage(comfyFilename, filename);
+    return filepath;
+
+  } catch (err) {
+    console.error("Error generating image:", err.message);
+    return null;
+  }
+}
+
+// 5. Main export
+export async function generateDungeonImages({ flavor }) {
+  console.log("Generating dungeon image...");
+
+  const finalPrompt = await generateVisualPrompt(flavor);
+  console.log("Engineered visual prompt:\n", finalPrompt);
+
+  const baseFilename = `dungeon.png`;
+  const upscaledFilename = `dungeon_upscaled.png`;
+
+  const filepath = await generateImageViaComfyUI(finalPrompt, baseFilename);
+  if (!filepath) {
+    throw new Error("Failed to generate dungeon image.");
+  }
+
+  // Upscale 2x (half of A4 at 300dpi)
+  const upscaledPath = await upscaleImage(filepath, upscaledFilename, 1456, 1024);
+  if (!upscaledPath) {
+    throw new Error("Failed to upscale dungeon image.");
+  }
+
+  return upscaledPath;
+}

index.js

@@ -1,6 +1,7 @@
 import 'dotenv/config';
-import { generateDungeonPDF } from "./generateDungeon.js";
 import { generateDungeon } from "./dungeonGenerator.js";
+import { generateDungeonImages } from "./imageGenerator.js";
+import { generatePDF } from "./generatePDF.js";
 
 // Utility to create a filesystem-safe filename from the dungeon title
 function slugify(text) {
@@ -12,17 +13,19 @@ function slugify(text) {
 
 (async () => {
   try {
-    // Generate dungeon JSON from Ollama
+    // Generate the dungeon data
     const dungeonData = await generateDungeon();
 
-    // Optional: replace the map placeholder with your local map path
+    // Generate dungeon map image (uses dungeonData.flavor)
-    // dungeonData.map = "/absolute/path/to/dungeon-map.png";
+    const mapPath = await generateDungeonImages(dungeonData);
 
-    // Generate a safe filename based on the dungeon's title
+    dungeonData.map = mapPath;
+
+    // Generate PDF filename based on the title
     const filename = `${slugify(dungeonData.title)}.pdf`;
 
-    // Generate PDF
+    // Generate the PDF using full dungeon data (including map)
-    await generateDungeonPDF(dungeonData, filename);
+    await generatePDF(dungeonData, filename);
 
     console.log(`Dungeon PDF successfully generated: ${filename}`);
   } catch (err) {

ollamaClient.js

@@ -0,0 +1,78 @@
+const OLLAMA_API_URL = process.env.OLLAMA_API_URL;
+const OLLAMA_API_KEY = process.env.OLLAMA_API_KEY;
+
+async function sleep(ms) {
+  return new Promise(resolve => setTimeout(resolve, ms));
+}
+
+// Utility: strip markdown artifacts
+function cleanText(str) {
+  return str
+    .replace(/^#+\s*/gm, "")          // remove headers
+    .replace(/\*\*(.*?)\*\*/g, "$1")  // remove bold
+    .replace(/[*_`]/g, "")            // remove stray formatting
+    .replace(/\s+/g, " ")             // normalize whitespace
+    .trim();
+}
+
+export async function callOllama(prompt, model = "gemma3n:e4b", retries = 5, stepName = "unknown") {
+  const isUsingOpenWebUI = !!OLLAMA_API_KEY;
+
+  for (let attempt = 1; attempt <= retries; attempt++) {
+    try {
+      const promptCharCount = prompt.length;
+      const promptWordCount = prompt.split(/\s+/).length;
+
+      console.log(`\n[${stepName}] Sending prompt (attempt ${attempt}/${retries})`);
+      console.log(`Prompt: ${promptCharCount} chars, ~${promptWordCount} words`);
+
+      const headers = { "Content-Type": "application/json" };
+
+      if (isUsingOpenWebUI) {
+        headers["Authorization"] = `Bearer ${OLLAMA_API_KEY}`;
+      }
+
+      const body = isUsingOpenWebUI
+        ? {
+          model,
+          messages: [{ role: "user", content: prompt }],
+        }
+        : {
+          model,
+          messages: [{ role: "user", content: prompt }],
+          stream: false,
+        };
+
+      const response = await fetch(OLLAMA_API_URL, {
+        method: "POST",
+        headers,
+        body: JSON.stringify(body),
+      });
+
+      if (!response.ok) throw new Error(`Ollama request failed: ${response.status} ${response.statusText}`);
+
+      const data = await response.json();
+
+      const rawText = isUsingOpenWebUI
+        ? data.choices?.[0]?.message?.content
+        : data.message?.content;
+
+      if (!rawText) throw new Error("No response from Ollama");
+
+      const cleaned = cleanText(rawText);
+
+      console.log(`[${stepName}] Received: ${rawText.length} chars, ~${rawText.split(/\s+/).length} words`);
+      // console.log(`Raw output:\n${rawText}\n`);
+      // console.log(`Cleaned output:\n${cleaned}\n`);
+
+      return cleaned;
+
+    } catch (err) {
+      console.warn(`[${stepName}] Attempt ${attempt} failed: ${err.message}`);
+      if (attempt === retries) throw err;
+      const delay = 1000 * Math.pow(2, attempt) + Math.random() * 500;
+      console.log(`Retrying in ${Math.round(delay / 1000)}s...`);
+      await sleep(delay);
+    }
+  }
+}

package-lock.json

@@ -1,16 +1,17 @@
 {
-  "name": "auto-dm",
+  "name": "scrollsmith",
   "version": "1.0.0",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
-      "name": "auto-dm",
+      "name": "scrollsmith",
       "version": "1.0.0",
       "license": "SEE LICENSE IN README.md",
       "dependencies": {
         "dotenv": "^17.2.1",
-        "puppeteer": "^24.17.1"
+        "puppeteer": "^24.17.1",
+        "sharp": "^0.34.3"
       },
       "devDependencies": {
         "@eslint/js": "^9.34.0",
@@ -41,10 +42,20 @@
         "node": ">=6.9.0"
       }
     },
+    "node_modules/@emnapi/runtime": {
+      "version": "1.5.0",
+      "resolved": "https://registry.npmjs.org/@emnapi/runtime/-/runtime-1.5.0.tgz",
+      "integrity": "sha512-97/BJ3iXHww3djw6hYIfErCZFee7qCtrneuLa20UXFCOTCfBM2cvQHjWJ2EG0s0MtdNwInarqCTz35i4wWXHsQ==",
+      "license": "MIT",
+      "optional": true,
+      "dependencies": {
+        "tslib": "^2.4.0"
+      }
+    },
     "node_modules/@eslint-community/eslint-utils": {
-      "version": "4.7.0",
+      "version": "4.8.0",
-      "resolved": "https://registry.npmjs.org/@eslint-community/eslint-utils/-/eslint-utils-4.7.0.tgz",
+      "resolved": "https://registry.npmjs.org/@eslint-community/eslint-utils/-/eslint-utils-4.8.0.tgz",
-      "integrity": "sha512-dyybb3AcajC7uha6CvhdVRJqaKyn7w2YKqKyAN37NKYgZT36w+iRb0Dymmc5qEJ549c/S31cMMSFd75bteCpCw==",
+      "integrity": "sha512-MJQFqrZgcW0UNYLGOuQpey/oTN59vyWwplvCGZztn1cKz9agZPPYpJB7h2OMmuu7VLqkvEjN8feFZJmxNF9D+Q==",
       "dev": true,
       "license": "MIT",
       "dependencies": {
@@ -206,33 +217,19 @@
       }
     },
     "node_modules/@humanfs/node": {
-      "version": "0.16.6",
+      "version": "0.16.7",
-      "resolved": "https://registry.npmjs.org/@humanfs/node/-/node-0.16.6.tgz",
+      "resolved": "https://registry.npmjs.org/@humanfs/node/-/node-0.16.7.tgz",
-      "integrity": "sha512-YuI2ZHQL78Q5HbhDiBA1X4LmYdXCKCMQIfw0pw7piHJwyREFebJUvrQN4cMssyES6x+vfUbx1CIpaQUKYdQZOw==",
+      "integrity": "sha512-/zUx+yOsIrG4Y43Eh2peDeKCxlRt/gET6aHfaKpuq267qXdYDFViVHfMaLyygZOnl0kGWxFIgsBy8QFuTLUXEQ==",
       "dev": true,
       "license": "Apache-2.0",
       "dependencies": {
         "@humanfs/core": "^0.19.1",
-        "@humanwhocodes/retry": "^0.3.0"
+        "@humanwhocodes/retry": "^0.4.0"
       },
       "engines": {
         "node": ">=18.18.0"
       }
     },
-    "node_modules/@humanfs/node/node_modules/@humanwhocodes/retry": {
-      "version": "0.3.1",
-      "resolved": "https://registry.npmjs.org/@humanwhocodes/retry/-/retry-0.3.1.tgz",
-      "integrity": "sha512-JBxkERygn7Bv/GbN5Rv8Ul6LVknS+5Bp6RgDC/O8gEBU/yeH5Ui5C/OlWrTb6qct7LjjfT6Re2NxB0ln0yYybA==",
-      "dev": true,
-      "license": "Apache-2.0",
-      "engines": {
-        "node": ">=18.18"
-      },
-      "funding": {
-        "type": "github",
-        "url": "https://github.com/sponsors/nzakas"
-      }
-    },
     "node_modules/@humanwhocodes/module-importer": {
       "version": "1.0.1",
       "resolved": "https://registry.npmjs.org/@humanwhocodes/module-importer/-/module-importer-1.0.1.tgz",
@@ -261,6 +258,424 @@
         "url": "https://github.com/sponsors/nzakas"
       }
     },
+    "node_modules/@img/sharp-darwin-arm64": {
+      "version": "0.34.3",
+      "resolved": "https://registry.npmjs.org/@img/sharp-darwin-arm64/-/sharp-darwin-arm64-0.34.3.tgz",
+      "integrity": "sha512-ryFMfvxxpQRsgZJqBd4wsttYQbCxsJksrv9Lw/v798JcQ8+w84mBWuXwl+TT0WJ/WrYOLaYpwQXi3sA9nTIaIg==",
+      "cpu": [
+        "arm64"
+      ],
+      "license": "Apache-2.0",
+      "optional": true,
+      "os": [
+        "darwin"
+      ],
+      "engines": {
+        "node": "^18.17.0 || ^20.3.0 || >=21.0.0"
+      },
+      "funding": {
+        "url": "https://opencollective.com/libvips"
+      },
+      "optionalDependencies": {
+        "@img/sharp-libvips-darwin-arm64": "1.2.0"
+      }
+    },
+    "node_modules/@img/sharp-darwin-x64": {
+      "version": "0.34.3",
+      "resolved": "https://registry.npmjs.org/@img/sharp-darwin-x64/-/sharp-darwin-x64-0.34.3.tgz",
+      "integrity": "sha512-yHpJYynROAj12TA6qil58hmPmAwxKKC7reUqtGLzsOHfP7/rniNGTL8tjWX6L3CTV4+5P4ypcS7Pp+7OB+8ihA==",
+      "cpu": [
+        "x64"
+      ],
+      "license": "Apache-2.0",
+      "optional": true,
+      "os": [
+        "darwin"
+      ],
+      "engines": {
+        "node": "^18.17.0 || ^20.3.0 || >=21.0.0"
+      },
+      "funding": {
+        "url": "https://opencollective.com/libvips"
+      },
+      "optionalDependencies": {
+        "@img/sharp-libvips-darwin-x64": "1.2.0"
+      }
+    },
+    "node_modules/@img/sharp-libvips-darwin-arm64": {
+      "version": "1.2.0",
+      "resolved": "https://registry.npmjs.org/@img/sharp-libvips-darwin-arm64/-/sharp-libvips-darwin-arm64-1.2.0.tgz",
+      "integrity": "sha512-sBZmpwmxqwlqG9ueWFXtockhsxefaV6O84BMOrhtg/YqbTaRdqDE7hxraVE3y6gVM4eExmfzW4a8el9ArLeEiQ==",
+      "cpu": [
+        "arm64"
+      ],
+      "license": "LGPL-3.0-or-later",
+      "optional": true,
+      "os": [
+        "darwin"
+      ],
+      "funding": {
+        "url": "https://opencollective.com/libvips"
+      }
+    },
+    "node_modules/@img/sharp-libvips-darwin-x64": {
+      "version": "1.2.0",
+      "resolved": "https://registry.npmjs.org/@img/sharp-libvips-darwin-x64/-/sharp-libvips-darwin-x64-1.2.0.tgz",
+      "integrity": "sha512-M64XVuL94OgiNHa5/m2YvEQI5q2cl9d/wk0qFTDVXcYzi43lxuiFTftMR1tOnFQovVXNZJ5TURSDK2pNe9Yzqg==",
+      "cpu": [
+        "x64"
+      ],
+      "license": "LGPL-3.0-or-later",
+      "optional": true,
+      "os": [
+        "darwin"
+      ],
+      "funding": {
+        "url": "https://opencollective.com/libvips"
+      }
+    },
+    "node_modules/@img/sharp-libvips-linux-arm": {
+      "version": "1.2.0",
+      "resolved": "https://registry.npmjs.org/@img/sharp-libvips-linux-arm/-/sharp-libvips-linux-arm-1.2.0.tgz",
+      "integrity": "sha512-mWd2uWvDtL/nvIzThLq3fr2nnGfyr/XMXlq8ZJ9WMR6PXijHlC3ksp0IpuhK6bougvQrchUAfzRLnbsen0Cqvw==",
+      "cpu": [
+        "arm"
+      ],
+      "license": "LGPL-3.0-or-later",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "funding": {
+        "url": "https://opencollective.com/libvips"
+      }
+    },
+    "node_modules/@img/sharp-libvips-linux-arm64": {
+      "version": "1.2.0",
+      "resolved": "https://registry.npmjs.org/@img/sharp-libvips-linux-arm64/-/sharp-libvips-linux-arm64-1.2.0.tgz",
+      "integrity": "sha512-RXwd0CgG+uPRX5YYrkzKyalt2OJYRiJQ8ED/fi1tq9WQW2jsQIn0tqrlR5l5dr/rjqq6AHAxURhj2DVjyQWSOA==",
+      "cpu": [
+        "arm64"
+      ],
+      "license": "LGPL-3.0-or-later",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "funding": {
+        "url": "https://opencollective.com/libvips"
+      }
+    },
+    "node_modules/@img/sharp-libvips-linux-ppc64": {
+      "version": "1.2.0",
+      "resolved": "https://registry.npmjs.org/@img/sharp-libvips-linux-ppc64/-/sharp-libvips-linux-ppc64-1.2.0.tgz",
+      "integrity": "sha512-Xod/7KaDDHkYu2phxxfeEPXfVXFKx70EAFZ0qyUdOjCcxbjqyJOEUpDe6RIyaunGxT34Anf9ue/wuWOqBW2WcQ==",
+      "cpu": [
+        "ppc64"
+      ],
+      "license": "LGPL-3.0-or-later",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "funding": {
+        "url": "https://opencollective.com/libvips"
+      }
+    },
+    "node_modules/@img/sharp-libvips-linux-s390x": {
+      "version": "1.2.0",
+      "resolved": "https://registry.npmjs.org/@img/sharp-libvips-linux-s390x/-/sharp-libvips-linux-s390x-1.2.0.tgz",
+      "integrity": "sha512-eMKfzDxLGT8mnmPJTNMcjfO33fLiTDsrMlUVcp6b96ETbnJmd4uvZxVJSKPQfS+odwfVaGifhsB07J1LynFehw==",
+      "cpu": [
+        "s390x"
+      ],
+      "license": "LGPL-3.0-or-later",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "funding": {
+        "url": "https://opencollective.com/libvips"
+      }
+    },
+    "node_modules/@img/sharp-libvips-linux-x64": {
+      "version": "1.2.0",
+      "resolved": "https://registry.npmjs.org/@img/sharp-libvips-linux-x64/-/sharp-libvips-linux-x64-1.2.0.tgz",
+      "integrity": "sha512-ZW3FPWIc7K1sH9E3nxIGB3y3dZkpJlMnkk7z5tu1nSkBoCgw2nSRTFHI5pB/3CQaJM0pdzMF3paf9ckKMSE9Tg==",
+      "cpu": [
+        "x64"
+      ],
+      "license": "LGPL-3.0-or-later",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "funding": {
+        "url": "https://opencollective.com/libvips"
+      }
+    },
+    "node_modules/@img/sharp-libvips-linuxmusl-arm64": {
+      "version": "1.2.0",
+      "resolved": "https://registry.npmjs.org/@img/sharp-libvips-linuxmusl-arm64/-/sharp-libvips-linuxmusl-arm64-1.2.0.tgz",
+      "integrity": "sha512-UG+LqQJbf5VJ8NWJ5Z3tdIe/HXjuIdo4JeVNADXBFuG7z9zjoegpzzGIyV5zQKi4zaJjnAd2+g2nna8TZvuW9Q==",
+      "cpu": [
+        "arm64"
+      ],
+      "license": "LGPL-3.0-or-later",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "funding": {
+        "url": "https://opencollective.com/libvips"
+      }
+    },
+    "node_modules/@img/sharp-libvips-linuxmusl-x64": {
+      "version": "1.2.0",
+      "resolved": "https://registry.npmjs.org/@img/sharp-libvips-linuxmusl-x64/-/sharp-libvips-linuxmusl-x64-1.2.0.tgz",
+      "integrity": "sha512-SRYOLR7CXPgNze8akZwjoGBoN1ThNZoqpOgfnOxmWsklTGVfJiGJoC/Lod7aNMGA1jSsKWM1+HRX43OP6p9+6Q==",
+      "cpu": [
+        "x64"
+      ],
+      "license": "LGPL-3.0-or-later",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "funding": {
+        "url": "https://opencollective.com/libvips"
+      }
+    },
+    "node_modules/@img/sharp-linux-arm": {
+      "version": "0.34.3",
+      "resolved": "https://registry.npmjs.org/@img/sharp-linux-arm/-/sharp-linux-arm-0.34.3.tgz",
+      "integrity": "sha512-oBK9l+h6KBN0i3dC8rYntLiVfW8D8wH+NPNT3O/WBHeW0OQWCjfWksLUaPidsrDKpJgXp3G3/hkmhptAW0I3+A==",
+      "cpu": [
+        "arm"
+      ],
+      "license": "Apache-2.0",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": "^18.17.0 || ^20.3.0 || >=21.0.0"
+      },
+      "funding": {
+        "url": "https://opencollective.com/libvips"
+      },
+      "optionalDependencies": {
+        "@img/sharp-libvips-linux-arm": "1.2.0"
+      }
+    },
+    "node_modules/@img/sharp-linux-arm64": {
+      "version": "0.34.3",
+      "resolved": "https://registry.npmjs.org/@img/sharp-linux-arm64/-/sharp-linux-arm64-0.34.3.tgz",
+      "integrity": "sha512-QdrKe3EvQrqwkDrtuTIjI0bu6YEJHTgEeqdzI3uWJOH6G1O8Nl1iEeVYRGdj1h5I21CqxSvQp1Yv7xeU3ZewbA==",
+      "cpu": [
+        "arm64"
+      ],
+      "license": "Apache-2.0",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": "^18.17.0 || ^20.3.0 || >=21.0.0"
+      },
+      "funding": {
+        "url": "https://opencollective.com/libvips"
+      },
+      "optionalDependencies": {
+        "@img/sharp-libvips-linux-arm64": "1.2.0"
+      }
+    },
+    "node_modules/@img/sharp-linux-ppc64": {
+      "version": "0.34.3",
+      "resolved": "https://registry.npmjs.org/@img/sharp-linux-ppc64/-/sharp-linux-ppc64-0.34.3.tgz",
+      "integrity": "sha512-GLtbLQMCNC5nxuImPR2+RgrviwKwVql28FWZIW1zWruy6zLgA5/x2ZXk3mxj58X/tszVF69KK0Is83V8YgWhLA==",
+      "cpu": [
+        "ppc64"
+      ],
+      "license": "Apache-2.0",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": "^18.17.0 || ^20.3.0 || >=21.0.0"
+      },
+      "funding": {
+        "url": "https://opencollective.com/libvips"
+      },
+      "optionalDependencies": {
+        "@img/sharp-libvips-linux-ppc64": "1.2.0"
+      }
+    },
+    "node_modules/@img/sharp-linux-s390x": {
+      "version": "0.34.3",
+      "resolved": "https://registry.npmjs.org/@img/sharp-linux-s390x/-/sharp-linux-s390x-0.34.3.tgz",
+      "integrity": "sha512-3gahT+A6c4cdc2edhsLHmIOXMb17ltffJlxR0aC2VPZfwKoTGZec6u5GrFgdR7ciJSsHT27BD3TIuGcuRT0KmQ==",
+      "cpu": [
+        "s390x"
+      ],
+      "license": "Apache-2.0",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": "^18.17.0 || ^20.3.0 || >=21.0.0"
+      },
+      "funding": {
+        "url": "https://opencollective.com/libvips"
+      },
+      "optionalDependencies": {
+        "@img/sharp-libvips-linux-s390x": "1.2.0"
+      }
+    },
+    "node_modules/@img/sharp-linux-x64": {
+      "version": "0.34.3",
+      "resolved": "https://registry.npmjs.org/@img/sharp-linux-x64/-/sharp-linux-x64-0.34.3.tgz",
+      "integrity": "sha512-8kYso8d806ypnSq3/Ly0QEw90V5ZoHh10yH0HnrzOCr6DKAPI6QVHvwleqMkVQ0m+fc7EH8ah0BB0QPuWY6zJQ==",
+      "cpu": [
+        "x64"
+      ],
+      "license": "Apache-2.0",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": "^18.17.0 || ^20.3.0 || >=21.0.0"
+      },
+      "funding": {
+        "url": "https://opencollective.com/libvips"
+      },
+      "optionalDependencies": {
+        "@img/sharp-libvips-linux-x64": "1.2.0"
+      }
+    },
+    "node_modules/@img/sharp-linuxmusl-arm64": {
+      "version": "0.34.3",
+      "resolved": "https://registry.npmjs.org/@img/sharp-linuxmusl-arm64/-/sharp-linuxmusl-arm64-0.34.3.tgz",
+      "integrity": "sha512-vAjbHDlr4izEiXM1OTggpCcPg9tn4YriK5vAjowJsHwdBIdx0fYRsURkxLG2RLm9gyBq66gwtWI8Gx0/ov+JKQ==",
+      "cpu": [
+        "arm64"
+      ],
+      "license": "Apache-2.0",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": "^18.17.0 || ^20.3.0 || >=21.0.0"
+      },
+      "funding": {
+        "url": "https://opencollective.com/libvips"
+      },
+      "optionalDependencies": {
+        "@img/sharp-libvips-linuxmusl-arm64": "1.2.0"
+      }
+    },
+    "node_modules/@img/sharp-linuxmusl-x64": {
+      "version": "0.34.3",
+      "resolved": "https://registry.npmjs.org/@img/sharp-linuxmusl-x64/-/sharp-linuxmusl-x64-0.34.3.tgz",
+      "integrity": "sha512-gCWUn9547K5bwvOn9l5XGAEjVTTRji4aPTqLzGXHvIr6bIDZKNTA34seMPgM0WmSf+RYBH411VavCejp3PkOeQ==",
+      "cpu": [
+        "x64"
+      ],
+      "license": "Apache-2.0",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": "^18.17.0 || ^20.3.0 || >=21.0.0"
+      },
+      "funding": {
+        "url": "https://opencollective.com/libvips"
+      },
+      "optionalDependencies": {
+        "@img/sharp-libvips-linuxmusl-x64": "1.2.0"
+      }
+    },
+    "node_modules/@img/sharp-wasm32": {
+      "version": "0.34.3",
+      "resolved": "https://registry.npmjs.org/@img/sharp-wasm32/-/sharp-wasm32-0.34.3.tgz",
+      "integrity": "sha512-+CyRcpagHMGteySaWos8IbnXcHgfDn7pO2fiC2slJxvNq9gDipYBN42/RagzctVRKgxATmfqOSulgZv5e1RdMg==",
+      "cpu": [
+        "wasm32"
+      ],
+      "license": "Apache-2.0 AND LGPL-3.0-or-later AND MIT",
+      "optional": true,
+      "dependencies": {
+        "@emnapi/runtime": "^1.4.4"
+      },
+      "engines": {
+        "node": "^18.17.0 || ^20.3.0 || >=21.0.0"
+      },
+      "funding": {
+        "url": "https://opencollective.com/libvips"
+      }
+    },
+    "node_modules/@img/sharp-win32-arm64": {
+      "version": "0.34.3",
+      "resolved": "https://registry.npmjs.org/@img/sharp-win32-arm64/-/sharp-win32-arm64-0.34.3.tgz",
+      "integrity": "sha512-MjnHPnbqMXNC2UgeLJtX4XqoVHHlZNd+nPt1kRPmj63wURegwBhZlApELdtxM2OIZDRv/DFtLcNhVbd1z8GYXQ==",
+      "cpu": [
+        "arm64"
+      ],
+      "license": "Apache-2.0 AND LGPL-3.0-or-later",
+      "optional": true,
+      "os": [
+        "win32"
+      ],
+      "engines": {
+        "node": "^18.17.0 || ^20.3.0 || >=21.0.0"
+      },
+      "funding": {
+        "url": "https://opencollective.com/libvips"
+      }
+    },
+    "node_modules/@img/sharp-win32-ia32": {
+      "version": "0.34.3",
+      "resolved": "https://registry.npmjs.org/@img/sharp-win32-ia32/-/sharp-win32-ia32-0.34.3.tgz",
+      "integrity": "sha512-xuCdhH44WxuXgOM714hn4amodJMZl3OEvf0GVTm0BEyMeA2to+8HEdRPShH0SLYptJY1uBw+SCFP9WVQi1Q/cw==",
+      "cpu": [
+        "ia32"
+      ],
+      "license": "Apache-2.0 AND LGPL-3.0-or-later",
+      "optional": true,
+      "os": [
+        "win32"
+      ],
+      "engines": {
+        "node": "^18.17.0 || ^20.3.0 || >=21.0.0"
+      },
+      "funding": {
+        "url": "https://opencollective.com/libvips"
+      }
+    },
+    "node_modules/@img/sharp-win32-x64": {
+      "version": "0.34.3",
+      "resolved": "https://registry.npmjs.org/@img/sharp-win32-x64/-/sharp-win32-x64-0.34.3.tgz",
+      "integrity": "sha512-OWwz05d++TxzLEv4VnsTz5CmZ6mI6S05sfQGEMrNrQcOEERbX46332IvE7pO/EUiw7jUrrS40z/M7kPyjfl04g==",
+      "cpu": [
+        "x64"
+      ],
+      "license": "Apache-2.0 AND LGPL-3.0-or-later",
+      "optional": true,
+      "os": [
+        "win32"
+      ],
+      "engines": {
+        "node": "^18.17.0 || ^20.3.0 || >=21.0.0"
+      },
+      "funding": {
+        "url": "https://opencollective.com/libvips"
+      }
+    },
     "node_modules/@puppeteer/browsers": {
       "version": "2.10.8",
       "resolved": "https://registry.npmjs.org/@puppeteer/browsers/-/browsers-2.10.8.tgz",
@@ -434,9 +849,9 @@
       "optional": true
     },
     "node_modules/bare-fs": {
-      "version": "4.2.1",
+      "version": "4.2.3",
-      "resolved": "https://registry.npmjs.org/bare-fs/-/bare-fs-4.2.1.tgz",
+      "resolved": "https://registry.npmjs.org/bare-fs/-/bare-fs-4.2.3.tgz",
-      "integrity": "sha512-mELROzV0IhqilFgsl1gyp48pnZsaV9xhQapHLDsvn4d4ZTfbFhcghQezl7FTEDNBcGqLUnNI3lUlm6ecrLWdFA==",
+      "integrity": "sha512-1aGs5pRVLToMQ79elP+7cc0u0s/wXAzfBv/7hDloT7WFggLqECCas5qqPky7WHCFdsBH5WDq6sD4fAoz5sJbtA==",
       "license": "Apache-2.0",
       "optional": true,
       "dependencies": {
@@ -580,6 +995,19 @@
         "node": ">=12"
       }
     },
+    "node_modules/color": {
+      "version": "4.2.3",
+      "resolved": "https://registry.npmjs.org/color/-/color-4.2.3.tgz",
+      "integrity": "sha512-1rXeuUUiGGrykh+CeBdu5Ie7OJwinCgQY0bc7GCRxy5xVHy+moaqkpL/jqQq0MtQOeYcrqEz4abc5f0KtU7W4A==",
+      "license": "MIT",
+      "dependencies": {
+        "color-convert": "^2.0.1",
+        "color-string": "^1.9.0"
+      },
+      "engines": {
+        "node": ">=12.5.0"
+      }
+    },
     "node_modules/color-convert": {
       "version": "2.0.1",
       "resolved": "https://registry.npmjs.org/color-convert/-/color-convert-2.0.1.tgz",
@@ -598,6 +1026,16 @@
       "integrity": "sha512-dOy+3AuW3a2wNbZHIuMZpTcgjGuLU/uBL/ubcZF9OXbDo8ff4O8yVp5Bf0efS8uEoYo5q4Fx7dY9OgQGXgAsQA==",
       "license": "MIT"
     },
+    "node_modules/color-string": {
+      "version": "1.9.1",
+      "resolved": "https://registry.npmjs.org/color-string/-/color-string-1.9.1.tgz",
+      "integrity": "sha512-shrVawQFojnZv6xM40anx4CkoDP+fZsw/ZerEMsW/pyzsRbElpsL/DBVW7q3ExxwusdNXI3lXpuhEZkzs8p5Eg==",
+      "license": "MIT",
+      "dependencies": {
+        "color-name": "^1.0.0",
+        "simple-swizzle": "^0.2.2"
+      }
+    },
     "node_modules/concat-map": {
       "version": "0.0.1",
       "resolved": "https://registry.npmjs.org/concat-map/-/concat-map-0.0.1.tgz",
@@ -693,6 +1131,15 @@
         "node": ">= 14"
       }
     },
+    "node_modules/detect-libc": {
+      "version": "2.0.4",
+      "resolved": "https://registry.npmjs.org/detect-libc/-/detect-libc-2.0.4.tgz",
+      "integrity": "sha512-3UDv+G9CsCKO1WKMGw9fwq/SWJYbI0c5Y7LU1AXYoDdbhE2AHQ6N6Nb34sG8Fj7T5APy8qXDCKuuIHd1BR0tVA==",
+      "license": "Apache-2.0",
+      "engines": {
+        "node": ">=8"
+      }
+    },
     "node_modules/devtools-protocol": {
       "version": "0.0.1475386",
       "resolved": "https://registry.npmjs.org/devtools-protocol/-/devtools-protocol-0.0.1475386.tgz",
@@ -700,9 +1147,9 @@
       "license": "BSD-3-Clause"
     },
     "node_modules/dotenv": {
-      "version": "17.2.1",
+      "version": "17.2.2",
-      "resolved": "https://registry.npmjs.org/dotenv/-/dotenv-17.2.1.tgz",
+      "resolved": "https://registry.npmjs.org/dotenv/-/dotenv-17.2.2.tgz",
-      "integrity": "sha512-kQhDYKZecqnM0fCnzI5eIv5L4cAe/iRI+HqMbO/hbRdTAeXDG+M9FjipUxNfbARuEg4iHIbhnhs78BCHNbSxEQ==",
+      "integrity": "sha512-Sf2LSQP+bOlhKWWyhFsn0UsfdK/kCWRv1iuA2gXAwt3dyNabr6QSj00I2V10pidqz69soatm9ZwZvpQMTIOd5Q==",
       "license": "BSD-2-Clause",
       "engines": {
         "node": ">=12"
@@ -1616,9 +2063,9 @@
       }
     },
     "node_modules/puppeteer": {
-      "version": "24.17.1",
+      "version": "24.18.0",
-      "resolved": "https://registry.npmjs.org/puppeteer/-/puppeteer-24.17.1.tgz",
+      "resolved": "https://registry.npmjs.org/puppeteer/-/puppeteer-24.18.0.tgz",
-      "integrity": "sha512-KIuX0w+0um4TUbm55yFl2WIsbgjya2BHIgW9ylTuhavtwjXCOM7lMo9oLR1jQnCxrFvm9h/Yeb+zfs4nlgntPg==",
+      "integrity": "sha512-Ke8oL/87GhzKIM2Ag6Yj49t5xbGc4rspGIuSuFLFCQBtYzWqCSanvqoCu08WkI78rbqcwnHjxiTH6oDlYFrjrw==",
       "hasInstallScript": true,
       "license": "Apache-2.0",
       "dependencies": {
@@ -1626,7 +2073,7 @@
         "chromium-bidi": "8.0.0",
         "cosmiconfig": "^9.0.0",
         "devtools-protocol": "0.0.1475386",
-        "puppeteer-core": "24.17.1",
+        "puppeteer-core": "24.18.0",
         "typed-query-selector": "^2.12.0"
       },
       "bin": {
@@ -1637,9 +2084,9 @@
       }
     },
     "node_modules/puppeteer-core": {
-      "version": "24.17.1",
+      "version": "24.18.0",
-      "resolved": "https://registry.npmjs.org/puppeteer-core/-/puppeteer-core-24.17.1.tgz",
+      "resolved": "https://registry.npmjs.org/puppeteer-core/-/puppeteer-core-24.18.0.tgz",
-      "integrity": "sha512-Msh/kf9k1XFN0wuKiT4/npMmMWOT7kPBEUw01gWvRoKOOoz3It9TEmWjnt4Gl4eO+p73VMrvR+wfa0dm9rfxjw==",
+      "integrity": "sha512-As0BvfXxek2MbV0m7iqBmQKFnfSrzSvTM4zGipjd4cL+9f2Ccgut6RvHlc8+qBieKHqCMFy9BSI4QyveoYXTug==",
       "license": "Apache-2.0",
       "dependencies": {
         "@puppeteer/browsers": "2.10.8",
@@ -1683,6 +2130,48 @@
         "node": ">=10"
       }
     },
+    "node_modules/sharp": {
+      "version": "0.34.3",
+      "resolved": "https://registry.npmjs.org/sharp/-/sharp-0.34.3.tgz",
+      "integrity": "sha512-eX2IQ6nFohW4DbvHIOLRB3MHFpYqaqvXd3Tp5e/T/dSH83fxaNJQRvDMhASmkNTsNTVF2/OOopzRCt7xokgPfg==",
+      "hasInstallScript": true,
+      "license": "Apache-2.0",
+      "dependencies": {
+        "color": "^4.2.3",
+        "detect-libc": "^2.0.4",
+        "semver": "^7.7.2"
+      },
+      "engines": {
+        "node": "^18.17.0 || ^20.3.0 || >=21.0.0"
+      },
+      "funding": {
+        "url": "https://opencollective.com/libvips"
+      },
+      "optionalDependencies": {
+        "@img/sharp-darwin-arm64": "0.34.3",
+        "@img/sharp-darwin-x64": "0.34.3",
+        "@img/sharp-libvips-darwin-arm64": "1.2.0",
+        "@img/sharp-libvips-darwin-x64": "1.2.0",
+        "@img/sharp-libvips-linux-arm": "1.2.0",
+        "@img/sharp-libvips-linux-arm64": "1.2.0",
+        "@img/sharp-libvips-linux-ppc64": "1.2.0",
+        "@img/sharp-libvips-linux-s390x": "1.2.0",
+        "@img/sharp-libvips-linux-x64": "1.2.0",
+        "@img/sharp-libvips-linuxmusl-arm64": "1.2.0",
+        "@img/sharp-libvips-linuxmusl-x64": "1.2.0",
+        "@img/sharp-linux-arm": "0.34.3",
+        "@img/sharp-linux-arm64": "0.34.3",
+        "@img/sharp-linux-ppc64": "0.34.3",
+        "@img/sharp-linux-s390x": "0.34.3",
+        "@img/sharp-linux-x64": "0.34.3",
+        "@img/sharp-linuxmusl-arm64": "0.34.3",
+        "@img/sharp-linuxmusl-x64": "0.34.3",
+        "@img/sharp-wasm32": "0.34.3",
+        "@img/sharp-win32-arm64": "0.34.3",
+        "@img/sharp-win32-ia32": "0.34.3",
+        "@img/sharp-win32-x64": "0.34.3"
+      }
+    },
     "node_modules/shebang-command": {
       "version": "2.0.0",
       "resolved": "https://registry.npmjs.org/shebang-command/-/shebang-command-2.0.0.tgz",
@@ -1706,6 +2195,21 @@
         "node": ">=8"
       }
     },
+    "node_modules/simple-swizzle": {
+      "version": "0.2.2",
+      "resolved": "https://registry.npmjs.org/simple-swizzle/-/simple-swizzle-0.2.2.tgz",
+      "integrity": "sha512-JA//kQgZtbuY83m+xT+tXJkmJncGMTFT+C+g2h2R9uxkYIrE2yy9sgmcLhCnw57/WSD+Eh3J97FPEDFnbXnDUg==",
+      "license": "MIT",
+      "dependencies": {
+        "is-arrayish": "^0.3.1"
+      }
+    },
+    "node_modules/simple-swizzle/node_modules/is-arrayish": {
+      "version": "0.3.2",
+      "resolved": "https://registry.npmjs.org/is-arrayish/-/is-arrayish-0.3.2.tgz",
+      "integrity": "sha512-eVRqCvVlZbuw3GrM63ovNSNAeA1K16kaR/LRY/92w0zxQ5/1YzwblUX652i4Xs9RwAGjW9d9y6X88t8OaAJfWQ==",
+      "license": "MIT"
+    },
     "node_modules/smart-buffer": {
       "version": "4.2.0",
       "resolved": "https://registry.npmjs.org/smart-buffer/-/smart-buffer-4.2.0.tgz",

package.json

@@ -13,7 +13,8 @@
   "description": "",
   "dependencies": {
     "dotenv": "^17.2.1",
-    "puppeteer": "^24.17.1"
+    "puppeteer": "^24.17.1",
+    "sharp": "^0.34.3"
   },
   "devDependencies": {
     "@eslint/js": "^9.34.0",