@gen-epix/merge-locales 0.0.2 → 0.0.3

package/README.md

@@ -1,38 +1,27 @@
 # @gen-epix/merge-locales
 
-Merge locale JSON files from multiple source directories into one locale directory, either from a CLI or Vite.
+Vite plugin that merges locale JSON files from multiple source directories into a single set of locale files.
 
-Later source directories take precedence when the same translation key occurs in more than one source. Nested objects are merged recursively; arrays and scalar values are replaced.
-
-```sh
-merge-locales <output-directory> <source-directory> [...source-directories]
-```
-
-For example:
-
-```sh
-merge-locales ./public/locale ./src/locale ../ui-core-components/src/locale ../ui-core-form/src/locale
-```
-
-The command discovers locale names from the JSON filenames, so it does not require a fixed list of locales.
-
-## Vite plugin
+Later source directories take precedence when the same translation key occurs in more than one source. Nested objects are merged recursively; arrays and scalar values are replaced. Locale names are discovered from the JSON filenames, so no fixed list of locales is required.
 
 ```ts
 import { mergeLocales } from '@gen-epix/merge-locales';
 
 export default {
- plugins: [
-  mergeLocales({
-   outputDirectory: './public/locale',
-   sourceDirectories: [
-    './src/locale',
-    '../ui-core-components/src/locale',
-    '../ui-core-form/src/locale',
-   ],
-  }),
- ],
+  plugins: [
+    mergeLocales({
+      outputPath: 'locale',
+      sourceDirectories: [
+        './src/locale',
+        '../ui-core-components/src/locale',
+        '../ui-core-form/src/locale',
+      ],
+    }),
+  ],
 };
 ```
 
-Paths are resolved relative to Vite's configured root. Locale files are merged when the dev server starts and whenever a source locale changes, with a full page reload. Production builds merge the files during the build lifecycle. Later source directories take precedence.
+Source directories are resolved relative to Vite's configured root. Nothing is written to the source tree:
+
+- During development the merged locales are served from `outputPath` (for example `/locale/en.json`), re-merged on every request, with a full page reload whenever a source locale file changes.
+- During a build the merged locales are emitted as assets under `outputPath`, relative to the build output directory.

package/bin/index.d.ts

@@ -1,15 +1,18 @@
 interface MergeLocalesOptions {
-    outputDirectory: string;
+    outputPath: string;
     sourceDirectories: string[];
 }
 
 interface MergeLocalesPlugin {
-    buildStart: () => void;
     configResolved: (config: ResolvedConfig) => void;
     configureServer: (server: DevServer) => void;
+    generateBundle: (this: EmitFileContext) => void;
     name: string;
 }
 interface DevServer {
+    middlewares: {
+        use: (handler: (request: ServerRequest, response: ServerResponse, next: () => void) => void) => void;
+    };
     watcher: {
         add: (paths: string[]) => void;
         on: (event: 'add' | 'change' | 'unlink', handler: (filePath: string) => void) => void;
@@ -21,9 +24,24 @@ interface DevServer {
         }) => void;
     };
 }
+interface EmitFileContext {
+    emitFile: (file: {
+        fileName: string;
+        source: string;
+        type: 'asset';
+    }) => void;
+}
 interface ResolvedConfig {
     root: string;
 }
+interface ServerRequest {
+    url?: string;
+}
+interface ServerResponse {
+    end: (chunk: string) => void;
+    setHeader: (name: string, value: string) => void;
+    statusCode: number;
+}
 declare const mergeLocales: (options: MergeLocalesOptions) => MergeLocalesPlugin;
 
 export { mergeLocales };

package/bin/index.js

@@ -1,5 +1,5 @@
-import { join, extname, basename, resolve, sep } from 'path';
-import { mkdirSync, writeFileSync, readdirSync, readFileSync } from 'fs';
+import { extname, basename, join, resolve, sep } from 'path';
+import { readdirSync, readFileSync } from 'fs';
 
 const isJsonObject = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
 const mergeJsonValues = (base, override) => {
@@ -33,7 +33,7 @@ const readJsonFile = (filePath) => {
     throw new Error(`Unable to parse locale file ${filePath}: ${getErrorMessage(error)}`, { cause: error });
   }
 };
