@hua-labs/i18n-core 2.1.0 → 2.2.1

package/dist/server.mjs

@@ -1,3 +1,3 @@
-export { Translator, serverTranslate, ssrTranslate } from './chunk-EZL5TNH5.mjs';
+export { Translator, serverTranslate, ssrTranslate } from './chunk-4IYWT7MS.mjs';
 //# sourceMappingURL=server.mjs.map
 //# sourceMappingURL=server.mjs.map

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "@hua-labs/i18n-core",
-  "version": "2.1.0",
+  "version": "2.2.1",
   "description": "HUA Labs - Core i18n functionality with SSR/CSR support and state management integration",
-  "main": "./dist/index.mjs",
+  "main": "./dist/index.cjs",
   "module": "./dist/index.mjs",
   "types": "./dist/index.d.ts",
   "files": [
@@ -11,13 +11,16 @@
   ],
   "exports": {
     ".": {
+      "react-native": "./dist/index.mjs",
       "types": "./dist/index.d.ts",
       "import": "./dist/index.mjs",
+      "require": "./dist/index.cjs",
       "default": "./dist/index.mjs"
     },
     "./server": {
       "types": "./dist/server.d.ts",
       "import": "./dist/server.mjs",
+      "require": "./dist/server.cjs",
       "default": "./dist/server.mjs"
     }
   },
