@gjsify/vite-plugin-gettext 0.2.0

package/dist/types.d.ts

@@ -0,0 +1,101 @@
+/**
+ * Configuration options for the xgettext plugin
+ * Used to extract translatable strings from source files
+ */
+export interface XGettextPluginOptions {
+    /** Glob patterns for source files to extract strings from */
+    sources: string[];
+    /** Output path for the POT template file */
+    output: string;
+    /** The gettext domain name, defaults to 'messages' */
+    domain?: string;
+    /** Keywords to look for when extracting strings, defaults to ['_', 'gettext', 'ngettext'] */
+    keywords?: string[];
+    /** Additional options to pass to xgettext command */
+    xgettextOptions?: string[];
+    /** Enable verbose logging */
+    verbose?: boolean;
+    /** Automatically update PO files after POT changes */
+    autoUpdatePo?: boolean;
+    /** Version of the POT file, defaults to '1.0' */
+    version?: string;
+    /** Preset to use for extracting strings, defaults to 'glib' */
+    preset?: "glib";
+    /** URL for reporting bugs in the POT file */
+    msgidBugsAddress?: string;
+    /** Copyright holder to set in the POT file */
+    copyrightHolder?: string;
+}
+/**
+ * Configuration options for the gettext plugin
+ * Used to compile PO files to binary MO format
+ */
+export interface GettextPluginOptions {
+    /** Directory containing PO translation files */
+    poDirectory: string;
+    /** Output directory for compiled MO files */
+    moDirectory: string;
+    /** Filename of the MO file, defaults to 'messages.mo' */
+    filename?: string;
+    /** Enable verbose logging */
+    verbose?: boolean;
+}
+/**
+ * Output format types for msgfmt
+ */
+export type MsgfmtFormat = "mo" | "java" | "java2" | "csharp" | "csharp-resources" | "tcl" | "desktop" | "xml" | "json" | "qt";
+/**
+ * Configuration options for the msgfmt plugin
+ * Used to compile PO files to various formats including binary MO
+ */
+export interface MsgfmtPluginOptions {
+    /** Directory containing PO translation files */
+    poDirectory: string;
+    /** Output directory for compiled files */
+    outputDirectory: string;
+    /** The gettext domain name, defaults to 'messages' */
+    domain?: string;
+    /** Output filename, defaults to 'messages.mo' */
+    filename?: string;
+    /** Output format, defaults to 'mo' */
+    format?: MsgfmtFormat;
+    /** Path to template file, required for XML format */
+    templateFile?: string;
+    /** Enable verbose logging */
+    verbose?: boolean;
+    /** Additional options to pass to msgfmt command */
+    msgfmtOptions?: string[];
+    /** Whether to use the standard locale structure (locale/LANG/LC_MESSAGES/domain.mo) */
+    useLocaleStructure?: boolean;
+}
+export interface PluginOptions {
+    pluginName: string;
+    verbose?: boolean;
+}
+/**
+ * Options for the PO to JSON conversion plugin
+ */
+export interface GettextPo2JsonPluginOptions {
+    /**
+     * Directory containing PO files
+     */
+    poDirectory: string;
+    /**
+     * Directory where JSON files will be saved
+     */
+    jsonDirectory: string;
+    /**
+     * Default language code (default: 'en')
+     */
+    defaultLanguage?: string;
+    /**
+     * Enable verbose logging
+     */
+    verbose?: boolean;
+    /**
+     * Additional translations to include in all language files
+     * Keys are identifiers and values are the English text
+     * The English text will be translated for non-default languages if translations exist
+     */
+    additionalTranslations?: Record<string, string>;
+}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/dist/utils.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Checks if a gettext utility is installed and available
+ * @param command The command to check (msgfmt, xgettext, etc.)
+ * @param pluginName Name of the plugin for logging
+ * @param verbose Enable verbose logging
+ * @throws Error if the command is not found
+ */
+export declare function checkDependencies(command: string, pluginName: string, verbose: boolean): Promise<void>;
+/**
+ * Scans the PO directory to find available language translations
+ * @param poDirectory Directory containing PO files
+ * @param pluginName Name of the plugin for logging
+ * @param verbose Enable verbose logging
+ * @returns Array of language codes found (e.g. ['de', 'fr', 'es'])
+ */
+export declare function findAvailableLanguages(poDirectory: string, pluginName: string, verbose: boolean): Promise<string[]>;
+/**
+ * Generates a LINGUAS file containing the list of available languages
+ * @param languages List of language codes
+ * @param poDirectory Directory where the LINGUAS file should be created
+ * @param verbose Enable verbose logging
+ */
+export declare function generateLinguasFile(languages: string[], poDirectory: string, verbose?: boolean): Promise<void>;
+/**
+ * Creates directory structure recursively
+ * @param directory Directory path to create
+ */
+export declare function ensureDirectory(directory: string): Promise<void>;
+/**
+ * Processes a filename with potential .in suffix
+ * @param filePath Original file path or filename
+ * @returns Object with processed filename and extension
+ */
+export declare function processFilename(filePath: string): {
+    filename: string;
+    extension: string;
+};

