tina4-nodejs 3.13.47 → 3.13.48

package/CLAUDE.md

@@ -1,4 +1,4 @@
-# CLAUDE.md - AI Developer Guide for tina4-nodejs (v3.13.47)
+# CLAUDE.md - AI Developer Guide for tina4-nodejs (v3.13.48)
 
 > This file helps AI assistants (Claude, Copilot, Cursor, etc.) understand and work on this codebase effectively.
 

package/package.json

@@ -1,12 +1,8 @@
 {
   "name": "tina4-nodejs",
-
-
-
-  "version": "3.13.47",
-
+  "version": "3.13.48",
   "type": "module",
-  "description": "Tina4 for Node.js/TypeScript \u2014 54 built-in features, zero dependencies",
+  "description": "Tina4 for Node.js/TypeScript - 54 built-in features, zero dependencies",
   "keywords": [
     "tina4",
     "framework",
@@ -57,18 +53,19 @@
   "scripts": {
     "build": "npm run build --workspaces",
     "clean": "rm -rf packages/*/dist",
-    "test": "tsx test/run-all.ts",
+    "test": "tsx test/run-all.ts && npm run test:i18n",
+    "test:i18n": "vitest run test/i18n.test.ts test/i18n-leaf-alias.test.ts",
     "typecheck": "tsc -p tsconfig.typecheck.json"
   },
   "engines": {
     "node": ">=22.0.0"
   },
-  "dependencies": {},
   "devDependencies": {
-    "typescript": "^5.7.0",
-    "tsx": "^4.19.0",
+    "@types/node": "^22.10.0",
     "esbuild": "^0.24.0",
     "mongodb": "^6.0.0",
-    "@types/node": "^22.10.0"
+    "tsx": "^4.19.0",
+    "typescript": "^5.7.0",
+    "vitest": "^4.1.9"
   }
-}
+}

package/packages/core/src/i18n.ts

@@ -10,11 +10,20 @@ export class I18n {
   private _currentLocale: string;
   private _translations: Map<string, Record<string, string>> = new Map();
 
-  constructor(localeDir?: string, defaultLocale?: string) {
+  /**
+   * @param locale  Default locale code (e.g. "en"). Falls back to
+   *                TINA4_LOCALE, then "en".
+   * @param path    Directory holding the JSON/YAML locale files. Falls back to
+   *                TINA4_LOCALE_DIR, then "src/locales".
+   *
+   * Arg order is (locale, path) to match the Python master `I18n(locale, path)`
+   * (BUG-7, BREAKING in 3.13.x — was previously (localeDir, defaultLocale)).
+   */
+  constructor(locale?: string, path?: string) {
     this._localeDir = resolve(
-      localeDir ?? process.env.TINA4_LOCALE_DIR ?? "src/locales"
+      path ?? process.env.TINA4_LOCALE_DIR ?? "src/locales"
     );
-    this._defaultLocale = defaultLocale ?? process.env.TINA4_LOCALE ?? "en";
+    this._defaultLocale = locale ?? process.env.TINA4_LOCALE ?? "en";
     this._currentLocale = this._defaultLocale;
     this._loadLocale(this._defaultLocale);
   }

package/packages/core/src/server.ts

@@ -878,7 +878,7 @@ ${reset}
       try {
         const localeFiles = readdirSync(localeDir).filter((f: string) => f.endsWith(".json"));
         if (localeFiles.length > 0 && !frondEngine.globals?.t) {
-          const i18nInstance = new I18n(localeDir, process.env.TINA4_LOCALE ?? "en");
+          const i18nInstance = new I18n(process.env.TINA4_LOCALE ?? "en", localeDir);
           frondEngine.addGlobal("t", (key: string, params?: Record<string, string>) => i18nInstance.t(key, params));
         }
       } catch {