@djangocfg/ext-newsletter 1.0.21 → 1.0.23

package/dist/config.cjs

@@ -27,7 +27,7 @@ var import_ext_base = require("@djangocfg/ext-base");
 // package.json
 var package_default = {
   name: "@djangocfg/ext-newsletter",
-  version: "1.0.21",
+  version: "1.0.23",
   description: "Newsletter and subscription management extension for DjangoCFG",
   keywords: [
     "django",
@@ -73,6 +73,11 @@ var package_default = {
       types: "./dist/config.d.ts",
       import: "./dist/config.js",
       require: "./dist/config.cjs"
+    },
+    "./i18n": {
+      types: "./dist/i18n.d.ts",
+      import: "./dist/i18n.js",
+      require: "./dist/i18n.cjs"
     }
   },
   files: [
@@ -88,10 +93,12 @@ var package_default = {
   peerDependencies: {
     "@djangocfg/api": "workspace:*",
     "@djangocfg/ext-base": "workspace:*",
+    "@djangocfg/i18n": "workspace:*",
     "@djangocfg/ui-core": "workspace:*",
     consola: "^3.4.2",
     "lucide-react": "^0.545.0",
     next: "^16",
+    "next-intl": "^4",
     "p-retry": "^7.0.0",
     react: "^19",
     "react-dom": "^19",
@@ -101,10 +108,12 @@ var package_default = {
   devDependencies: {
     "@djangocfg/api": "workspace:*",
     "@djangocfg/ext-base": "workspace:*",
+    "@djangocfg/i18n": "workspace:*",
     "@djangocfg/typescript-config": "workspace:*",
     "@types/node": "^24.7.2",
     "@types/react": "^19.0.0",
     consola: "^3.4.2",
+    "next-intl": "^4.1.0",
     "p-retry": "^7.0.0",
     swr: "^2.3.7",
     tsup: "^8.5.0",

package/dist/config.js

@@ -4,7 +4,7 @@ import { createExtensionConfig } from "@djangocfg/ext-base";
 // package.json
 var package_default = {
   name: "@djangocfg/ext-newsletter",
-  version: "1.0.21",
+  version: "1.0.23",
   description: "Newsletter and subscription management extension for DjangoCFG",
   keywords: [
     "django",
@@ -50,6 +50,11 @@ var package_default = {
       types: "./dist/config.d.ts",
       import: "./dist/config.js",
       require: "./dist/config.cjs"
+    },
+    "./i18n": {
+      types: "./dist/i18n.d.ts",
+      import: "./dist/i18n.js",
+      require: "./dist/i18n.cjs"
     }
   },
   files: [
@@ -65,10 +70,12 @@ var package_default = {
   peerDependencies: {
     "@djangocfg/api": "workspace:*",
     "@djangocfg/ext-base": "workspace:*",
+    "@djangocfg/i18n": "workspace:*",
     "@djangocfg/ui-core": "workspace:*",
     consola: "^3.4.2",
     "lucide-react": "^0.545.0",
     next: "^16",
+    "next-intl": "^4",
     "p-retry": "^7.0.0",
     react: "^19",
     "react-dom": "^19",
@@ -78,10 +85,12 @@ var package_default = {
   devDependencies: {
     "@djangocfg/api": "workspace:*",
     "@djangocfg/ext-base": "workspace:*",
+    "@djangocfg/i18n": "workspace:*",
     "@djangocfg/typescript-config": "workspace:*",
     "@types/node": "^24.7.2",
     "@types/react": "^19.0.0",
     consola: "^3.4.2",
+    "next-intl": "^4.1.0",
     "p-retry": "^7.0.0",
     swr: "^2.3.7",
     tsup: "^8.5.0",

package/dist/hooks.cjs

@@ -10,6 +10,7 @@ var react = require('react');
 var hooks = require('@djangocfg/ext-base/hooks');
 var jsxRuntime = require('react/jsx-runtime');
 var lucideReact = require('lucide-react');
+var nextIntl = require('next-intl');
 var uiCore = require('@djangocfg/ui-core');
 
 function _interopDefault (e) { return e && e.__esModule ? e : { default: e }; }
@@ -2124,7 +2125,7 @@ var apiNewsletter = api.createExtensionAPI(API);
 // package.json
 var package_default = {
   name: "@djangocfg/ext-newsletter",
-  version: "1.0.21",
+  version: "1.0.23",
   description: "Newsletter and subscription management extension for DjangoCFG",
   keywords: [
     "django",
@@ -2170,6 +2171,11 @@ var package_default = {
       types: "./dist/config.d.ts",
       import: "./dist/config.js",
       require: "./dist/config.cjs"
+    },
+    "./i18n": {
+      types: "./dist/i18n.d.ts",
+      import: "./dist/i18n.js",
+      require: "./dist/i18n.cjs"
     }
   },
   files: [
@@ -2185,10 +2191,12 @@ var package_default = {
   peerDependencies: {
     "@djangocfg/api": "workspace:*",
     "@djangocfg/ext-base": "workspace:*",
+    "@djangocfg/i18n": "workspace:*",
     "@djangocfg/ui-core": "workspace:*",
     consola: "^3.4.2",
     "lucide-react": "^0.545.0",
     next: "^16",
+    "next-intl": "^4",
     "p-retry": "^7.0.0",
     react: "^19",
     "react-dom": "^19",
@@ -2198,10 +2206,12 @@ var package_default = {
   devDependencies: {
     "@djangocfg/api": "workspace:*",
     "@djangocfg/ext-base": "workspace:*",
+    "@djangocfg/i18n": "workspace:*",
     "@djangocfg/typescript-config": "workspace:*",
     "@types/node": "^24.7.2",
     "@types/react": "^19.0.0",
     consola: "^3.4.2",
+    "next-intl": "^4.1.0",
     "p-retry": "^7.0.0",
     swr: "^2.3.7",
     tsup: "^8.5.0",
@@ -2476,6 +2486,65 @@ function useNewsletterContext() {
   }
   return context;
 }
+
+// src/i18n/locales/en.ts
+var en = {
+  hero: {
+    placeholder: "Enter your email",
+    subscribe: "Subscribe",
+    subscribing: "Subscribing...",
+    successMessage: "Successfully subscribed!",
+    errorMessage: "Subscription failed. Please try again.",
+    privacyNotice: "By subscribing, you agree to our Privacy Policy and consent to receive updates."
+  }
+};
+
+// src/i18n/locales/ru.ts
+var ru = {
+  hero: {
+    placeholder: "\u0412\u0432\u0435\u0434\u0438\u0442\u0435 email",
+    subscribe: "\u041F\u043E\u0434\u043F\u0438\u0441\u0430\u0442\u044C\u0441\u044F",
+    subscribing: "\u041F\u043E\u0434\u043F\u0438\u0441\u043A\u0430...",
+    successMessage: "\u0412\u044B \u0443\u0441\u043F\u0435\u0448\u043D\u043E \u043F\u043E\u0434\u043F\u0438\u0441\u0430\u043B\u0438\u0441\u044C!",
+    errorMessage: "\u041D\u0435 \u0443\u0434\u0430\u043B\u043E\u0441\u044C \u043F\u043E\u0434\u043F\u0438\u0441\u0430\u0442\u044C\u0441\u044F. \u041F\u043E\u043F\u0440\u043E\u0431\u0443\u0439\u0442\u0435 \u0435\u0449\u0451 \u0440\u0430\u0437.",
+    privacyNotice: "\u041F\u043E\u0434\u043F\u0438\u0441\u044B\u0432\u0430\u044F\u0441\u044C, \u0432\u044B \u0441\u043E\u0433\u043B\u0430\u0448\u0430\u0435\u0442\u0435\u0441\u044C \u0441 \u041F\u043E\u043B\u0438\u0442\u0438\u043A\u043E\u0439 \u043A\u043E\u043D\u0444\u0438\u0434\u0435\u043D\u0446\u0438\u0430\u043B\u044C\u043D\u043E\u0441\u0442\u0438 \u0438 \u0434\u0430\u0451\u0442\u0435 \u0441\u043E\u0433\u043B\u0430\u0441\u0438\u0435 \u043D\u0430 \u043F\u043E\u043B\u0443\u0447\u0435\u043D\u0438\u0435 \u043E\u0431\u043D\u043E\u0432\u043B\u0435\u043D\u0438\u0439."
+  }
+};
+
+// src/i18n/locales/ko.ts
+var ko = {
+  hero: {
+    placeholder: "\uC774\uBA54\uC77C\uC744 \uC785\uB825\uD558\uC138\uC694",
+    subscribe: "\uAD6C\uB3C5\uD558\uAE30",
+    subscribing: "\uAD6C\uB3C5 \uC911...",
+    successMessage: "\uC131\uACF5\uC801\uC73C\uB85C \uAD6C\uB3C5\uB418\uC5C8\uC2B5\uB2C8\uB2E4!",
+    errorMessage: "\uAD6C\uB3C5\uC5D0 \uC2E4\uD328\uD588\uC2B5\uB2C8\uB2E4. \uB2E4\uC2DC \uC2DC\uB3C4\uD574 \uC8FC\uC138\uC694.",
+    privacyNotice: "\uAD6C\uB3C5 \uC2DC \uAC1C\uC778\uC815\uBCF4 \uCC98\uB9AC\uBC29\uCE68\uC5D0 \uB3D9\uC758\uD558\uACE0 \uC5C5\uB370\uC774\uD2B8 \uC218\uC2E0\uC5D0 \uB3D9\uC758\uD558\uB294 \uAC83\uC73C\uB85C \uAC04\uC8FC\uB429\uB2C8\uB2E4."
+  }
+};
+
+// src/i18n/useNewsletterT.ts
+var translations = { en, ru, ko };
+function getNestedValue(obj, path) {
+  const keys = path.split(".");
+  let result = obj;
+  for (const key of keys) {
+    if (result && typeof result === "object" && key in result) {
+      result = result[key];
+    } else {
+      return path;
+    }
+  }
+  return typeof result === "string" ? result : path;
+}
+function useNewsletterT() {
+  const locale = nextIntl.useLocale();
+  const t = react.useMemo(() => translations[locale] || translations.en, [locale]);
+  return react.useCallback(
+    (key) => getNestedValue(t, key),
+    [t]
+  );
+}
 var isDevelopment = process.env.NODE_ENV === "development";
 var logger = consola.createConsola({
   level: isDevelopment ? 4 : 1
@@ -2487,15 +2556,24 @@ function Hero({
   primaryAction,
   secondaryAction,
   showNewsletter = true,
-  newsletterPlaceholder = "Enter your email",
-  newsletterButtonText = "Subscribe",
+  newsletterPlaceholder,
+  newsletterButtonText,
   onNewsletterSubmit,
   className = ""
 }) {
+  const nt = useNewsletterT();
   const [email, setEmail] = react.useState("");
   const [isLoading, setIsLoading] = react.useState(false);
   const [status, setStatus] = react.useState("idle");
   const [message, setMessage] = react.useState("");
+  const labels = react.useMemo(() => ({
+    placeholder: newsletterPlaceholder ?? nt("hero.placeholder"),
+    subscribe: newsletterButtonText ?? nt("hero.subscribe"),
+    subscribing: nt("hero.subscribing"),
+    successMessage: nt("hero.successMessage"),
+    errorMessage: nt("hero.errorMessage"),
+    privacyNotice: nt("hero.privacyNotice")
+  }), [nt, newsletterPlaceholder, newsletterButtonText]);
   const handleSubmit = async (e) => {
     e.preventDefault();
     if (!email || !onNewsletterSubmit) return;
@@ -2505,12 +2583,12 @@ function Hero({
     try {
       const result = await onNewsletterSubmit(email);
       setStatus("success");
-      setMessage((result && "message" in result ? result.message : void 0) || "Successfully subscribed!");
+      setMessage((result && "message" in result ? result.message : void 0) || labels.successMessage);
       setEmail("");
       newsletterLogger.success("Newsletter subscription successful:", email);
     } catch (error) {
       setStatus("error");
-      setMessage(error instanceof Error ? error.message : "Subscription failed. Please try again.");
+      setMessage(error instanceof Error ? error.message : labels.errorMessage);
       newsletterLogger.error("Newsletter subscription failed:", error);
     } finally {
       setIsLoading(false);
@@ -2553,7 +2631,7 @@ function Hero({
               uiCore.Input,
               {
                 type: "email",
-                placeholder: newsletterPlaceholder,
+                placeholder: labels.placeholder,
                 value: email,
                 onChange: (e) => setEmail(e.target.value),
                 disabled: isLoading,
@@ -2570,8 +2648,8 @@ function Hero({
               className: "w-full sm:w-auto",
               children: isLoading ? /* @__PURE__ */ jsxRuntime.jsxs(jsxRuntime.Fragment, { children: [
                 /* @__PURE__ */ jsxRuntime.jsx(lucideReact.Loader2, { className: "mr-2 h-4 w-4 animate-spin" }),
-                "Subscribing..."
-              ] }) : newsletterButtonText
+                labels.subscribing
+              ] }) : labels.subscribe
             }
           )
         ] }),
@@ -2584,7 +2662,7 @@ function Hero({
           /* @__PURE__ */ jsxRuntime.jsx("span", { children: message })
         ] })
       ] }),
-      /* @__PURE__ */ jsxRuntime.jsx("p", { className: "text-xs text-muted-foreground mt-3", children: "By subscribing, you agree to our Privacy Policy and consent to receive updates." })
+      /* @__PURE__ */ jsxRuntime.jsx("p", { className: "text-xs text-muted-foreground mt-3", children: labels.privacyNotice })
     ] })
   ] }) }) });
 }

package/dist/hooks.js

@@ -4,10 +4,11 @@ import { z } from 'zod';
 import { initializeExtensionAPI, createExtensionAPI } from '@djangocfg/ext-base/api';
 import { createExtensionConfig } from '@djangocfg/ext-base';
 import useSWR, { useSWRConfig } from 'swr';
-import { createContext, useContext, useState } from 'react';
+import { createContext, useContext, useState, useMemo, useCallback } from 'react';
 import { ExtensionProvider } from '@djangocfg/ext-base/hooks';
 import { jsx, jsxs, Fragment } from 'react/jsx-runtime';
 import { Mail, Loader2, CheckCircle2, AlertCircle } from 'lucide-react';
+import { useLocale } from 'next-intl';
 import { Button, Input } from '@djangocfg/ui-core';
 
 var __defProp = Object.defineProperty;
@@ -2117,7 +2118,7 @@ var apiNewsletter = createExtensionAPI(API);
 // package.json
 var package_default = {
   name: "@djangocfg/ext-newsletter",
-  version: "1.0.21",
+  version: "1.0.23",
   description: "Newsletter and subscription management extension for DjangoCFG",
   keywords: [
     "django",
@@ -2163,6 +2164,11 @@ var package_default = {
       types: "./dist/config.d.ts",
       import: "./dist/config.js",
       require: "./dist/config.cjs"
+    },
+    "./i18n": {
+      types: "./dist/i18n.d.ts",
+      import: "./dist/i18n.js",
+      require: "./dist/i18n.cjs"
     }
   },
   files: [
@@ -2178,10 +2184,12 @@ var package_default = {
   peerDependencies: {
     "@djangocfg/api": "workspace:*",
     "@djangocfg/ext-base": "workspace:*",
+    "@djangocfg/i18n": "workspace:*",
     "@djangocfg/ui-core": "workspace:*",
     consola: "^3.4.2",
     "lucide-react": "^0.545.0",
     next: "^16",
+    "next-intl": "^4",
     "p-retry": "^7.0.0",
     react: "^19",
     "react-dom": "^19",
@@ -2191,10 +2199,12 @@ var package_default = {
   devDependencies: {
     "@djangocfg/api": "workspace:*",
     "@djangocfg/ext-base": "workspace:*",
+    "@djangocfg/i18n": "workspace:*",
     "@djangocfg/typescript-config": "workspace:*",
     "@types/node": "^24.7.2",
     "@types/react": "^19.0.0",
     consola: "^3.4.2",
+    "next-intl": "^4.1.0",
     "p-retry": "^7.0.0",
     swr: "^2.3.7",
     tsup: "^8.5.0",
@@ -2469,6 +2479,65 @@ function useNewsletterContext() {
   }
   return context;
 }
+
+// src/i18n/locales/en.ts
+var en = {
+  hero: {
+    placeholder: "Enter your email",
+    subscribe: "Subscribe",
+    subscribing: "Subscribing...",
+    successMessage: "Successfully subscribed!",
+    errorMessage: "Subscription failed. Please try again.",
+    privacyNotice: "By subscribing, you agree to our Privacy Policy and consent to receive updates."
+  }
+};
+
+// src/i18n/locales/ru.ts
+var ru = {
+  hero: {
+    placeholder: "\u0412\u0432\u0435\u0434\u0438\u0442\u0435 email",
+    subscribe: "\u041F\u043E\u0434\u043F\u0438\u0441\u0430\u0442\u044C\u0441\u044F",
+    subscribing: "\u041F\u043E\u0434\u043F\u0438\u0441\u043A\u0430...",
+    successMessage: "\u0412\u044B \u0443\u0441\u043F\u0435\u0448\u043D\u043E \u043F\u043E\u0434\u043F\u0438\u0441\u0430\u043B\u0438\u0441\u044C!",
+    errorMessage: "\u041D\u0435 \u0443\u0434\u0430\u043B\u043E\u0441\u044C \u043F\u043E\u0434\u043F\u0438\u0441\u0430\u0442\u044C\u0441\u044F. \u041F\u043E\u043F\u0440\u043E\u0431\u0443\u0439\u0442\u0435 \u0435\u0449\u0451 \u0440\u0430\u0437.",
+    privacyNotice: "\u041F\u043E\u0434\u043F\u0438\u0441\u044B\u0432\u0430\u044F\u0441\u044C, \u0432\u044B \u0441\u043E\u0433\u043B\u0430\u0448\u0430\u0435\u0442\u0435\u0441\u044C \u0441 \u041F\u043E\u043B\u0438\u0442\u0438\u043A\u043E\u0439 \u043A\u043E\u043D\u0444\u0438\u0434\u0435\u043D\u0446\u0438\u0430\u043B\u044C\u043D\u043E\u0441\u0442\u0438 \u0438 \u0434\u0430\u0451\u0442\u0435 \u0441\u043E\u0433\u043B\u0430\u0441\u0438\u0435 \u043D\u0430 \u043F\u043E\u043B\u0443\u0447\u0435\u043D\u0438\u0435 \u043E\u0431\u043D\u043E\u0432\u043B\u0435\u043D\u0438\u0439."
+  }
+};
+
+// src/i18n/locales/ko.ts
+var ko = {
+  hero: {
+    placeholder: "\uC774\uBA54\uC77C\uC744 \uC785\uB825\uD558\uC138\uC694",
+    subscribe: "\uAD6C\uB3C5\uD558\uAE30",
+    subscribing: "\uAD6C\uB3C5 \uC911...",
+    successMessage: "\uC131\uACF5\uC801\uC73C\uB85C \uAD6C\uB3C5\uB418\uC5C8\uC2B5\uB2C8\uB2E4!",
+    errorMessage: "\uAD6C\uB3C5\uC5D0 \uC2E4\uD328\uD588\uC2B5\uB2C8\uB2E4. \uB2E4\uC2DC \uC2DC\uB3C4\uD574 \uC8FC\uC138\uC694.",
+    privacyNotice: "\uAD6C\uB3C5 \uC2DC \uAC1C\uC778\uC815\uBCF4 \uCC98\uB9AC\uBC29\uCE68\uC5D0 \uB3D9\uC758\uD558\uACE0 \uC5C5\uB370\uC774\uD2B8 \uC218\uC2E0\uC5D0 \uB3D9\uC758\uD558\uB294 \uAC83\uC73C\uB85C \uAC04\uC8FC\uB429\uB2C8\uB2E4."
+  }
+};
+
+// src/i18n/useNewsletterT.ts
+var translations = { en, ru, ko };
+function getNestedValue(obj, path) {
+  const keys = path.split(".");
+  let result = obj;
+  for (const key of keys) {
+    if (result && typeof result === "object" && key in result) {
+      result = result[key];
+    } else {
+      return path;
+    }
+  }
+  return typeof result === "string" ? result : path;
+}
+function useNewsletterT() {
+  const locale = useLocale();
+  const t = useMemo(() => translations[locale] || translations.en, [locale]);
+  return useCallback(
+    (key) => getNestedValue(t, key),
+    [t]
+  );
+}
 var isDevelopment = process.env.NODE_ENV === "development";
 var logger = createConsola({
   level: isDevelopment ? 4 : 1
@@ -2480,15 +2549,24 @@ function Hero({
   primaryAction,
   secondaryAction,
   showNewsletter = true,
-  newsletterPlaceholder = "Enter your email",
-  newsletterButtonText = "Subscribe",
+  newsletterPlaceholder,
+  newsletterButtonText,
   onNewsletterSubmit,
   className = ""
 }) {
+  const nt = useNewsletterT();
   const [email, setEmail] = useState("");
   const [isLoading, setIsLoading] = useState(false);
   const [status, setStatus] = useState("idle");
   const [message, setMessage] = useState("");
+  const labels = useMemo(() => ({
+    placeholder: newsletterPlaceholder ?? nt("hero.placeholder"),
+    subscribe: newsletterButtonText ?? nt("hero.subscribe"),
+    subscribing: nt("hero.subscribing"),
+    successMessage: nt("hero.successMessage"),
+    errorMessage: nt("hero.errorMessage"),
+    privacyNotice: nt("hero.privacyNotice")
+  }), [nt, newsletterPlaceholder, newsletterButtonText]);
   const handleSubmit = async (e) => {
     e.preventDefault();
     if (!email || !onNewsletterSubmit) return;
@@ -2498,12 +2576,12 @@ function Hero({
     try {
       const result = await onNewsletterSubmit(email);
       setStatus("success");
-      setMessage((result && "message" in result ? result.message : void 0) || "Successfully subscribed!");
+      setMessage((result && "message" in result ? result.message : void 0) || labels.successMessage);
       setEmail("");
       newsletterLogger.success("Newsletter subscription successful:", email);
     } catch (error) {
       setStatus("error");
-      setMessage(error instanceof Error ? error.message : "Subscription failed. Please try again.");
+      setMessage(error instanceof Error ? error.message : labels.errorMessage);
       newsletterLogger.error("Newsletter subscription failed:", error);
     } finally {
       setIsLoading(false);
@@ -2546,7 +2624,7 @@ function Hero({
               Input,
               {
                 type: "email",
-                placeholder: newsletterPlaceholder,
+                placeholder: labels.placeholder,
                 value: email,
                 onChange: (e) => setEmail(e.target.value),
                 disabled: isLoading,
@@ -2563,8 +2641,8 @@ function Hero({
               className: "w-full sm:w-auto",
               children: isLoading ? /* @__PURE__ */ jsxs(Fragment, { children: [
                 /* @__PURE__ */ jsx(Loader2, { className: "mr-2 h-4 w-4 animate-spin" }),
-                "Subscribing..."
-              ] }) : newsletterButtonText
+                labels.subscribing
+              ] }) : labels.subscribe
             }
           )
         ] }),
@@ -2577,7 +2655,7 @@ function Hero({
           /* @__PURE__ */ jsx("span", { children: message })
         ] })
       ] }),
-      /* @__PURE__ */ jsx("p", { className: "text-xs text-muted-foreground mt-3", children: "By subscribing, you agree to our Privacy Policy and consent to receive updates." })
+      /* @__PURE__ */ jsx("p", { className: "text-xs text-muted-foreground mt-3", children: labels.privacyNotice })
     ] })
   ] }) }) });
 }