@@ -28,16 +31,16 @@
   "devDependencies": {
     "@testing-library/jest-dom": "^6.6.3",
     "@testing-library/react": "^16.3.0",
-    "@types/node": "^25.3.0",
-    "@types/react": "^19.2.14",
-    "@vitejs/plugin-react": "^5.1.4",
-    "eslint": "^10.0.1",
-    "jsdom": "^28.1.0",
-    "react": "^19.2.4",
-    "react-dom": "^19.2.4",
+    "@types/node": "^25.9.3",
+    "@types/react": "^19.2.17",
+    "@vitejs/plugin-react": "^5.2.0",
+    "eslint": "^10.5.0",
+    "jsdom": "^29.1.1",
+    "react": "^19.2.7",
+    "react-dom": "^19.2.7",
     "tsup": "^8.5.1",
     "typescript": "^5.9.3",
-    "vitest": "^4.0.18"
+    "vitest": "^4.1.8"
   },
   "peerDependencies": {
     "react": ">=19.0.0"
@@ -59,12 +62,12 @@
   "license": "MIT",
   "repository": {
     "type": "git",
-    "url": "https://github.com/HUA-Labs/HUA-Labs-public.git"
+    "url": "https://github.com/HUA-Labs/hua-packages.git"
   },
   "bugs": {
-    "url": "https://github.com/HUA-Labs/HUA-Labs-public/issues"
+    "url": "https://github.com/HUA-Labs/hua-packages/issues"
   },
-  "homepage": "https://github.com/HUA-Labs/HUA-Labs-public#readme",
+  "homepage": "https://github.com/HUA-Labs/hua-packages#readme",
   "publishConfig": {
     "access": "public",
     "provenance": true

package/src/__tests__/default-value.test.ts

@@ -0,0 +1,149 @@
+import { describe, it, expect, vi, beforeEach, afterEach } from "vitest";
+import { Translator } from "../core/translator";
+import { I18nConfig } from "../types";
+
+function createConfig(overrides?: Partial<I18nConfig>): I18nConfig {
+  return {
+    defaultLanguage: "ko",
+    fallbackLanguage: "en",
+    supportedLanguages: [
+      { code: "ko", name: "Korean", nativeName: "한국어" },
+      { code: "en", name: "English", nativeName: "English" },
+    ],
+    namespaces: ["common"],
+    loadTranslations: vi
+      .fn()
+      .mockImplementation(async (lang: string, ns: string) => {
+        if (lang === "ko" && ns === "common") {
+          return { greeting: "안녕하세요", welcome: "{name}님 환영합니다" };
+        }
+        if (lang === "en" && ns === "common") {
+          return { greeting: "Hello", welcome: "Welcome {name}" };
+        }
+        return {};
+      }),
+    ...overrides,
+  };
+}
+
+describe("defaultValue support", () => {
+  let translator: Translator;
+
+  beforeEach(() => {
+    vi.useFakeTimers();
+  });
+
+  afterEach(() => {
+    vi.useRealTimers();
+  });
+
+  describe("Translator.translate()", () => {
+    beforeEach(async () => {
+      translator = new Translator(createConfig());
+      await translator.initialize();
+      vi.advanceTimersByTime(100);
+    });
+
+    it("returns translation when key exists (ignores defaultValue)", () => {
+      const result = translator.translate("common:greeting", {
+        defaultValue: "Fallback",
+      });
+      expect(result).toBe("안녕하세요");
+    });
+
+    it("returns defaultValue when key is missing", () => {
+      const result = translator.translate("common:nonexistent", {
+        defaultValue: "Fallback text",
+      });
+      expect(result).toBe("Fallback text");
+    });
+
+    it("interpolates variables in defaultValue", () => {
+      const result = translator.translate("common:missing", {
+        defaultValue: "Hello {{name}}",
+        name: "World",
+      });
+      expect(result).toBe("Hello World");
+    });
+
+    it("returns empty string when key is missing and no defaultValue (production)", () => {
+      const result = translator.translate("common:nonexistent");
+      expect(result).toBe("");
+    });
+
+    it("returns defaultValue before initialization", () => {
+      const fresh = new Translator(createConfig());
+      // Not initialized — should still return defaultValue
+      const result = fresh.translate("common:missing", {
+        defaultValue: "Hello {{name}}",
+        name: "World",
+      });
+      expect(result).toBe("Hello World");
+    });
+
+    it("returns key when missing and debug mode (no defaultValue)", () => {
+      const debugTranslator = new Translator(createConfig({ debug: true }));
+      // Use initialTranslations to bypass async init
+      const config = createConfig({
+        debug: true,
+        initialTranslations: { ko: { common: {} }, en: { common: {} } },
+      });
+      const t = new Translator(config);
+      const result = t.translate("common:nonexistent");
+      expect(result).toBe("common:nonexistent");
+    });
+  });
+
+  describe("Translator.translateAsync()", () => {
+    beforeEach(async () => {
+      translator = new Translator(createConfig());
+      await translator.initialize();
+      vi.advanceTimersByTime(100);
+    });
+
+    it("returns defaultValue when key is missing", async () => {
+      const result = await translator.translateAsync("common:missing", {
+        defaultValue: "Async fallback",
+      });
+      expect(result).toBe("Async fallback");
+    });
+
+    it("returns translation when key exists", async () => {
+      const result = await translator.translateAsync("common:greeting", {
+        defaultValue: "Fallback",
+      });
+      expect(result).toBe("안녕하세요");
+    });
+  });
+
+  describe("Translator.translateSync()", () => {
+    beforeEach(async () => {
+      translator = new Translator(createConfig());
+      await translator.initialize();
+      vi.advanceTimersByTime(100);
+    });
+
+    it("returns defaultValue when key is missing", () => {
+      const result = translator.translateSync("common:missing", {
+        defaultValue: "Sync fallback",
+      });
+      expect(result).toBe("Sync fallback");
+    });
+
+    it("returns translation when key exists", () => {
+      const result = translator.translateSync("common:greeting", {
+        defaultValue: "Fallback",
+      });
+      expect(result).toBe("안녕하세요");
+    });
+
+    it("returns defaultValue even before initialization", () => {
+      const fresh = new Translator(createConfig());
+      // Not initialized — should still return defaultValue
+      const result = fresh.translateSync("common:missing", {
+        defaultValue: "Before init",
+      });
+      expect(result).toBe("Before init");
+    });
+  });
+});

package/src/components/MissingKeyOverlay.tsx

@@ -189,10 +189,12 @@ export const reportMissingKey = (key: string, options: {
       component: options.component
     };
 
-    // 커스텀 이벤트 발생
-    window.dispatchEvent(new CustomEvent('i18n:missing-key', {
-      detail: missingKey
-    }));
+    // 커스텀 이벤트 발생 (브라우저 환경에서만)
+    if (typeof window !== 'undefined' && typeof CustomEvent !== 'undefined') {
+      window.dispatchEvent(new CustomEvent('i18n:missing-key', {
+        detail: missingKey
+      }));
+    }
 
     // 콘솔에도 로그
     if (process.env.NODE_ENV === 'development') console.warn(`Missing translation key: ${key}`, {