package/dist/utils.js

@@ -0,0 +1,94 @@
+import { execa } from "execa";
+import path from "node:path";
+import fs from "node:fs/promises";
+/**
+ * Checks if a gettext utility is installed and available
+ * @param command The command to check (msgfmt, xgettext, etc.)
+ * @param pluginName Name of the plugin for logging
+ * @param verbose Enable verbose logging
+ * @throws Error if the command is not found
+ */
+export async function checkDependencies(command, pluginName, verbose) {
+    try {
+        await execa(command, ["--version"]);
+        if (verbose) {
+            console.log(`[${pluginName}] Found ${command}`);
+        }
+    }
+    catch (error) {
+        throw new Error(`${command} not found. Please install gettext:\n` +
+            "  Ubuntu/Debian: sudo apt-get install gettext\n" +
+            "  Fedora: sudo dnf install gettext\n" +
+            "  Arch: sudo pacman -S gettext\n" +
+            "  macOS: brew install gettext");
+    }
+}
+/**
+ * Scans the PO directory to find available language translations
+ * @param poDirectory Directory containing PO files
+ * @param pluginName Name of the plugin for logging
+ * @param verbose Enable verbose logging
+ * @returns Array of language codes found (e.g. ['de', 'fr', 'es'])
+ */
+export async function findAvailableLanguages(poDirectory, pluginName, verbose) {
+    try {
+        const files = await fs.readdir(poDirectory);
+        const languages = files
+            .filter((file) => file.endsWith(".po"))
+            .map((file) => path.basename(file, ".po"));
+        if (verbose) {
+            console.log(`[${pluginName}] Found languages: ${languages.join(", ")}`);
+        }
+        return languages;
+    }
+    catch (error) {
+        if (verbose) {
+            console.log(`[${pluginName}] No PO directory found at ${poDirectory}`);
+        }
+        return [];
+    }
+}
+/**
+ * Generates a LINGUAS file containing the list of available languages
+ * @param languages List of language codes
+ * @param poDirectory Directory where the LINGUAS file should be created
+ * @param verbose Enable verbose logging
+ */
+export async function generateLinguasFile(languages, poDirectory, verbose = false) {
+    const linguasPath = path.join(poDirectory, "LINGUAS");
+    const content = languages.join("\n");
+    try {
+        await fs.writeFile(linguasPath, content);
+        if (verbose) {
+            console.log(`Generated LINGUAS file with languages: ${languages.join(", ")}`);
+        }
+    }
+    catch (error) {
+        console.error("Error writing LINGUAS file:", error);
+    }
+}
+/**
+ * Creates directory structure recursively
+ * @param directory Directory path to create
+ */
+export async function ensureDirectory(directory) {
+    await fs.mkdir(directory, { recursive: true });
+}
+/**
+ * Processes a filename with potential .in suffix
+ * @param filePath Original file path or filename
+ * @returns Object with processed filename and extension
+ */
+export function processFilename(filePath) {
+    // Extract just the filename if a path is provided
+    const filename = path.basename(filePath);
+    let extension = path.extname(filename).toLowerCase();
+    let processedFilename = filename;
+    // Handle .in extension
+    if (filename.endsWith(".in")) {
+        processedFilename = filename.substring(0, filename.length - 3);
+        extension = path.extname(processedFilename).toLowerCase();
+    }
+    return { filename: processedFilename, extension };
+}
+//# sourceMappingURL=utils.js.map

package/dist/utils.js.map

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

package/dist/xgettext.d.ts

@@ -0,0 +1,9 @@
+import { type Plugin } from "vite";
+import type { XGettextPluginOptions } from "./types.js";
+/**
+ * Creates a Vite plugin that extracts translatable strings from source files
+ * Uses GNU xgettext to generate a POT template file that can be used as basis for translations
+ * @param options Configuration options for the plugin
+ * @returns A Vite plugin that handles string extraction
+ */
+export declare function xgettextPlugin(options: XGettextPluginOptions): Plugin;

package/dist/xgettext.js