package/dist/i18n.cjs

@@ -0,0 +1,98 @@
+"use client";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/i18n/index.ts
+var i18n_exports = {};
+__export(i18n_exports, {
+  en: () => en,
+  ko: () => ko,
+  ru: () => ru,
+  useNewsletterT: () => useNewsletterT
+});
+module.exports = __toCommonJS(i18n_exports);
+
+// src/i18n/useNewsletterT.ts
+var import_next_intl = require("next-intl");
+var import_react = require("react");
+
+// src/i18n/locales/en.ts
+var en = {
+  hero: {
+    placeholder: "Enter your email",
+    subscribe: "Subscribe",
+    subscribing: "Subscribing...",
+    successMessage: "Successfully subscribed!",
+    errorMessage: "Subscription failed. Please try again.",
+    privacyNotice: "By subscribing, you agree to our Privacy Policy and consent to receive updates."
+  }
+};
+
+// src/i18n/locales/ru.ts
+var ru = {
+  hero: {
+    placeholder: "\u0412\u0432\u0435\u0434\u0438\u0442\u0435 email",
+    subscribe: "\u041F\u043E\u0434\u043F\u0438\u0441\u0430\u0442\u044C\u0441\u044F",
+    subscribing: "\u041F\u043E\u0434\u043F\u0438\u0441\u043A\u0430...",
+    successMessage: "\u0412\u044B \u0443\u0441\u043F\u0435\u0448\u043D\u043E \u043F\u043E\u0434\u043F\u0438\u0441\u0430\u043B\u0438\u0441\u044C!",
+    errorMessage: "\u041D\u0435 \u0443\u0434\u0430\u043B\u043E\u0441\u044C \u043F\u043E\u0434\u043F\u0438\u0441\u0430\u0442\u044C\u0441\u044F. \u041F\u043E\u043F\u0440\u043E\u0431\u0443\u0439\u0442\u0435 \u0435\u0449\u0451 \u0440\u0430\u0437.",
+    privacyNotice: "\u041F\u043E\u0434\u043F\u0438\u0441\u044B\u0432\u0430\u044F\u0441\u044C, \u0432\u044B \u0441\u043E\u0433\u043B\u0430\u0448\u0430\u0435\u0442\u0435\u0441\u044C \u0441 \u041F\u043E\u043B\u0438\u0442\u0438\u043A\u043E\u0439 \u043A\u043E\u043D\u0444\u0438\u0434\u0435\u043D\u0446\u0438\u0430\u043B\u044C\u043D\u043E\u0441\u0442\u0438 \u0438 \u0434\u0430\u0451\u0442\u0435 \u0441\u043E\u0433\u043B\u0430\u0441\u0438\u0435 \u043D\u0430 \u043F\u043E\u043B\u0443\u0447\u0435\u043D\u0438\u0435 \u043E\u0431\u043D\u043E\u0432\u043B\u0435\u043D\u0438\u0439."
+  }
+};
+
+// src/i18n/locales/ko.ts
+var ko = {
+  hero: {
+    placeholder: "\uC774\uBA54\uC77C\uC744 \uC785\uB825\uD558\uC138\uC694",
+    subscribe: "\uAD6C\uB3C5\uD558\uAE30",
+    subscribing: "\uAD6C\uB3C5 \uC911...",
+    successMessage: "\uC131\uACF5\uC801\uC73C\uB85C \uAD6C\uB3C5\uB418\uC5C8\uC2B5\uB2C8\uB2E4!",
+    errorMessage: "\uAD6C\uB3C5\uC5D0 \uC2E4\uD328\uD588\uC2B5\uB2C8\uB2E4. \uB2E4\uC2DC \uC2DC\uB3C4\uD574 \uC8FC\uC138\uC694.",
+    privacyNotice: "\uAD6C\uB3C5 \uC2DC \uAC1C\uC778\uC815\uBCF4 \uCC98\uB9AC\uBC29\uCE68\uC5D0 \uB3D9\uC758\uD558\uACE0 \uC5C5\uB370\uC774\uD2B8 \uC218\uC2E0\uC5D0 \uB3D9\uC758\uD558\uB294 \uAC83\uC73C\uB85C \uAC04\uC8FC\uB429\uB2C8\uB2E4."
+  }
+};
+
+// src/i18n/useNewsletterT.ts
+var translations = { en, ru, ko };
+function getNestedValue(obj, path) {
+  const keys = path.split(".");
+  let result = obj;
+  for (const key of keys) {
+    if (result && typeof result === "object" && key in result) {
+      result = result[key];
+    } else {
+      return path;
+    }
+  }
+  return typeof result === "string" ? result : path;
+}
+function useNewsletterT() {
+  const locale = (0, import_next_intl.useLocale)();
+  const t = (0, import_react.useMemo)(() => translations[locale] || translations.en, [locale]);
+  return (0, import_react.useCallback)(
+    (key) => getNestedValue(t, key),
+    [t]
+  );
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  en,
+  ko,
+  ru,
+  useNewsletterT
+});

