cyclops-infobook-html 5.1.0 → 5.2.0

package/lib/icon/IconsCompressor.js

@@ -1,4 +1,37 @@
 "use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
 var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
     function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
     return new (P || (P = Promise))(function (resolve, reject) {
@@ -10,11 +43,11 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.IconsCompressor = void 0;
-const child_process_1 = require("child_process");
-const fs = require("fs");
-const path_1 = require("path");
-const util_1 = require("util");
-const execFileAsync = (0, util_1.promisify)(child_process_1.execFile);
+const node_child_process_1 = require("node:child_process");
+const fs = __importStar(require("node:fs"));
+const node_path_1 = require("node:path");
+const node_util_1 = require("node:util");
+const execFileAsync = (0, node_util_1.promisify)(node_child_process_1.execFile);
 /**
  * Losslessly compresses PNG icon files using OptiPNG.
  * Mimics how ImgBot compresses images: lossless PNG compression at optimization level 7
@@ -37,7 +70,7 @@ class IconsCompressor {
                 throw new Error(`OptiPNG binary not found at: ${optipngPath}. Ensure optipng-bin is installed.`);
             }
             const files = yield fs.promises.readdir(this.iconsDir);
-            const pngFiles = files.filter((f) => f.endsWith('.png'));
+            const pngFiles = files.filter(f => f.endsWith('.png'));
             if (pngFiles.length === 0) {
                 process.stdout.write(`No PNG files found in ${this.iconsDir}\n`);
                 return;
@@ -47,7 +80,7 @@ class IconsCompressor {
             let errors = 0;
             let totalSavedBytes = 0;
             for (const file of pngFiles) {
-                const filePath = (0, path_1.join)(this.iconsDir, file);
+                const filePath = (0, node_path_1.join)(this.iconsDir, file);
                 const sizeBefore = fs.statSync(filePath).size;
                 try {
                     yield execFileAsync(optipngPath, ['-o7', '-strip', 'all', '-quiet', filePath]);
@@ -61,9 +94,7 @@ class IconsCompressor {
                 }
             }
             const savedKb = (totalSavedBytes / 1024).toFixed(1);
-            process.stdout.write(`Compressed ${compressed} icons (saved ${savedKb} KB)` +
-                (errors > 0 ? `, ${errors} errors` : '') +
-                `\n`);
+            process.stdout.write(`Compressed ${compressed} icons (saved ${savedKb} KB)${errors > 0 ? `, ${errors} errors` : ''}\n`);
         });
     }
     /**
@@ -72,9 +103,9 @@ class IconsCompressor {
      */
     getOptipngPath() {
         const indexPath = require.resolve('optipng-bin');
-        const pkgRoot = (0, path_1.dirname)(indexPath);
+        const pkgRoot = (0, node_path_1.dirname)(indexPath);
         const binaryName = process.platform === 'win32' ? 'optipng.exe' : 'optipng';
-        return (0, path_1.join)(pkgRoot, 'vendor', binaryName);
+        return (0, node_path_1.join)(pkgRoot, 'vendor', binaryName);
     }
 }
 exports.IconsCompressor = IconsCompressor;

package/lib/icon/IconsGenerator.d.ts

@@ -5,20 +5,20 @@
  * runs the iconexporter export command, and copies the resulting icons.
  */
 export declare class IconsGenerator {
-    private static readonly HEADLESSMC_JAR;
-    private static readonly ICONEXPORTER_JAR;
-    private static readonly HMC_GAME_SUBDIR;
-    private static readonly HMC_CONFIG_SUBDIR;
-    private static readonly ICON_EXPORT_SUBDIR;
-    private static readonly DEFAULT_ICON_SIZE;
-    private static readonly HMC_SPECIFICS_REPO;
+    private static readonly headlessMcJar;
+    private static readonly iconExporterJar;
+    private static readonly hmcGameSubdir;
+    private static readonly hmcConfigSubdir;
+    private static readonly iconExportSubdir;
+    private static readonly defaultIconSize;
+    private static readonly hmcSpecificsRepo;
+    private static readonly modrinthApiBase;
+    private static readonly iconExporterModrinthSlug;
     private readonly modsDir;
     private readonly iconsDir;
     private readonly workDir;
     private readonly minecraftVersion;
     private readonly neoforgeVersion;
-    private readonly githubToken;
-    private readonly iconExporterArtifact;
     private readonly iconExporterVersion;
     private readonly headlessMcVersion;
     private readonly launchTimeoutMs;
@@ -32,9 +32,21 @@ export declare class IconsGenerator {
      */
     downloadHeadlessMc(): Promise<void>;
     /**
-     * Download the IconExporter mod from GitHub Maven packages.
+     * Download the IconExporter mod from Modrinth.
+     * If an explicit version is configured, fetches that specific version; otherwise fetches the
+     * latest version for the configured Minecraft version. No authentication is required.
      */
     downloadIconExporter(): Promise<void>;
+    /**
+     * Fetch an IconExporter release from Modrinth for the configured Minecraft version and the
+     * NeoForge loader. If a specific version number is provided, that version is matched;
+     * otherwise the latest (newest) version is returned.
+     * Returns the primary file's download URL and filename.
+     */
+    fetchIconExporterFromModrinth(version?: string): Promise<{
+        url: string;
+        filename: string;
+    }>;
     /**
      * Set up the game directory with mods and options.
      */
@@ -83,6 +95,23 @@ export declare class IconsGenerator {
     downloadFile(url: string, destPath: string, headers?: Record<string, string>): Promise<void>;
 }
 export type IGameState = 'waiting_for_prompt' | 'game_launching' | 'checking_screen' | 'navigating_singleplayer' | 'creating_world' | 'exporting_icons' | 'quitting';
+export interface IModrinthVersionFile {
+    url: string;
+    filename: string;
+    primary: boolean;
+}
+export interface IModrinthVersion {
+    version_number: string;
+    files: IModrinthVersionFile[];
+}
+export interface IGithubAsset {
+    name: string;
+    browser_download_url: string;
+}
+export interface IGithubRelease {
+    assets: IGithubAsset[];
+    tag_name: string;
+}
 export interface IIconsGeneratorArgs {
     /**
      * Directory containing mod JARs to include in the client (usually server/mods).
@@ -105,16 +134,9 @@ export interface IIconsGeneratorArgs {
      */
     neoforgeVersion: string;
     /**
-     * GitHub token for downloading from GitHub Packages.
-     * Falls back to GITHUB_TOKEN environment variable.
-     */
-    githubToken?: string;
-    /**
-     * Maven artifact ID for IconExporter (default: iconexporter-{minecraftVersion}-neoforge).
-     */
-    iconExporterArtifact?: string;
-    /**
-     * Version of the IconExporter artifact to download (e.g., "1.4.0-174").
+     * Version of the IconExporter artifact to pin (e.g., "1.4.0-174").
+     * If not provided, the latest version for the configured Minecraft version is
+     * automatically fetched from Modrinth (no authentication required).
      */
     iconExporterVersion?: string;
     /**

package/lib/icon/IconsGenerator.js

@@ -1,4 +1,37 @@
 "use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
 var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
     function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
     return new (P || (P = Promise))(function (resolve, reject) {
@@ -8,13 +41,16 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
         step((generator = generator.apply(thisArg, _arguments || [])).next());
     });
 };
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.IconsGenerator = void 0;
-/* tslint:disable:ter-indent */
-const child_process_1 = require("child_process");
-const fs = require("fs");
-const node_fetch_1 = require("node-fetch");
-const path_1 = require("path");
+/* Tslint:disable:ter-indent */
+const node_child_process_1 = require("node:child_process");
+const fs = __importStar(require("node:fs"));
+const node_path_1 = require("node:path");
+const node_fetch_1 = __importDefault(require("node-fetch"));
 /**
  * Generates icons using the IconExporter mod and HeadlessMC.
  * This class downloads HeadlessMC and the IconExporter mod, sets up a headless
@@ -40,11 +76,10 @@ class IconsGenerator {
         this.workDir = args.workDir;
         this.minecraftVersion = args.minecraftVersion;
         this.neoforgeVersion = args.neoforgeVersion;
-        this.githubToken = args.githubToken || process.env.GITHUB_TOKEN || '';
-        this.iconExporterArtifact = args.iconExporterArtifact || `iconexporter-${args.minecraftVersion}-neoforge`;
-        this.iconExporterVersion = args.iconExporterVersion || '1.4.0-174';
+        this.iconExporterVersion = args.iconExporterVersion;
         this.headlessMcVersion = args.headlessMcVersion || '2.8.0';
-        this.launchTimeoutMs = args.launchTimeoutMs || (15 * 60 * 1000); // 15 minutes
+        // 15 minutes
+        this.launchTimeoutMs = args.launchTimeoutMs || (15 * 60 * 1000);
     }
     /**
      * Run the full icon generation pipeline.
@@ -74,7 +109,7 @@ class IconsGenerator {
      */
     downloadHeadlessMc() {
         return __awaiter(this, void 0, void 0, function* () {
-            const jarPath = (0, path_1.join)(this.workDir, IconsGenerator.HEADLESSMC_JAR);
+            const jarPath = (0, node_path_1.join)(this.workDir, IconsGenerator.headlessMcJar);
             if (fs.existsSync(jarPath)) {
                 process.stdout.write('HeadlessMC already downloaded, skipping.\n');
                 return;
@@ -85,32 +120,78 @@ class IconsGenerator {
         });
     }
     /**
-     * Download the IconExporter mod from GitHub Maven packages.
+     * Download the IconExporter mod from Modrinth.
+     * If an explicit version is configured, fetches that specific version; otherwise fetches the
+     * latest version for the configured Minecraft version. No authentication is required.
      */
     downloadIconExporter() {
         return __awaiter(this, void 0, void 0, function* () {
-            const jarPath = (0, path_1.join)(this.workDir, IconsGenerator.ICONEXPORTER_JAR);
+            const jarPath = (0, node_path_1.join)(this.workDir, IconsGenerator.iconExporterJar);
             if (fs.existsSync(jarPath)) {
                 process.stdout.write('IconExporter already downloaded, skipping.\n');
                 return;
             }
-            const groupPath = 'org/cyclops/iconexporter';
-            const url = `https://maven.pkg.github.com/CyclopsMC/packages/${groupPath}/${this.iconExporterArtifact}/${this.iconExporterVersion}/${this.iconExporterArtifact}-${this.iconExporterVersion}.jar`;
-            const headers = {};
-            if (this.githubToken) {
-                headers.Authorization = `token ${this.githubToken}`;
+            if (this.iconExporterVersion) {
+                process.stdout.write(`Fetching IconExporter ${this.iconExporterVersion} for Minecraft ${this.minecraftVersion} from Modrinth...\n`);
+            }
+            else {
+                process.stdout.write(`Fetching latest IconExporter version for Minecraft ${this.minecraftVersion} from Modrinth...\n`);
             }
-            yield this.downloadFile(url, jarPath, headers);
+            const { url: downloadUrl, filename } = yield this.fetchIconExporterFromModrinth(this.iconExporterVersion);
+            process.stdout.write(`Found IconExporter: ${filename}\n`);
+            yield this.downloadFile(downloadUrl, jarPath);
             process.stdout.write(`Downloaded IconExporter to ${jarPath}\n`);
         });
     }
+    /**
+     * Fetch an IconExporter release from Modrinth for the configured Minecraft version and the
+     * NeoForge loader. If a specific version number is provided, that version is matched;
+     * otherwise the latest (newest) version is returned.
+     * Returns the primary file's download URL and filename.
+     */
+    fetchIconExporterFromModrinth(version) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const gameVersions = JSON.stringify([this.minecraftVersion]);
+            const loaders = JSON.stringify(['neoforge']);
+            const apiUrl = `${IconsGenerator.modrinthApiBase}/project/${IconsGenerator.iconExporterModrinthSlug}/version` +
+                `?game_versions=${encodeURIComponent(gameVersions)}&loaders=${encodeURIComponent(loaders)}`;
+            const response = yield (0, node_fetch_1.default)(apiUrl);
+            if (!response.ok) {
+                throw new Error(`Failed to fetch IconExporter versions from Modrinth: ${response.status} ${response.statusText}`);
+            }
+            const versions = yield response.json();
+            if (!versions || versions.length === 0) {
+                throw new Error(`No IconExporter versions found on Modrinth for Minecraft ${this.minecraftVersion} with NeoForge`);
+            }
+            let matched;
+            if (version) {
+                // Modrinth version_number is typically "{mcVersion}-{modVersion}" (e.g. "1.21.1-1.4.0-174").
+                // Match either an exact version_number or the canonical "<mcVersion>-<version>" form.
+                const canonicalVersionNumber = `${this.minecraftVersion}-${version}`;
+                const found = versions.find(v => v.version_number === version || v.version_number === canonicalVersionNumber);
+                if (!found) {
+                    throw new Error(`IconExporter version "${version}" not found on Modrinth for Minecraft ${this.minecraftVersion} with NeoForge`);
+                }
+                matched = found;
+            }
+            else {
+                // Modrinth returns versions newest-first
+                matched = versions[0];
+            }
+            const primaryFile = matched.files.find(f => f.primary) || matched.files[0];
+            if (!primaryFile) {
+                throw new Error(`No files found for IconExporter version ${matched.version_number}`);
+            }
+            return { url: primaryFile.url, filename: primaryFile.filename };
+        });
+    }
     /**
      * Set up the game directory with mods and options.
      */
     setupGameDirectory() {
         return __awaiter(this, void 0, void 0, function* () {
-            const gameDir = (0, path_1.join)(this.workDir, IconsGenerator.HMC_GAME_SUBDIR);
-            const modsDir = (0, path_1.join)(gameDir, 'mods');
+            const gameDir = (0, node_path_1.join)(this.workDir, IconsGenerator.hmcGameSubdir);
+            const modsDir = (0, node_path_1.join)(gameDir, 'mods');
             if (!fs.existsSync(modsDir)) {
                 yield fs.promises.mkdir(modsDir, { recursive: true });
             }
@@ -120,7 +201,7 @@ class IconsGenerator {
                 let copied = 0;
                 for (const mod of mods) {
                     if (mod.endsWith('.jar')) {
-                        yield fs.promises.copyFile((0, path_1.join)(this.modsDir, mod), (0, path_1.join)(modsDir, mod));
+                        yield fs.promises.copyFile((0, node_path_1.join)(this.modsDir, mod), (0, node_path_1.join)(modsDir, mod));
                         copied++;
                     }
                 }
@@ -130,20 +211,20 @@ class IconsGenerator {
                 process.stdout.write(`Warning: mods directory not found: ${this.modsDir}\n`);
             }
             // Copy IconExporter to mods directory
-            const iconExporterSrc = (0, path_1.join)(this.workDir, IconsGenerator.ICONEXPORTER_JAR);
+            const iconExporterSrc = (0, node_path_1.join)(this.workDir, IconsGenerator.iconExporterJar);
             if (fs.existsSync(iconExporterSrc)) {
-                yield fs.promises.copyFile(iconExporterSrc, (0, path_1.join)(modsDir, IconsGenerator.ICONEXPORTER_JAR));
+                yield fs.promises.copyFile(iconExporterSrc, (0, node_path_1.join)(modsDir, IconsGenerator.iconExporterJar));
                 process.stdout.write('Added IconExporter to mods directory\n');
             }
             // Download hmc-specifics if not already present (avoids relying on HeadlessMC's
             // GitHub API lookup which may hit rate limits in CI environments)
             const existingMods = yield fs.promises.readdir(modsDir);
-            const hasHmcSpecifics = existingMods.some((f) => f.startsWith('hmc-specifics-'));
+            const hasHmcSpecifics = existingMods.some(f => f.startsWith('hmc-specifics-'));
             if (!hasHmcSpecifics) {
                 yield this.downloadHmcSpecifics(modsDir);
             }
             // Write options.txt to disable accessibility screen and pauseOnLostFocus
-            const optionsPath = (0, path_1.join)(gameDir, 'options.txt');
+            const optionsPath = (0, node_path_1.join)(gameDir, 'options.txt');
             if (!fs.existsSync(optionsPath)) {
                 yield fs.promises.writeFile(optionsPath, 'pauseOnLostFocus:false\nonboardAccessibility:false\n');
             }
@@ -153,12 +234,12 @@ class IconsGenerator {
      * Write the HeadlessMC configuration file.
      */
     writeHmcConfig() {
-        const configDir = (0, path_1.join)(this.workDir, IconsGenerator.HMC_CONFIG_SUBDIR);
+        const configDir = (0, node_path_1.join)(this.workDir, IconsGenerator.hmcConfigSubdir);
         if (!fs.existsSync(configDir)) {
             fs.mkdirSync(configDir, { recursive: true });
         }
-        const gameDir = (0, path_1.join)(this.workDir, IconsGenerator.HMC_GAME_SUBDIR);
-        const configPath = (0, path_1.join)(configDir, 'config.properties');
+        const gameDir = (0, node_path_1.join)(this.workDir, IconsGenerator.hmcGameSubdir);
+        const configPath = (0, node_path_1.join)(configDir, 'config.properties');
         const config = [
             `hmc.mcdir=${gameDir}`,
             'hmc.jline.enabled=false',
@@ -171,19 +252,23 @@ class IconsGenerator {
      */
     runGameAndExportIcons() {
         return __awaiter(this, void 0, void 0, function* () {
-            const jarPath = (0, path_1.join)(this.workDir, IconsGenerator.HEADLESSMC_JAR);
+            const jarPath = (0, node_path_1.join)(this.workDir, IconsGenerator.headlessMcJar);
             return new Promise((resolve, reject) => {
-                const proc = (0, child_process_1.spawn)('java', [
-                    `-Dhmc.mcdir=${(0, path_1.join)(this.workDir, IconsGenerator.HMC_GAME_SUBDIR)}`,
+                const proc = (0, node_child_process_1.spawn)('java', [
+                    `-Dhmc.mcdir=${(0, node_path_1.join)(this.workDir, IconsGenerator.hmcGameSubdir)}`,
                     // Tell HeadlessMC that Xvfb is in use so it skips offline headless checks
                     '-Dhmc.check.xvfb=true',
-                    '-jar', jarPath,
+                    '-jar',
+                    jarPath,
                 ], {
                     cwd: this.workDir,
                     stdio: ['pipe', 'pipe', 'pipe'],
                     env: Object.assign(Object.assign({}, process.env), { 
                         // Disable ANSI escape sequences for easier parsing
-                        TERM: 'dumb', NO_COLOR: '1' }),
+                        // eslint-disable-next-line ts/naming-convention
+                        TERM: 'dumb', 
+                        // eslint-disable-next-line ts/naming-convention
+                        NO_COLOR: '1' }),
                 });
                 let outputBuffer = '';
                 // Per-state buffer: cleared on every state transition, so checks only match
@@ -196,7 +281,7 @@ class IconsGenerator {
                 let commandSent = false;
                 const sendCommand = (command) => {
                     process.stdout.write(`[HMC] > ${command}\n`);
-                    proc.stdin.write(command + '\n');
+                    proc.stdin.write(`${command}\n`);
                 };
                 // Click a button by its text label, resolving to numeric ID from the last gui output.
                 // HeadlessMC's click command requires the numeric id, not button text.
@@ -206,13 +291,13 @@ class IconsGenerator {
                     const lastScreenIdx = outputBuffer.lastIndexOf('\nScreen:');
                     const recentGuiOutput = lastScreenIdx >= 0 ? outputBuffer.slice(lastScreenIdx) : outputBuffer;
                     const id = this.findButtonIdByText(recentGuiOutput, buttonText);
-                    if (id !== null) {
-                        sendCommand(`click ${id}`);
-                    }
-                    else {
+                    if (id === null) {
                         process.stdout.write(`[HMC] Warning: button "${buttonText}" not found in gui output, trying text fallback\n`);
                         sendCommand(`click ${buttonText}`);
                     }
+                    else {
+                        sendCommand(`click ${id}`);
+                    }
                 };
                 const transitionTo = (newState) => {
                     if (state !== newState) {
@@ -220,7 +305,8 @@ class IconsGenerator {
                         state = newState;
                         stateSettledAt = Date.now();
                         commandSent = false;
-                        stateBuffer = ''; // reset per-state buffer on every transition
+                        // Reset per-state buffer on every transition
+                        stateBuffer = '';
                     }
                 };
                 const handleOutput = (chunk) => {
@@ -228,10 +314,10 @@ class IconsGenerator {
                     stateBuffer += chunk;
                     // Keep global buffer size manageable
                     if (outputBuffer.length > 100000) {
-                        outputBuffer = outputBuffer.slice(outputBuffer.length - 20000);
+                        outputBuffer = outputBuffer.slice(-20000);
                     }
                     // Track the current screen from each gui output chunk
-                    const screenMatch = chunk.match(/^Screen:\s*(.+)$/m);
+                    const screenMatch = /^Screen:\s*(.+)$/mu.exec(chunk);
                     if (screenMatch) {
                         lastKnownScreen = screenMatch[1].trim();
                         process.stdout.write(`[HMC] Current screen: ${lastKnownScreen}\n`);
@@ -296,8 +382,8 @@ class IconsGenerator {
                                 clickByText('Create New World');
                                 transitionTo('creating_world');
                             }
-                            else if (stateBuffer.includes("Couldn't find command for '[gui]'") && !commandSent) {
-                                // gui not yet recognized; hmc-specifics may still be initializing - retry
+                            else if (stateBuffer.includes('Couldn\'t find command for \'[gui]\'') && !commandSent) {
+                                // Gui not yet recognized; hmc-specifics may still be initializing - retry
                                 commandSent = true;
                                 setTimeout(() => {
                                     sendCommand('gui');
@@ -325,11 +411,12 @@ class IconsGenerator {
                                 clickByText('Create New World');
                                 transitionTo('creating_world');
                             }
-                            else if ((stateBuffer.includes('logged in') || stateBuffer.includes('not displaying a Gui')) && !commandSent) {
+                            else if ((stateBuffer.includes('logged in') || stateBuffer.includes('not displaying a Gui')) &&
+                                !commandSent) {
                                 // World already loaded (detected either from HMC login message or from a gui poll)
                                 commandSent = true;
                                 setTimeout(() => {
-                                    sendCommand(`/iconexporter export ${IconsGenerator.DEFAULT_ICON_SIZE}`);
+                                    sendCommand(`/iconexporter export ${IconsGenerator.defaultIconSize}`);
                                     transitionTo('exporting_icons');
                                 }, 3000);
                             }
@@ -367,7 +454,7 @@ class IconsGenerator {
                                 commandSent = true;
                                 // Wait for world to fully initialize before triggering export
                                 setTimeout(() => {
-                                    sendCommand(`/iconexporter export ${IconsGenerator.DEFAULT_ICON_SIZE}`);
+                                    sendCommand(`/iconexporter export ${IconsGenerator.defaultIconSize}`);
                                     transitionTo('exporting_icons');
                                 }, 3000);
                             }
@@ -383,7 +470,7 @@ class IconsGenerator {
                             else if (Date.now() - stateSettledAt > 120000 && !commandSent) {
                                 // Timeout waiting for world - try to proceed anyway
                                 commandSent = true;
-                                sendCommand(`/iconexporter export ${IconsGenerator.DEFAULT_ICON_SIZE}`);
+                                sendCommand(`/iconexporter export ${IconsGenerator.defaultIconSize}`);
                                 transitionTo('exporting_icons');
                             }
                             else if (!commandSent) {
@@ -412,8 +499,9 @@ class IconsGenerator {
                                         sendCommand('quit');
                                         transitionTo('quitting');
                                     }, 5000);
+                                    // 20 minutes
                                 }
-                                else if (Date.now() - stateSettledAt > 1200000) { // 20 minutes
+                                else if (Date.now() - stateSettledAt > 1200000) {
                                     // Timeout - quit anyway
                                     commandSent = true;
                                     process.stdout.write('[HMC] Warning: icon export may not have completed, quitting...\n');
@@ -473,7 +561,7 @@ class IconsGenerator {
      */
     copyIcons() {
         return __awaiter(this, void 0, void 0, function* () {
-            const exportDir = (0, path_1.join)(this.workDir, IconsGenerator.HMC_GAME_SUBDIR, IconsGenerator.ICON_EXPORT_SUBDIR);
+            const exportDir = (0, node_path_1.join)(this.workDir, IconsGenerator.hmcGameSubdir, IconsGenerator.iconExportSubdir);
             if (!fs.existsSync(exportDir)) {
                 throw new Error(`Icon export directory not found: ${exportDir}. Make sure the IconExporter command ran successfully.`);
             }
@@ -481,9 +569,9 @@ class IconsGenerator {
                 yield fs.promises.mkdir(this.iconsDir, { recursive: true });
             }
             const files = yield fs.promises.readdir(exportDir);
-            const pngFiles = files.filter((f) => f.endsWith('.png'));
+            const pngFiles = files.filter(f => f.endsWith('.png'));
             for (const file of pngFiles) {
-                yield fs.promises.copyFile((0, path_1.join)(exportDir, file), (0, path_1.join)(this.iconsDir, file));
+                yield fs.promises.copyFile((0, node_path_1.join)(exportDir, file), (0, node_path_1.join)(this.iconsDir, file));
             }
             process.stdout.write(`Copied ${pngFiles.length} icons to ${this.iconsDir}\n`);
         });
@@ -499,9 +587,9 @@ class IconsGenerator {
      */
     findButtonIdByText(guiOutput, buttonText) {
         for (const line of guiOutput.split('\n')) {
-            const cols = line.trim().split(/\s{2,}/);
-            if (cols.length >= 2 && /^\d+$/.test(cols[0]) && cols[1].trim() === buttonText) {
-                return parseInt(cols[0], 10);
+            const cols = line.trim().split(/\s{2,}/u);
+            if (cols.length >= 2 && /^\d+$/u.test(cols[0]) && cols[1].trim() === buttonText) {
+                return Number.parseInt(cols[0], 10);
             }
         }
         return null;
@@ -539,21 +627,17 @@ class IconsGenerator {
     downloadHmcSpecifics(modsDir) {
         return __awaiter(this, void 0, void 0, function* () {
             process.stdout.write('Downloading hmc-specifics...\n');
-            const headers = {};
-            if (this.githubToken) {
-                headers.Authorization = `token ${this.githubToken}`;
-            }
-            const apiUrl = `https://api.github.com/repos/${IconsGenerator.HMC_SPECIFICS_REPO}/releases/latest`;
-            const apiResponse = yield (0, node_fetch_1.default)(apiUrl, { headers });
+            const apiUrl = `https://api.github.com/repos/${IconsGenerator.hmcSpecificsRepo}/releases/latest`;
+            const apiResponse = yield (0, node_fetch_1.default)(apiUrl);
             if (!apiResponse.ok) {
                 throw new Error(`Failed to fetch hmc-specifics release info: ${apiResponse.status} ${apiResponse.statusText}`);
             }
             const release = yield apiResponse.json();
-            const asset = release.assets.find((a) => a.name.includes(this.minecraftVersion) && a.name.includes('neoforge'));
+            const asset = release.assets.find(a => a.name.includes(this.minecraftVersion) && a.name.includes('neoforge'));
             if (!asset) {
                 throw new Error(`Could not find hmc-specifics asset for MC ${this.minecraftVersion} in release ${release.tag_name}`);
             }
-            const destPath = (0, path_1.join)(modsDir, asset.name);
+            const destPath = (0, node_path_1.join)(modsDir, asset.name);
             yield this.downloadFile(asset.browser_download_url, destPath);
             process.stdout.write(`Downloaded hmc-specifics to ${destPath}\n`);
         });
@@ -571,7 +655,7 @@ class IconsGenerator {
             if (!response.ok) {
                 throw new Error(`Failed to download from ${url}: ${response.status} ${response.statusText}`);
             }
-            const parentDir = (0, path_1.join)(destPath, '..');
+            const parentDir = (0, node_path_1.join)(destPath, '..');
             if (!fs.existsSync(parentDir)) {
                 yield fs.promises.mkdir(parentDir, { recursive: true });
             }
@@ -587,11 +671,13 @@ class IconsGenerator {
     }
 }
 exports.IconsGenerator = IconsGenerator;
-IconsGenerator.HEADLESSMC_JAR = 'headlessmc-launcher.jar';
-IconsGenerator.ICONEXPORTER_JAR = 'iconexporter.jar';
-IconsGenerator.HMC_GAME_SUBDIR = 'game';
-IconsGenerator.HMC_CONFIG_SUBDIR = 'HeadlessMC';
-IconsGenerator.ICON_EXPORT_SUBDIR = 'icon-exports-x64';
-IconsGenerator.DEFAULT_ICON_SIZE = 64;
-IconsGenerator.HMC_SPECIFICS_REPO = 'headlesshq/hmc-specifics';
+IconsGenerator.headlessMcJar = 'headlessmc-launcher.jar';
+IconsGenerator.iconExporterJar = 'iconexporter.jar';
+IconsGenerator.hmcGameSubdir = 'game';
+IconsGenerator.hmcConfigSubdir = 'HeadlessMC';
+IconsGenerator.iconExportSubdir = 'icon-exports-x64';
+IconsGenerator.defaultIconSize = 64;
+IconsGenerator.hmcSpecificsRepo = 'headlesshq/hmc-specifics';
+IconsGenerator.modrinthApiBase = 'https://api.modrinth.com/v2';
+IconsGenerator.iconExporterModrinthSlug = 'icon-exporter';
 //# sourceMappingURL=IconsGenerator.js.map

package/lib/infobook/FileWriter.d.ts

@@ -1,6 +1,6 @@
-import { Readable } from "stream";
-import { ISerializeContext } from "../serialize/HtmlInfoBookSerializer";
-import { IFileWriter } from "./IFileWriter";
+import type { Readable } from 'node:stream';
+import type { ISerializeContext } from '../serialize/HtmlInfoBookSerializer';
+import type { IFileWriter } from './IFileWriter';
 /**
  * A context-based {@link IFileWriter}.
  */