@@ -0,0 +1,261 @@
+import {} from "vite";
+import { execa } from "execa";
+import path from "node:path";
+import fs from "node:fs/promises";
+import { existsSync } from "node:fs";
+import glob from "fast-glob";
+import { checkDependencies, ensureDirectory, processFilename, } from "./utils.js";
+// Add GLib preset constants
+// From https://github.com/mesonbuild/meson/blob/467da051c859ba3112803b035e317bddadd756ef/mesonbuild/modules/i18n.py
+const GLIB_PRESET_ARGS = [
+    "--from-code=UTF-8",
+    "--add-comments",
+    // https://developer.gnome.org/glib/stable/glib-I18N.html
+    "--keyword=_",
+    "--keyword=N_",
+    "--keyword=C_:1c,2",
+    "--keyword=NC_:1c,2",
+    "--keyword=g_dcgettext:2",
+    "--keyword=g_dngettext:2,3",
+    "--keyword=g_dpgettext2:2c,3",
+    "--flag=N_:1:pass-c-format",
+    "--flag=C_:2:pass-c-format",
+    "--flag=NC_:2:pass-c-format",
+    "--flag=g_dngettext:2:pass-c-format",
+    "--flag=g_strdup_printf:1:c-format",
+    "--flag=g_string_printf:2:c-format",
+    "--flag=g_string_append_printf:2:c-format",
+    "--flag=g_error_new:3:c-format",
+    "--flag=g_set_error:4:c-format",
+    "--flag=g_markup_printf_escaped:1:c-format",
+    "--flag=g_log:3:c-format",
+    "--flag=g_print:1:c-format",
+    "--flag=g_printerr:1:c-format",
+    "--flag=g_printf:1:c-format",
+    "--flag=g_fprintf:2:c-format",
+    "--flag=g_sprintf:2:c-format",
+    "--flag=g_snprintf:3:c-format",
+];
+/**
+ * Creates a Vite plugin that extracts translatable strings from source files
+ * Uses GNU xgettext to generate a POT template file that can be used as basis for translations
+ * @param options Configuration options for the plugin
+ * @returns A Vite plugin that handles string extraction
+ */
+export function xgettextPlugin(options) {
+    const pluginName = "vite-plugin-xgettext";
+    return {
+        name: pluginName,
+        async buildStart() {
+            await checkDependencies("xgettext", pluginName, options.verbose ?? false);
+            const files = await glob(options.sources);
+            await extractStrings(files, options, pluginName);
+        },
+        configureServer(server) {
+            server.watcher.add(options.sources);
+            server.watcher.on("change", async (file) => {
+                if (options.sources.some((pattern) => file.match(pattern))) {
+                    if (options.verbose) {
+                        console.log(`[${pluginName}] Source file changed: ${file}, re-running extraction`);
+                    }
+                    const files = await glob(options.sources);
+                    await extractStrings(files, options, pluginName);
+                }
+            });
+        },
+    };
+}
+async function generatePotfiles(files, outputDir, pluginName, verbose = false) {
+    // Group files by extension
+    const fileGroups = new Map();
+    files.forEach((file) => {
+        const filename = path.basename(file);
+        const group = getFileGroup(filename);
+        if (!fileGroups.has(group)) {
+            fileGroups.set(group, []);
+        }
+        fileGroups.get(group)?.push(file);
+    });
+    // Generate POTFILES for each group
+    const potFiles = [];
+    for (const [group, groupFiles] of fileGroups) {
+        const potfilePath = path.join(outputDir, `${group}.POTFILES`);
+        const content = groupFiles.join("\n");
+        try {
+            await fs.writeFile(potfilePath, content);
+            potFiles.push(potfilePath);
+            if (verbose) {
+                console.log(`[${pluginName}] Generated ${group}.POTFILES with ${groupFiles.length} source files`);
+            }
+        }
+        catch (error) {
+            console.error(`[${pluginName}] Error writing ${group}.POTFILES:`, error);
+        }
+    }
+    return potFiles;
+}
+function getFileGroup(fullFilename) {
+    // Process filename to handle .in extension
+    const { filename, extension } = processFilename(fullFilename);
+    // Special handling for metainfo.xml files
+    if (filename.endsWith(".metainfo.xml") || filename.endsWith(".appdata.xml")) {
+        return "metainfo";
+    }
+    switch (extension) {
+        case ".ts":
+        case ".js":
+        case ".tsx":
+            return "js";
+        case ".ui":
+        case ".xml":
+            return "ui";
+        case ".blp":
+            return "blp";
+        case ".desktop":
+            return "desktop";
+        default:
+            return "other";
+    }
+}
+async function extractStrings(files, options, pluginName) {
+    const { output, domain = "messages", keywords = [], preset, verbose = false, } = options;
+    try {
+        const outputDir = path.dirname(output);
+        await ensureDirectory(outputDir);
+        // Generate grouped POTFILES
+        const potFiles = await generatePotfiles(files, outputDir, pluginName, verbose);
+        // Create temporary POT files for each group
+        const tempPotFiles = [];
+        for (const potFile of potFiles) {
+            const group = path.basename(potFile).split(".")[0];
+            const tempOutput = path.join(outputDir, `temp_${group}.pot`);
+            // Base arguments
+            let args = [
+                "--package-name=" + domain,
+                options.version ? "--package-version=" + options.version : "",
+                "--output=" + tempOutput,
+                "--files-from=" + potFile,
+                "--from-code=UTF-8",
+                "--add-comments",
+            ];
+            // Add bug report address if specified
+            if (options.msgidBugsAddress) {
+                args.push("--msgid-bugs-address=" + options.msgidBugsAddress);
+            }
+            // Add copyright holder if specified
+            if (options.copyrightHolder) {
+                args.push("--copyright-holder=" + options.copyrightHolder);
+            }
+            // Add language-specific settings
+            switch (group) {
+                case "js":
+                case "blp":
+                    args.push("--language=JavaScript");
+                    args.push(...keywords.map((k) => `--keyword=${k}`));
+                    if (preset === "glib") {
+                        args.push(...GLIB_PRESET_ARGS);
+                    }
+                    break;
+                case "ui":
+                    args.push("--language=Glade");
+                    break;
+                case "metainfo":
+                    // Find the first existing metainfo.its file
+                    const metainfoItsPath = await findMetainfoItsPath();
+                    if (!metainfoItsPath) {
+                        console.warn("Warning: Could not find metainfo.its in any of the expected locations");
+                        // Continue without the ITS file
+                    }
+                    else {
+                        args.push(`--its=${metainfoItsPath}`);
+                    }
+                    break;
+                case "desktop":
+                    args.push("--language=Desktop");
+                    break;
+            }
+            if (verbose) {
+                console.log(`[${pluginName}] Running xgettext for ${group}:`, args.join(" "));
+            }
+            await execa("xgettext", args);
+            // Check if file exists before adding to tempPotFiles
+            try {
+                await fs.access(tempOutput);
+                tempPotFiles.push(tempOutput);
+                if (verbose) {
+                    console.log(`[${pluginName}] Successfully created temporary POT file: ${tempOutput}`);
+                }
+            }
+            catch (error) {
+                console.warn(`[${pluginName}] Failed to create temporary POT file: ${tempOutput}`);
+            }
+        }
+        // Combine all temporary POT files using msgcat
+        if (tempPotFiles.length > 0) {
+            const msgcatArgs = ["--use-first", "-o", output, ...tempPotFiles];
+            await execa("msgcat", msgcatArgs);
+            // Clean up temporary files
+            for (const tempFile of tempPotFiles) {
+                await fs.unlink(tempFile);
+            }
+            for (const potFile of potFiles) {
+                await fs.unlink(potFile);
+            }
+        }
+        if (options.autoUpdatePo) {
+            await updatePoFiles(options.output, pluginName, options.verbose || false);
+        }
+    }
+    catch (error) {
+        throw new Error(`Failed to extract translations: ${error}`);
+    }
+}
+async function updatePoFiles(potFile, pluginName, verbose) {
+    try {
+        const linguasPath = path.join(path.dirname(potFile), "LINGUAS");
+        const languages = (await fs.readFile(linguasPath, "utf-8"))
+            .split("\n")
+            .filter(Boolean);
+        for (const lang of languages) {
+            const poFile = path.join(path.dirname(potFile), `${lang}.po`);
+            if (verbose) {
+                console.log(`[${pluginName}] Updating ${poFile}`);
+            }
+            await execa("msgmerge", ["--update", "--backup=none", poFile, potFile]);
+        }
+    }
+    catch (error) {
+        console.error(`[${pluginName}] Error updating PO files:`, error);
+    }
+}
+/**
+ * Finds the first existing metainfo.its file from installed gettext versions
+ * @returns The path to the metainfo.its file if found, otherwise undefined
+ */
+async function findMetainfoItsPath() {
+    // Default path
+    const defaultPath = "/usr/share/gettext/its/metainfo.its";
+    // Check default path first
+    if (existsSync(defaultPath)) {
+        return defaultPath;
+    }
+    try {
+        // Use glob to find all potential gettext version directories
+        const getTextDirs = await glob("/usr/share/gettext-*");
+        // Sort by version (newest first) if possible
+        getTextDirs.sort((a, b) => {
+            const versionA = a.replace("/usr/share/gettext-", "");
+            const versionB = b.replace("/usr/share/gettext-", "");
+            return versionB.localeCompare(versionA);
+        });
+        // Add specific version paths we know about
+        const metainfoItsPaths = getTextDirs.map((dir) => `${dir}/its/metainfo.its`);
+        // Find first existing path
+        return metainfoItsPaths.find((path) => existsSync(path));
+    }
+    catch (error) {
+        console.warn("Error searching for metainfo.its:", error);
+        return undefined;
+    }
+}
+//# sourceMappingURL=xgettext.js.map