package/dist/i18n.d.cts

@@ -0,0 +1,48 @@
+/**
+ * Newsletter Extension I18n Types
+ */
+/**
+ * Helper type to get dot-notation paths from nested object
+ */
+type PathKeys<T, Prefix extends string = ''> = T extends object ? {
+    [K in keyof T]: K extends string ? T[K] extends object ? PathKeys<T[K], `${Prefix}${K}.`> : `${Prefix}${K}` : never;
+}[keyof T] : never;
+/**
+ * Keys for newsletter translations
+ */
+type NewsletterLocalKeys = PathKeys<NewsletterTranslations>;
+interface NewsletterTranslations {
+    /** Hero */
+    hero: {
+        placeholder: string;
+        subscribe: string;
+        subscribing: string;
+        successMessage: string;
+        errorMessage: string;
+        privacyNotice: string;
+    };
+}
+
+/**
+ * Self-contained translation hook for newsletter extension
+ *
+ * Uses built-in translations based on current locale from next-intl.
+ * No need to add translations to app's i18n config.
+ *
+ * @example
+ * ```tsx
+ * function SubscribeForm() {
+ *   const t = useNewsletterT();
+ *   return <button>{t('hero.subscribe')}</button>;
+ * }
+ * ```
+ */
+declare function useNewsletterT(): (key: NewsletterLocalKeys) => string;
+
+declare const en: NewsletterTranslations;
+
+declare const ru: NewsletterTranslations;
+
+declare const ko: NewsletterTranslations;
+
+export { type NewsletterLocalKeys, type NewsletterTranslations, en, ko, ru, useNewsletterT };