-const mergeLocales$1 = ({ outputDirectory, sourceDirectories }) => {
+const mergeLocales$1 = (sourceDirectories) => {
   const locales = /* @__PURE__ */ new Map();
   for (const sourceDirectory of sourceDirectories) {
     let sourceLocales;
@@ -49,52 +49,59 @@ const mergeLocales$1 = ({ outputDirectory, sourceDirectories }) => {
   if (locales.size === 0) {
     throw new Error("No locale JSON files found in the source directories.");
   }
-  mkdirSync(outputDirectory, { recursive: true });
-  const outputPaths = [];
+  const mergedLocales = /* @__PURE__ */ new Map();
   for (const [locale, files] of [...locales.entries()].sort(([first], [second]) => first.localeCompare(second))) {
     let merged = {};
     for (const file of files) {
       merged = mergeJsonValues(merged, readJsonFile(file));
     }
-    const outputPath = join(outputDirectory, `${locale}.json`);
-    writeFileSync(outputPath, `${JSON.stringify(merged, null, 2)}
+    mergedLocales.set(locale, `${JSON.stringify(merged, null, 2)}
 `);
-    outputPaths.push(outputPath);
   }
-  return outputPaths;
+  return mergedLocales;
 };
 
+const trimSlashes = (value) => value.replace(/^[./]+/, "").replace(/\/+$/, "");
 const mergeLocales = (options) => {
-  let resolvedOptions = {
-    outputDirectory: resolve(options.outputDirectory),
-    sourceDirectories: options.sourceDirectories.map((sourceDirectory) => resolve(sourceDirectory))
-  };
+  const outputPath = trimSlashes(options.outputPath);
+  let sourceDirectories = options.sourceDirectories.map((sourceDirectory) => resolve(sourceDirectory));
   return {
-    buildStart: () => {
-      mergeLocales$1(resolvedOptions);
-    },
     configResolved: (config) => {
-      resolvedOptions = {
-        outputDirectory: resolve(config.root, options.outputDirectory),
-        sourceDirectories: options.sourceDirectories.map((sourceDirectory) => resolve(config.root, sourceDirectory))
-      };
+      sourceDirectories = options.sourceDirectories.map((sourceDirectory) => resolve(config.root, sourceDirectory));
     },
     configureServer: (server) => {
-      const mergeAndReload = () => {
-        mergeLocales$1(resolvedOptions);
-        server.ws.send({ path: "*", type: "full-reload" });
-      };
-      mergeLocales$1(resolvedOptions);
-      server.watcher.add(resolvedOptions.sourceDirectories);
+      server.watcher.add(sourceDirectories);
       for (const event of ["add", "change", "unlink"]) {
         server.watcher.on(event, (filePath) => {
           const isLocaleFile = filePath.endsWith(".json");
-          const isSourceFile = resolvedOptions.sourceDirectories.some((sourceDirectory) => filePath.startsWith(`${sourceDirectory}${sep}`));
+          const isSourceFile = sourceDirectories.some((sourceDirectory) => filePath.startsWith(`${sourceDirectory}${sep}`));
           if (isLocaleFile && isSourceFile) {
-            mergeAndReload();
+            server.ws.send({ path: "*", type: "full-reload" });
           }
         });
       }
+      server.middlewares.use((request, response, next) => {
+        const pathname = (request.url ?? "").split("?")[0];
+        const match = new RegExp(`(?:^|/)${outputPath}/([^/]+)\\.json$`).exec(pathname);
+        const source = match ? mergeLocales$1(sourceDirectories).get(match[1]) : void 0;
+        if (source === void 0) {
+          next();
+          return;
+        }
+        response.statusCode = 200;
+        response.setHeader("Content-Type", "application/json");
+        response.setHeader("Cache-Control", "no-cache");
+        response.end(source);
+      });
+    },
+    generateBundle: function emitLocales() {
+      for (const [locale, source] of mergeLocales$1(sourceDirectories)) {
+        this.emitFile({
+          fileName: `${outputPath}/${locale}.json`,
+          source,
+          type: "asset"
+        });
+      }
     },
     name: "merge-locales"
   };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gen-epix/merge-locales",
-  "version": "0.0.2",
+  "version": "0.0.3",
   "license": "EUPL-1.2",
   "publishConfig": {
     "access": "public"
@@ -22,11 +22,7 @@
     ".": {
       "types": "./bin/index.d.ts",
       "import": "./bin/index.js"
-    },
-    "./cli": "./bin/merge-locales.js"
-  },
-  "bin": {
-    "merge-locales": "bin/merge-locales.js"
+    }
   },
   "dependencies": {},
   "devDependencies": {
@@ -37,13 +33,11 @@
     "rollup": "4.63.1",
     "rollup-plugin-dts": "6.5.1",
     "rollup-plugin-esbuild": "6.2.1",
-    "typescript": "6.0.3",
-    "vite-node": "6.0.0"
+    "typescript": "6.0.3"
   },
   "scripts": {
     "lint": "eslint ./src --report-unused-disable-directives --max-warnings 0",
     "check-types": "tsc --noemit",
-    "merge-locales": "vite-node --loader ts-node/esm ./src/merge-locales.ts",
-    "build": "rimraf ./bin && rollup -c && chmod +x ./bin/merge-locales.js"
+    "build": "rimraf ./bin && rollup -c"
   }
 }

package/bin/merge-locales.js

@@ -1,90 +0,0 @@
-#!/usr/bin/env node
-import { join, extname, basename, resolve } from 'path';
-import { mkdirSync, writeFileSync, readdirSync, readFileSync } from 'fs';
-
-const isJsonObject = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
-const mergeJsonValues = (base, override) => {
-  if (!isJsonObject(base) || !isJsonObject(override)) {
-    return override;
-  }
-  const merged = { ...base };
-  for (const [key, value] of Object.entries(override)) {
-    merged[key] = key in merged ? mergeJsonValues(merged[key], value) : value;
-  }
-  return merged;
-};
-const getErrorMessage = (error) => error instanceof Error ? error.message : JSON.stringify(error);
-const readLocaleFiles = (sourceDirectory) => {
-  const localeFiles = /* @__PURE__ */ new Map();
-  for (const entry of readdirSync(sourceDirectory, { withFileTypes: true })) {
-    if (!entry.isFile() || extname(entry.name) !== ".json") {
-      continue;
-    }
-    const locale = basename(entry.name, ".json");
-    const files = localeFiles.get(locale) ?? [];
-    files.push(join(sourceDirectory, entry.name));
-    localeFiles.set(locale, files);
-  }
-  return localeFiles;
-};
-const readJsonFile = (filePath) => {
-  try {
-    return JSON.parse(readFileSync(filePath, "utf-8"));
-  } catch (error) {
-    throw new Error(`Unable to parse locale file ${filePath}: ${getErrorMessage(error)}`, { cause: error });
-  }
-};
-const mergeLocales = ({ outputDirectory, sourceDirectories }) => {
-  const locales = /* @__PURE__ */ new Map();
-  for (const sourceDirectory of sourceDirectories) {
-    let sourceLocales;
-    try {
-      sourceLocales = readLocaleFiles(sourceDirectory);
-    } catch (error) {
-      throw new Error(`Unable to read source directory ${sourceDirectory}: ${getErrorMessage(error)}`, { cause: error });
-    }
-    for (const [locale, files] of sourceLocales) {
-      locales.set(locale, [...locales.get(locale) ?? [], ...files]);
-    }
-  }
-  if (locales.size === 0) {
-    throw new Error("No locale JSON files found in the source directories.");
-  }
-  mkdirSync(outputDirectory, { recursive: true });
-  const outputPaths = [];
-  for (const [locale, files] of [...locales.entries()].sort(([first], [second]) => first.localeCompare(second))) {
-    let merged = {};
-    for (const file of files) {
-      merged = mergeJsonValues(merged, readJsonFile(file));
-    }
-    const outputPath = join(outputDirectory, `${locale}.json`);
-    writeFileSync(outputPath, `${JSON.stringify(merged, null, 2)}
-`);
-    outputPaths.push(outputPath);
-  }
-  return outputPaths;
-};
-
-const parseArguments = () => {
-  const [outputDirectory2, ...sourceDirectories2] = process.argv.slice(2);
-  if (!outputDirectory2 || sourceDirectories2.length === 0) {
-    console.error("Usage: merge-locales <output-directory> <source-directory> [...source-directories]");
-    process.exit(1);
-  }
-  return {
-    outputDirectory: resolve(outputDirectory2),
-    sourceDirectories: sourceDirectories2.map((sourceDirectory) => resolve(sourceDirectory))
-  };
-};
-const { outputDirectory, sourceDirectories } = parseArguments();
-try {
-  for (const outputPath of mergeLocales({
-    outputDirectory: resolve(outputDirectory),
-    sourceDirectories: sourceDirectories.map((sourceDirectory) => resolve(sourceDirectory))
-  })) {
-    console.log(`Merged locale into ${outputPath}`);
-  }
-} catch (error) {
-  console.error(error instanceof Error ? error.message : JSON.stringify(error));
-  process.exit(1);
-}