@windrun-huaiin/lib 15.1.0 → 16.0.0

package/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2025 D8ger
+Copyright (c) 2026 D8ger
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

package/dist/i18n-server.d.ts

@@ -0,0 +1,15 @@
+export interface RuntimeMessageFileSource {
+    type: 'file';
+    path?: string;
+}
+export interface RuntimeMessageDirectorySource {
+    type: 'dir';
+    path: string;
+}
+export type RuntimeMessageSource = RuntimeMessageFileSource | RuntimeMessageDirectorySource;
+export declare function loadMergedLocaleMessages(options: {
+    locale: string;
+    messagesRoot: string;
+    sources: readonly RuntimeMessageSource[];
+}): Promise<Record<string, unknown>>;
+//# sourceMappingURL=i18n-server.d.ts.map

package/dist/i18n-server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"i18n-server.d.ts","sourceRoot":"","sources":["../src/i18n-server.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,wBAAwB;IACvC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,6BAA6B;IAC5C,IAAI,EAAE,KAAK,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,MAAM,oBAAoB,GAAG,wBAAwB,GAAG,6BAA6B,CAAC;AAiC5F,wBAAsB,wBAAwB,CAAC,OAAO,EAAE;IACtD,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,SAAS,oBAAoB,EAAE,CAAC;CAC1C,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAyBnC"}

package/dist/i18n-server.js

@@ -0,0 +1,60 @@
+'use strict';
+
+var tslib = require('tslib');
+var promises = require('fs/promises');
+var path = require('path');
+var i18nUtils = require('./i18n-utils.js');
+
+function readMessageFile(filePath) {
+    return tslib.__awaiter(this, void 0, void 0, function* () {
+        const content = yield promises.readFile(filePath, 'utf8');
+        return JSON.parse(content);
+    });
+}
+function collectLocaleFiles(dirPath, locale) {
+    return tslib.__awaiter(this, void 0, void 0, function* () {
+        try {
+            const entries = yield promises.readdir(dirPath, { withFileTypes: true });
+            const nestedFiles = yield Promise.all(entries.map((entry) => tslib.__awaiter(this, void 0, void 0, function* () {
+                const fullPath = path.join(dirPath, entry.name);
+                if (entry.isDirectory()) {
+                    return collectLocaleFiles(fullPath, locale);
+                }
+                return entry.isFile() && entry.name.endsWith(`.${locale}.json`) ? [fullPath] : [];
+            })));
+            return nestedFiles.flat().sort((left, right) => left.localeCompare(right));
+        }
+        catch (error) {
+            const nodeError = error;
+            if (nodeError.code === 'ENOENT') {
+                return [];
+            }
+            throw error;
+        }
+    });
+}
+function loadMergedLocaleMessages(options) {
+    return tslib.__awaiter(this, void 0, void 0, function* () {
+        const { locale, messagesRoot, sources } = options;
+        let mergedMessages = {};
+        for (const source of sources) {
+            if (source.type === 'file') {
+                const filePath = source.path
+                    ? path.join(messagesRoot, source.path, `${locale}.json`)
+                    : path.join(messagesRoot, `${locale}.json`);
+                const fileMessages = yield readMessageFile(filePath);
+                mergedMessages = i18nUtils.deepMergeMessages(mergedMessages, fileMessages);
+                continue;
+            }
+            const dirPath = path.join(messagesRoot, source.path);
+            const filePaths = yield collectLocaleFiles(dirPath, locale);
+            for (const filePath of filePaths) {
+                const fileMessages = yield readMessageFile(filePath);
+                mergedMessages = i18nUtils.deepMergeMessages(mergedMessages, fileMessages);
+            }
+        }
+        return mergedMessages;
+    });
+}
+
+exports.loadMergedLocaleMessages = loadMergedLocaleMessages;

package/dist/i18n-server.mjs