package/dist/i18n.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Newsletter Extension I18n Types
+ */
+/**
+ * Helper type to get dot-notation paths from nested object
+ */
+type PathKeys<T, Prefix extends string = ''> = T extends object ? {
+    [K in keyof T]: K extends string ? T[K] extends object ? PathKeys<T[K], `${Prefix}${K}.`> : `${Prefix}${K}` : never;
+}[keyof T] : never;
+/**
+ * Keys for newsletter translations
+ */
+type NewsletterLocalKeys = PathKeys<NewsletterTranslations>;
+interface NewsletterTranslations {
+    /** Hero */
+    hero: {
+        placeholder: string;
+        subscribe: string;
+        subscribing: string;
+        successMessage: string;
+        errorMessage: string;
+        privacyNotice: string;
+    };
+}
+
+/**
+ * Self-contained translation hook for newsletter extension
+ *
+ * Uses built-in translations based on current locale from next-intl.
+ * No need to add translations to app's i18n config.
+ *
+ * @example
+ * ```tsx
+ * function SubscribeForm() {
+ *   const t = useNewsletterT();
+ *   return <button>{t('hero.subscribe')}</button>;
+ * }
+ * ```
+ */
+declare function useNewsletterT(): (key: NewsletterLocalKeys) => string;
+
+declare const en: NewsletterTranslations;
+
+declare const ru: NewsletterTranslations;
+
+declare const ko: NewsletterTranslations;
+
+export { type NewsletterLocalKeys, type NewsletterTranslations, en, ko, ru, useNewsletterT };