package/dist/xgettext.js.map

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

package/package.json

@@ -0,0 +1,29 @@
+{
+  "name": "@gjsify/vite-plugin-gettext",
+  "version": "0.2.0",
+  "description": "Vite plugin for compiling Gettext PO files",
+  "main": "dist/index.js",
+  "type": "module",
+  "scripts": {
+    "test": "echo \"Error: no test specified\" && exit 1",
+    "clear": "rm -rf dist",
+    "check": "tsc --noEmit",
+    "build": "tsc --declaration"
+  },
+  "author": "Pascal Garber <pascal@mailfreun.de>",
+  "license": "MIT",
+  "devDependencies": {
+    "@types/gettext-parser": "^8.0.0",
+    "@types/node": "^24.3.0",
+    "gettext-parser": "^8.0.0",
+    "typescript": "^5.9.2",
+    "vite": "^7.1.2"
+  },
+  "peerDependencies": {
+    "vite": "*"
+  },
+  "dependencies": {
+    "execa": "^9.6.0",
+    "fast-glob": "^3.3.3"
+  }
+}

package/src/gettext.ts

@@ -0,0 +1,104 @@
+import { type Plugin } from "vite";
+import { execa } from "execa";
+import path from "node:path";
+import type { GettextPluginOptions } from "./types.js";
+import {
+  checkDependencies,
+  findAvailableLanguages,
+  generateLinguasFile,
+  ensureDirectory,
+} from "./utils.js";
+
+/**
+ * Creates a Vite plugin that compiles PO translation files to binary MO format
+ * The MO files are placed in the standard gettext directory structure:
+ * {moDirectory}/locale/{lang}/LC_MESSAGES/messages.mo
+ * @param options Configuration options for the plugin
+ * @returns A Vite plugin that handles PO compilation
+ */
+export function gettextPlugin(options: GettextPluginOptions): Plugin {
+  const {
+    poDirectory,
+    moDirectory,
+    filename = "messages.mo",
+    verbose = false,
+  } = options;
+
+  const pluginName = "vite-plugin-gettext";
+
+  async function compileMoFiles() {
+    try {
+      // Check if PO directory exists
+      try {
+        await ensureDirectory(poDirectory);
+      } catch {
+        if (verbose) {
+          console.log(
+            `[${pluginName}] PO directory ${poDirectory} does not exist yet, skipping compilation`
+          );
+        }
+        return;
+      }
+
+      // Find available languages
+      const languages = await findAvailableLanguages(
+        poDirectory,
+        pluginName,
+        verbose
+      );
+
+      if (languages.length === 0) {
+        if (verbose) {
+          console.log(`[${pluginName}] No translation files found`);
+        }
+        return;
+      }
+
+      // Generate LINGUAS file
+      await generateLinguasFile(languages, poDirectory, verbose);
+
+      // Create MO directory
+      await ensureDirectory(path.join(moDirectory, "locale"));
+
+      for (const lang of languages) {
+        const poFile = path.join(poDirectory, `${lang}.po`);
+        const moPath = path.join(moDirectory, "locale", lang, "LC_MESSAGES");
+        const moFile = path.join(moPath, filename);
+
+        await ensureDirectory(moPath);
+
+        if (verbose) {
+          console.log(`[${pluginName}] Compiling ${poFile} to ${moFile}`);
+        }
+
+        await execa("msgfmt", ["--output-file=" + moFile, poFile]);
+      }
+    } catch (error) {
+      throw new Error(`Failed to compile MO files: ${error}`);
+    }
+  }
+
+  return {
+    name: pluginName,
+
+    async buildStart() {
+      await checkDependencies("msgfmt", pluginName, verbose);
+      await compileMoFiles();
+    },
+
+    configureServer(server) {
+      server.watcher.add(poDirectory);
+
+      server.watcher.on("change", async (file) => {
+        if (file.endsWith(".po")) {
+          if (verbose) {
+            console.log(
+              `[${pluginName}] PO file changed: ${file}, recompiling`
+            );
+          }
+          await compileMoFiles();
+        }
+      });
+    },
+  };
+}