@@ -0,0 +1,58 @@
+import { __awaiter } from 'tslib';
+import { readFile, readdir } from 'fs/promises';
+import path from 'path';
+import { deepMergeMessages } from './i18n-utils.mjs';
+
+function readMessageFile(filePath) {
+    return __awaiter(this, void 0, void 0, function* () {
+        const content = yield readFile(filePath, 'utf8');
+        return JSON.parse(content);
+    });
+}
+function collectLocaleFiles(dirPath, locale) {
+    return __awaiter(this, void 0, void 0, function* () {
+        try {
+            const entries = yield readdir(dirPath, { withFileTypes: true });
+            const nestedFiles = yield Promise.all(entries.map((entry) => __awaiter(this, void 0, void 0, function* () {
+                const fullPath = path.join(dirPath, entry.name);
+                if (entry.isDirectory()) {
+                    return collectLocaleFiles(fullPath, locale);
+                }
+                return entry.isFile() && entry.name.endsWith(`.${locale}.json`) ? [fullPath] : [];
+            })));
+            return nestedFiles.flat().sort((left, right) => left.localeCompare(right));
+        }
+        catch (error) {
+            const nodeError = error;
+            if (nodeError.code === 'ENOENT') {
+                return [];
+            }
+            throw error;
+        }
+    });
+}
+function loadMergedLocaleMessages(options) {
+    return __awaiter(this, void 0, void 0, function* () {
+        const { locale, messagesRoot, sources } = options;
+        let mergedMessages = {};
+        for (const source of sources) {
+            if (source.type === 'file') {
+                const filePath = source.path
+                    ? path.join(messagesRoot, source.path, `${locale}.json`)
+                    : path.join(messagesRoot, `${locale}.json`);
+                const fileMessages = yield readMessageFile(filePath);
+                mergedMessages = deepMergeMessages(mergedMessages, fileMessages);
+                continue;
+            }
+            const dirPath = path.join(messagesRoot, source.path);
+            const filePaths = yield collectLocaleFiles(dirPath, locale);
+            for (const filePath of filePaths) {
+                const fileMessages = yield readMessageFile(filePath);
+                mergedMessages = deepMergeMessages(mergedMessages, fileMessages);
+            }
+        }
+        return mergedMessages;
+    });
+}
+
+export { loadMergedLocaleMessages };

package/dist/i18n-utils.d.ts

@@ -0,0 +1,3 @@
+export declare function isPlainObject(value: unknown): value is Record<string, unknown>;
+export declare function deepMergeMessages(base: Record<string, unknown>, extra: Record<string, unknown>): Record<string, unknown>;
+//# sourceMappingURL=i18n-utils.d.ts.map

package/dist/i18n-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"i18n-utils.d.ts","sourceRoot":"","sources":["../src/i18n-utils.ts"],"names":[],"mappings":"AAAA,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAE9E;AAED,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC7B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAezB"}

package/dist/i18n-utils.js