package/dist/i18n.js

@@ -0,0 +1,70 @@
+"use client";
+
+// src/i18n/useNewsletterT.ts
+import { useLocale } from "next-intl";
+import { useMemo, useCallback } from "react";
+
+// src/i18n/locales/en.ts
+var en = {
+  hero: {
+    placeholder: "Enter your email",
+    subscribe: "Subscribe",
+    subscribing: "Subscribing...",
+    successMessage: "Successfully subscribed!",
+    errorMessage: "Subscription failed. Please try again.",
+    privacyNotice: "By subscribing, you agree to our Privacy Policy and consent to receive updates."
+  }
+};
+
+// src/i18n/locales/ru.ts
+var ru = {
+  hero: {
+    placeholder: "\u0412\u0432\u0435\u0434\u0438\u0442\u0435 email",
+    subscribe: "\u041F\u043E\u0434\u043F\u0438\u0441\u0430\u0442\u044C\u0441\u044F",
+    subscribing: "\u041F\u043E\u0434\u043F\u0438\u0441\u043A\u0430...",
+    successMessage: "\u0412\u044B \u0443\u0441\u043F\u0435\u0448\u043D\u043E \u043F\u043E\u0434\u043F\u0438\u0441\u0430\u043B\u0438\u0441\u044C!",
+    errorMessage: "\u041D\u0435 \u0443\u0434\u0430\u043B\u043E\u0441\u044C \u043F\u043E\u0434\u043F\u0438\u0441\u0430\u0442\u044C\u0441\u044F. \u041F\u043E\u043F\u0440\u043E\u0431\u0443\u0439\u0442\u0435 \u0435\u0449\u0451 \u0440\u0430\u0437.",
+    privacyNotice: "\u041F\u043E\u0434\u043F\u0438\u0441\u044B\u0432\u0430\u044F\u0441\u044C, \u0432\u044B \u0441\u043E\u0433\u043B\u0430\u0448\u0430\u0435\u0442\u0435\u0441\u044C \u0441 \u041F\u043E\u043B\u0438\u0442\u0438\u043A\u043E\u0439 \u043A\u043E\u043D\u0444\u0438\u0434\u0435\u043D\u0446\u0438\u0430\u043B\u044C\u043D\u043E\u0441\u0442\u0438 \u0438 \u0434\u0430\u0451\u0442\u0435 \u0441\u043E\u0433\u043B\u0430\u0441\u0438\u0435 \u043D\u0430 \u043F\u043E\u043B\u0443\u0447\u0435\u043D\u0438\u0435 \u043E\u0431\u043D\u043E\u0432\u043B\u0435\u043D\u0438\u0439."
+  }
+};
+
+// src/i18n/locales/ko.ts
+var ko = {
+  hero: {
+    placeholder: "\uC774\uBA54\uC77C\uC744 \uC785\uB825\uD558\uC138\uC694",
+    subscribe: "\uAD6C\uB3C5\uD558\uAE30",
+    subscribing: "\uAD6C\uB3C5 \uC911...",
+    successMessage: "\uC131\uACF5\uC801\uC73C\uB85C \uAD6C\uB3C5\uB418\uC5C8\uC2B5\uB2C8\uB2E4!",
+    errorMessage: "\uAD6C\uB3C5\uC5D0 \uC2E4\uD328\uD588\uC2B5\uB2C8\uB2E4. \uB2E4\uC2DC \uC2DC\uB3C4\uD574 \uC8FC\uC138\uC694.",
+    privacyNotice: "\uAD6C\uB3C5 \uC2DC \uAC1C\uC778\uC815\uBCF4 \uCC98\uB9AC\uBC29\uCE68\uC5D0 \uB3D9\uC758\uD558\uACE0 \uC5C5\uB370\uC774\uD2B8 \uC218\uC2E0\uC5D0 \uB3D9\uC758\uD558\uB294 \uAC83\uC73C\uB85C \uAC04\uC8FC\uB429\uB2C8\uB2E4."
+  }
+};
+
+// src/i18n/useNewsletterT.ts
+var translations = { en, ru, ko };
+function getNestedValue(obj, path) {
+  const keys = path.split(".");
+  let result = obj;
+  for (const key of keys) {
+    if (result && typeof result === "object" && key in result) {
+      result = result[key];
+    } else {
+      return path;
+    }
+  }
+  return typeof result === "string" ? result : path;
+}
+function useNewsletterT() {
+  const locale = useLocale();
+  const t = useMemo(() => translations[locale] || translations.en, [locale]);
+  return useCallback(
+    (key) => getNestedValue(t, key),
+    [t]
+  );
+}
+export {
+  en,
+  ko,
+  ru,
+  useNewsletterT
+};

package/dist/index.cjs

@@ -2117,7 +2117,7 @@ var apiNewsletter = api.createExtensionAPI(API);
 // package.json
 var package_default = {
   name: "@djangocfg/ext-newsletter",
-  version: "1.0.21",
+  version: "1.0.23",
   description: "Newsletter and subscription management extension for DjangoCFG",
   keywords: [
     "django",
@@ -2163,6 +2163,11 @@ var package_default = {
       types: "./dist/config.d.ts",
       import: "./dist/config.js",
       require: "./dist/config.cjs"
+    },
+    "./i18n": {
+      types: "./dist/i18n.d.ts",
+      import: "./dist/i18n.js",
+      require: "./dist/i18n.cjs"
     }
   },
   files: [
@@ -2178,10 +2183,12 @@ var package_default = {
   peerDependencies: {
     "@djangocfg/api": "workspace:*",
     "@djangocfg/ext-base": "workspace:*",
+    "@djangocfg/i18n": "workspace:*",
     "@djangocfg/ui-core": "workspace:*",
     consola: "^3.4.2",
     "lucide-react": "^0.545.0",
     next: "^16",
+    "next-intl": "^4",
     "p-retry": "^7.0.0",
     react: "^19",
     "react-dom": "^19",
@@ -2191,10 +2198,12 @@ var package_default = {
   devDependencies: {
     "@djangocfg/api": "workspace:*",
     "@djangocfg/ext-base": "workspace:*",
+    "@djangocfg/i18n": "workspace:*",
     "@djangocfg/typescript-config": "workspace:*",
     "@types/node": "^24.7.2",
     "@types/react": "^19.0.0",
     consola: "^3.4.2",
+    "next-intl": "^4.1.0",
     "p-retry": "^7.0.0",
     swr: "^2.3.7",
     tsup: "^8.5.0",

package/dist/index.js

@@ -2111,7 +2111,7 @@ var apiNewsletter = createExtensionAPI(API);
 // package.json
 var package_default = {
   name: "@djangocfg/ext-newsletter",
-  version: "1.0.21",
+  version: "1.0.23",
   description: "Newsletter and subscription management extension for DjangoCFG",
   keywords: [
     "django",
@@ -2157,6 +2157,11 @@ var package_default = {
       types: "./dist/config.d.ts",
       import: "./dist/config.js",
       require: "./dist/config.cjs"
+    },
+    "./i18n": {
+      types: "./dist/i18n.d.ts",
+      import: "./dist/i18n.js",
+      require: "./dist/i18n.cjs"
     }
   },
   files: [
@@ -2172,10 +2177,12 @@ var package_default = {
   peerDependencies: {
     "@djangocfg/api": "workspace:*",
     "@djangocfg/ext-base": "workspace:*",
+    "@djangocfg/i18n": "workspace:*",
     "@djangocfg/ui-core": "workspace:*",
     consola: "^3.4.2",
     "lucide-react": "^0.545.0",
     next: "^16",
+    "next-intl": "^4",
     "p-retry": "^7.0.0",
     react: "^19",
     "react-dom": "^19",
@@ -2185,10 +2192,12 @@ var package_default = {
   devDependencies: {
     "@djangocfg/api": "workspace:*",
     "@djangocfg/ext-base": "workspace:*",
+    "@djangocfg/i18n": "workspace:*",
     "@djangocfg/typescript-config": "workspace:*",
     "@types/node": "^24.7.2",
     "@types/react": "^19.0.0",
     consola: "^3.4.2",
+    "next-intl": "^4.1.0",
     "p-retry": "^7.0.0",
     swr: "^2.3.7",
     tsup: "^8.5.0",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@djangocfg/ext-newsletter",
-  "version": "1.0.21",
+  "version": "1.0.23",
   "description": "Newsletter and subscription management extension for DjangoCFG",
   "keywords": [
     "django",
@@ -46,6 +46,11 @@
       "types": "./dist/config.d.ts",
       "import": "./dist/config.js",
       "require": "./dist/config.cjs"
+    },
+    "./i18n": {
+      "types": "./dist/i18n.d.ts",
+      "import": "./dist/i18n.js",
+      "require": "./dist/i18n.cjs"
     }
   },
   "files": [
@@ -59,12 +64,14 @@
     "check": "tsc --noEmit"
   },
   "peerDependencies": {
-    "@djangocfg/api": "^2.1.109",
-    "@djangocfg/ext-base": "^1.0.16",
-    "@djangocfg/ui-core": "^2.1.109",
+    "@djangocfg/api": "^2.1.124",
+    "@djangocfg/ext-base": "^1.0.18",
+    "@djangocfg/i18n": "^2.1.124",
+    "@djangocfg/ui-core": "^2.1.124",
     "consola": "^3.4.2",
     "lucide-react": "^0.545.0",
     "next": "^16",
+    "next-intl": "^4",
     "p-retry": "^7.0.0",
     "react": "^19",
     "react-dom": "^19",
@@ -72,12 +79,14 @@
     "zod": "^4.3.4"
   },
   "devDependencies": {
-    "@djangocfg/api": "^2.1.109",
-    "@djangocfg/ext-base": "^1.0.16",
-    "@djangocfg/typescript-config": "^2.1.109",
+    "@djangocfg/api": "^2.1.124",
+    "@djangocfg/ext-base": "^1.0.18",
+    "@djangocfg/i18n": "^2.1.124",
+    "@djangocfg/typescript-config": "^2.1.124",
     "@types/node": "^24.7.2",
     "@types/react": "^19.0.0",
     "consola": "^3.4.2",
+    "next-intl": "^4.1.0",
     "p-retry": "^7.0.0",
     "swr": "^2.3.7",
     "tsup": "^8.5.0",

package/src/components/Hero/index.tsx

@@ -6,8 +6,9 @@
 'use client';
 
 import { AlertCircle, CheckCircle2, Loader2, Mail } from 'lucide-react';
-import React, { useState } from 'react';
+import React, { useMemo, useState } from 'react';
 
+import { useNewsletterT } from '../../i18n';
 import { Button, Input } from '@djangocfg/ui-core';
 
 import { newsletterLogger } from '../../utils/logger';
@@ -20,16 +21,27 @@ export function Hero({
   primaryAction,
   secondaryAction,
   showNewsletter = true,
-  newsletterPlaceholder = 'Enter your email',
-  newsletterButtonText = 'Subscribe',
+  newsletterPlaceholder,
+  newsletterButtonText,
   onNewsletterSubmit,
   className = '',
 }: HeroProps) {
+  const nt = useNewsletterT();
   const [email, setEmail] = useState('');
   const [isLoading, setIsLoading] = useState(false);
   const [status, setStatus] = useState<'idle' | 'success' | 'error'>('idle');
   const [message, setMessage] = useState('');
 
+  // Prepare labels before JSX render
+  const labels = useMemo(() => ({
+    placeholder: newsletterPlaceholder ?? nt('hero.placeholder'),
+    subscribe: newsletterButtonText ?? nt('hero.subscribe'),
+    subscribing: nt('hero.subscribing'),
+    successMessage: nt('hero.successMessage'),
+    errorMessage: nt('hero.errorMessage'),
+    privacyNotice: nt('hero.privacyNotice'),
+  }), [nt, newsletterPlaceholder, newsletterButtonText]);
+
   const handleSubmit = async (e: React.FormEvent) => {
     e.preventDefault();
 
@@ -42,12 +54,12 @@ export function Hero({
     try {
       const result = await onNewsletterSubmit(email);
       setStatus('success');
-      setMessage((result && 'message' in result ? result.message : undefined) || 'Successfully subscribed!');
+      setMessage((result && 'message' in result ? result.message : undefined) || labels.successMessage);
       setEmail('');
       newsletterLogger.success('Newsletter subscription successful:', email);
     } catch (error) {
       setStatus('error');
-      setMessage(error instanceof Error ? error.message : 'Subscription failed. Please try again.');
+      setMessage(error instanceof Error ? error.message : labels.errorMessage);
       newsletterLogger.error('Newsletter subscription failed:', error);
     } finally {
       setIsLoading(false);
@@ -109,7 +121,7 @@ export function Hero({
                     <Mail className="absolute left-3 top-1/2 -translate-y-1/2 h-5 w-5 text-muted-foreground" />
                     <Input
                       type="email"
-                      placeholder={newsletterPlaceholder}
+                      placeholder={labels.placeholder}
                       value={email}
                       onChange={(e) => setEmail(e.target.value)}
                       disabled={isLoading}
@@ -125,10 +137,10 @@ export function Hero({
                     {isLoading ? (
                       <>
                         <Loader2 className="mr-2 h-4 w-4 animate-spin" />
-                        Subscribing...
+                        {labels.subscribing}
                       </>
                     ) : (
-                      newsletterButtonText
+                      labels.subscribe
                     )}
                   </Button>
                 </div>
@@ -150,7 +162,7 @@ export function Hero({
               </form>
 
               <p className="text-xs text-muted-foreground mt-3">
-                By subscribing, you agree to our Privacy Policy and consent to receive updates.
+                {labels.privacyNotice}
               </p>
             </div>
           )}

package/src/i18n/index.ts

@@ -0,0 +1,26 @@
+/**
+ * Newsletter Extension I18n
+ *
+ * Self-contained translations - no app configuration needed.
+ *
+ * @example
+ * ```tsx
+ * import { useNewsletterT } from '@djangocfg/ext-newsletter/i18n';
+ *
+ * function MyComponent() {
+ *   const t = useNewsletterT();
+ *   return <button>{t('hero.subscribe')}</button>;
+ * }
+ * ```
+ */
+
+// Self-contained hook (recommended)
+export { useNewsletterT } from './useNewsletterT';
+
+// Types
+export type { NewsletterTranslations, NewsletterLocalKeys } from './types';
+
+// Locales (for direct access if needed)
+export { en } from './locales/en';
+export { ru } from './locales/ru';
+export { ko } from './locales/ko';

package/src/i18n/locales/en.ts

@@ -0,0 +1,12 @@
+import type { NewsletterTranslations } from '../types';
+
+export const en: NewsletterTranslations = {
+  hero: {
+    placeholder: 'Enter your email',
+    subscribe: 'Subscribe',
+    subscribing: 'Subscribing...',
+    successMessage: 'Successfully subscribed!',
+    errorMessage: 'Subscription failed. Please try again.',
+    privacyNotice: 'By subscribing, you agree to our Privacy Policy and consent to receive updates.',
+  },
+};

package/src/i18n/locales/ko.ts

@@ -0,0 +1,12 @@
+import type { NewsletterTranslations } from '../types';
+
+export const ko: NewsletterTranslations = {
+  hero: {
+    placeholder: '이메일을 입력하세요',
+    subscribe: '구독하기',
+    subscribing: '구독 중...',
+    successMessage: '성공적으로 구독되었습니다!',
+    errorMessage: '구독에 실패했습니다. 다시 시도해 주세요.',
+    privacyNotice: '구독 시 개인정보 처리방침에 동의하고 업데이트 수신에 동의하는 것으로 간주됩니다.',
+  },
+};

package/src/i18n/locales/ru.ts

@@ -0,0 +1,12 @@
+import type { NewsletterTranslations } from '../types';
+
+export const ru: NewsletterTranslations = {
+  hero: {
+    placeholder: 'Введите email',
+    subscribe: 'Подписаться',
+    subscribing: 'Подписка...',
+    successMessage: 'Вы успешно подписались!',
+    errorMessage: 'Не удалось подписаться. Попробуйте ещё раз.',
+    privacyNotice: 'Подписываясь, вы соглашаетесь с Политикой конфиденциальности и даёте согласие на получение обновлений.',
+  },
+};

package/src/i18n/types.ts

@@ -0,0 +1,33 @@
+/**
+ * Newsletter Extension I18n Types
+ */
+
+/**
+ * Helper type to get dot-notation paths from nested object
+ */
+type PathKeys<T, Prefix extends string = ''> = T extends object
+  ? {
+      [K in keyof T]: K extends string
+        ? T[K] extends object
+          ? PathKeys<T[K], `${Prefix}${K}.`>
+          : `${Prefix}${K}`
+        : never;
+    }[keyof T]
+  : never;
+
+/**
+ * Keys for newsletter translations
+ */
+export type NewsletterLocalKeys = PathKeys<NewsletterTranslations>;
+
+export interface NewsletterTranslations {
+  /** Hero */
+  hero: {
+    placeholder: string;
+    subscribe: string;
+    subscribing: string;
+    successMessage: string;
+    errorMessage: string;
+    privacyNotice: string;
+  };
+}

package/src/i18n/useNewsletterT.ts

@@ -0,0 +1,60 @@
+'use client';
+
+/**
+ * Self-contained translation hook for ext-newsletter
+ *
+ * Uses built-in translations, no app configuration needed.
+ */
+
+import { useLocale } from 'next-intl';
+import { useMemo, useCallback } from 'react';
+
+import type { NewsletterTranslations, NewsletterLocalKeys } from './types';
+import { en } from './locales/en';
+import { ru } from './locales/ru';
+import { ko } from './locales/ko';
+
+const translations: Record<string, NewsletterTranslations> = { en, ru, ko };
+
+/**
+ * Get nested value from object by dot-notation path
+ */
+function getNestedValue(obj: Record<string, unknown>, path: string): string {
+  const keys = path.split('.');
+  let result: unknown = obj;
+
+  for (const key of keys) {
+    if (result && typeof result === 'object' && key in result) {
+      result = (result as Record<string, unknown>)[key];
+    } else {
+      return path; // Return key if not found
+    }
+  }
+
+  return typeof result === 'string' ? result : path;
+}
+
+/**
+ * Self-contained translation hook for newsletter extension
+ *
+ * Uses built-in translations based on current locale from next-intl.
+ * No need to add translations to app's i18n config.
+ *
+ * @example
+ * ```tsx
+ * function SubscribeForm() {
+ *   const t = useNewsletterT();
+ *   return <button>{t('hero.subscribe')}</button>;
+ * }
+ * ```
+ */
+export function useNewsletterT(): (key: NewsletterLocalKeys) => string {
+  const locale = useLocale();
+
+  const t = useMemo(() => translations[locale] || translations.en, [locale]);
+
+  return useCallback(
+    (key: NewsletterLocalKeys): string => getNestedValue(t as unknown as Record<string, unknown>, key),
+    [t]
+  );
+}