@@ -0,0 +1,20 @@
+'use strict';
+
+function isPlainObject(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+function deepMergeMessages(base, extra) {
+    const result = Object.assign({}, base);
+    for (const [key, value] of Object.entries(extra)) {
+        const current = result[key];
+        if (isPlainObject(current) && isPlainObject(value)) {
+            result[key] = deepMergeMessages(current, value);
+            continue;
+        }
+        result[key] = value;
+    }
+    return result;
+}
+
+exports.deepMergeMessages = deepMergeMessages;
+exports.isPlainObject = isPlainObject;

package/dist/i18n-utils.mjs

@@ -0,0 +1,17 @@
+function isPlainObject(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+function deepMergeMessages(base, extra) {
+    const result = Object.assign({}, base);
+    for (const [key, value] of Object.entries(extra)) {
+        const current = result[key];
+        if (isPlainObject(current) && isPlainObject(value)) {
+            result[key] = deepMergeMessages(current, value);
+            continue;
+        }
+        result[key] = value;
+    }
+    return result;
+}
+
+export { deepMergeMessages, isPlainObject };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@windrun-huaiin/lib",
-  "version": "15.1.0",
+  "version": "16.0.0",
   "description": "Common utilities and configuration",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",
@@ -26,6 +26,16 @@
       "import": "./dist/common-app-config.mjs",
       "require": "./dist/common-app-config.js"
     },
+    "./i18n-utils": {
+      "types": "./dist/i18n-utils.d.ts",
+      "import": "./dist/i18n-utils.mjs",
+      "require": "./dist/i18n-utils.js"
+    },
+    "./i18n-server": {
+      "types": "./dist/i18n-server.d.ts",
+      "import": "./dist/i18n-server.mjs",
+      "require": "./dist/i18n-server.js"
+    },
     "./package.json": "./package.json"
   },
   "files": [

package/src/i18n-server.ts

@@ -0,0 +1,77 @@
+import { readdir, readFile } from 'fs/promises';
+import path from 'path';
+import { deepMergeMessages } from './i18n-utils';
+
+export interface RuntimeMessageFileSource {
+  type: 'file';
+  path?: string;
+}
+
+export interface RuntimeMessageDirectorySource {
+  type: 'dir';
+  path: string;
+}
+
+export type RuntimeMessageSource = RuntimeMessageFileSource | RuntimeMessageDirectorySource;
+
+async function readMessageFile(filePath: string): Promise<Record<string, unknown>> {
+  const content = await readFile(filePath, 'utf8');
+  return JSON.parse(content) as Record<string, unknown>;
+}
+
+async function collectLocaleFiles(dirPath: string, locale: string): Promise<string[]> {
+  try {
+    const entries = await readdir(dirPath, { withFileTypes: true });
+    const nestedFiles = await Promise.all(
+      entries.map(async entry => {
+        const fullPath = path.join(dirPath, entry.name);
+
+        if (entry.isDirectory()) {
+          return collectLocaleFiles(fullPath, locale);
+        }
+
+        return entry.isFile() && entry.name.endsWith(`.${locale}.json`) ? [fullPath] : [];
+      })
+    );
+
+    return nestedFiles.flat().sort((left, right) => left.localeCompare(right));
+  } catch (error) {
+    const nodeError = error as NodeJS.ErrnoException;
+    if (nodeError.code === 'ENOENT') {
+      return [];
+    }
+
+    throw error;
+  }
+}
+
+export async function loadMergedLocaleMessages(options: {
+  locale: string;
+  messagesRoot: string;
+  sources: readonly RuntimeMessageSource[];
+}): Promise<Record<string, unknown>> {
+  const { locale, messagesRoot, sources } = options;
+
+  let mergedMessages: Record<string, unknown> = {};
+
+  for (const source of sources) {
+    if (source.type === 'file') {
+      const filePath = source.path
+        ? path.join(messagesRoot, source.path, `${locale}.json`)
+        : path.join(messagesRoot, `${locale}.json`);
+      const fileMessages = await readMessageFile(filePath);
+      mergedMessages = deepMergeMessages(mergedMessages, fileMessages);
+      continue;
+    }
+
+    const dirPath = path.join(messagesRoot, source.path);
+    const filePaths = await collectLocaleFiles(dirPath, locale);
+
+    for (const filePath of filePaths) {
+      const fileMessages = await readMessageFile(filePath);
+      mergedMessages = deepMergeMessages(mergedMessages, fileMessages);
+    }
+  }
+
+  return mergedMessages;
+}

package/src/i18n-utils.ts

@@ -0,0 +1,23 @@
+export function isPlainObject(value: unknown): value is Record<string, unknown> {
+  return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+
+export function deepMergeMessages(
+  base: Record<string, unknown>,
+  extra: Record<string, unknown>
+): Record<string, unknown> {
+  const result: Record<string, unknown> = { ...base };
+
+  for (const [key, value] of Object.entries(extra)) {
+    const current = result[key];
+
+    if (isPlainObject(current) && isPlainObject(value)) {
+      result[key] = deepMergeMessages(current, value);
+      continue;
+    }
+
+    result[key] = value;
+  }
+
+  return result;
+}