@djangocfg/ext-newsletter 1.0.22 → 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.22",
+  version: "1.0.23",
   description: "Newsletter and subscription management extension for DjangoCFG",
   keywords: [
     "django",
@@ -98,6 +98,7 @@ var package_default = {
     consola: "^3.4.2",
     "lucide-react": "^0.545.0",
     next: "^16",
+    "next-intl": "^4",
     "p-retry": "^7.0.0",
     react: "^19",
     "react-dom": "^19",
@@ -112,6 +113,7 @@ var package_default = {
     "@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.22",
+  version: "1.0.23",
   description: "Newsletter and subscription management extension for DjangoCFG",
   keywords: [
     "django",
@@ -75,6 +75,7 @@ var package_default = {
     consola: "^3.4.2",
     "lucide-react": "^0.545.0",
     next: "^16",
+    "next-intl": "^4",
     "p-retry": "^7.0.0",
     react: "^19",
     "react-dom": "^19",
@@ -89,6 +90,7 @@ var package_default = {
     "@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,8 +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 i18n = require('@djangocfg/ext-base/i18n');
-var i18n$1 = require('@djangocfg/i18n');
+var nextIntl = require('next-intl');
 var uiCore = require('@djangocfg/ui-core');
 
 function _interopDefault (e) { return e && e.__esModule ? e : { default: e }; }
@@ -2126,7 +2125,7 @@ var apiNewsletter = api.createExtensionAPI(API);
 // package.json
 var package_default = {
   name: "@djangocfg/ext-newsletter",
-  version: "1.0.22",
+  version: "1.0.23",
   description: "Newsletter and subscription management extension for DjangoCFG",
   keywords: [
     "django",
@@ -2197,6 +2196,7 @@ var package_default = {
     consola: "^3.4.2",
     "lucide-react": "^0.545.0",
     next: "^16",
+    "next-intl": "^4",
     "p-retry": "^7.0.0",
     react: "^19",
     "react-dom": "^19",
@@ -2211,6 +2211,7 @@ var package_default = {
     "@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",
@@ -2522,14 +2523,28 @@ var ko = {
   }
 };
 
-// src/i18n/index.ts
-var NEWSLETTER_NAMESPACE = "newsletter";
-var newsletterI18n = i18n.createExtensionI18n({
-  namespace: NEWSLETTER_NAMESPACE,
-  defaultLocale: "en",
-  locales: { en, ru, ko }
-});
-newsletterI18n.getAllTranslations();
+// 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
@@ -2546,12 +2561,11 @@ function Hero({
   onNewsletterSubmit,
   className = ""
 }) {
-  const baseT = i18n$1.useT();
+  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 nt = i18n.createTypedExtensionT(baseT, NEWSLETTER_NAMESPACE);
   const labels = react.useMemo(() => ({
     placeholder: newsletterPlaceholder ?? nt("hero.placeholder"),
     subscribe: newsletterButtonText ?? nt("hero.subscribe"),

package/dist/hooks.js

@@ -4,12 +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, useMemo } 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 { createExtensionI18n, createTypedExtensionT } from '@djangocfg/ext-base/i18n';
-import { useT } from '@djangocfg/i18n';
+import { useLocale } from 'next-intl';
 import { Button, Input } from '@djangocfg/ui-core';
 
 var __defProp = Object.defineProperty;
@@ -2119,7 +2118,7 @@ var apiNewsletter = createExtensionAPI(API);
 // package.json
 var package_default = {
   name: "@djangocfg/ext-newsletter",
-  version: "1.0.22",
+  version: "1.0.23",
   description: "Newsletter and subscription management extension for DjangoCFG",
   keywords: [
     "django",
@@ -2190,6 +2189,7 @@ var package_default = {
     consola: "^3.4.2",
     "lucide-react": "^0.545.0",
     next: "^16",
+    "next-intl": "^4",
     "p-retry": "^7.0.0",
     react: "^19",
     "react-dom": "^19",
@@ -2204,6 +2204,7 @@ var package_default = {
     "@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",
@@ -2515,14 +2516,28 @@ var ko = {
   }
 };
 
-// src/i18n/index.ts
-var NEWSLETTER_NAMESPACE = "newsletter";
-var newsletterI18n = createExtensionI18n({
-  namespace: NEWSLETTER_NAMESPACE,
-  defaultLocale: "en",
-  locales: { en, ru, ko }
-});
-newsletterI18n.getAllTranslations();
+// 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
@@ -2539,12 +2554,11 @@ function Hero({
   onNewsletterSubmit,
   className = ""
 }) {
-  const baseT = useT();
+  const nt = useNewsletterT();
   const [email, setEmail] = useState("");
   const [isLoading, setIsLoading] = useState(false);
   const [status, setStatus] = useState("idle");
   const [message, setMessage] = useState("");
-  const nt = createTypedExtensionT(baseT, NEWSLETTER_NAMESPACE);
   const labels = useMemo(() => ({
     placeholder: newsletterPlaceholder ?? nt("hero.placeholder"),
     subscribe: newsletterButtonText ?? nt("hero.subscribe"),

package/dist/i18n.cjs

@@ -1,3 +1,4 @@
+"use client";
 var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
 var __getOwnPropNames = Object.getOwnPropertyNames;
@@ -19,12 +20,16 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/i18n/index.ts
 var i18n_exports = {};
 __export(i18n_exports, {
-  NEWSLETTER_NAMESPACE: () => NEWSLETTER_NAMESPACE,
-  newsletterI18n: () => newsletterI18n,
-  newsletterTranslations: () => newsletterTranslations
+  en: () => en,
+  ko: () => ko,
+  ru: () => ru,
+  useNewsletterT: () => useNewsletterT
 });
 module.exports = __toCommonJS(i18n_exports);
-var import_i18n = require("@djangocfg/ext-base/i18n");
+
+// src/i18n/useNewsletterT.ts
+var import_next_intl = require("next-intl");
+var import_react = require("react");
 
 // src/i18n/locales/en.ts
 var en = {
@@ -62,17 +67,32 @@ var ko = {
   }
 };
 
-// src/i18n/index.ts
-var NEWSLETTER_NAMESPACE = "newsletter";
-var newsletterI18n = (0, import_i18n.createExtensionI18n)({
-  namespace: NEWSLETTER_NAMESPACE,
-  defaultLocale: "en",
-  locales: { en, ru, ko }
-});
-var newsletterTranslations = newsletterI18n.getAllTranslations();
+// 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 = {
-  NEWSLETTER_NAMESPACE,
-  newsletterI18n,
-  newsletterTranslations
+  en,
+  ko,
+  ru,
+  useNewsletterT
 });

package/dist/i18n.d.cts

@@ -1,16 +1,14 @@
-import * as _djangocfg_ext_base_i18n from '@djangocfg/ext-base/i18n';
-import { ExtensionKeys, PathKeys } from '@djangocfg/ext-base/i18n';
-
 /**
  * Newsletter Extension I18n Types
  */
-
 /**
- * All valid keys for newsletter translations (with namespace)
+ * Helper type to get dot-notation paths from nested object
  */
-type NewsletterKeys = ExtensionKeys<'newsletter', NewsletterTranslations>;
+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 without namespace prefix (for createTypedExtensionT)
+ * Keys for newsletter translations
  */
 type NewsletterLocalKeys = PathKeys<NewsletterTranslations>;
 interface NewsletterTranslations {
@@ -25,11 +23,26 @@ interface NewsletterTranslations {
     };
 }
 
-/** Newsletter extension namespace */
-declare const NEWSLETTER_NAMESPACE: "newsletter";
-declare const newsletterI18n: _djangocfg_ext_base_i18n.ExtensionI18n<NewsletterTranslations>;
-declare const newsletterTranslations: Record<string, {
-    [namespace: string]: NewsletterTranslations;
-}>;
+/**
+ * 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 { NEWSLETTER_NAMESPACE, type NewsletterKeys, type NewsletterLocalKeys, type NewsletterTranslations, newsletterI18n, newsletterTranslations };
+export { type NewsletterLocalKeys, type NewsletterTranslations, en, ko, ru, useNewsletterT };

package/dist/i18n.d.ts

@@ -1,16 +1,14 @@
-import * as _djangocfg_ext_base_i18n from '@djangocfg/ext-base/i18n';
-import { ExtensionKeys, PathKeys } from '@djangocfg/ext-base/i18n';
-
 /**
  * Newsletter Extension I18n Types
  */
-
 /**
- * All valid keys for newsletter translations (with namespace)
+ * Helper type to get dot-notation paths from nested object
  */
-type NewsletterKeys = ExtensionKeys<'newsletter', NewsletterTranslations>;
+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 without namespace prefix (for createTypedExtensionT)
+ * Keys for newsletter translations
  */
 type NewsletterLocalKeys = PathKeys<NewsletterTranslations>;
 interface NewsletterTranslations {
@@ -25,11 +23,26 @@ interface NewsletterTranslations {
     };
 }
 
-/** Newsletter extension namespace */
-declare const NEWSLETTER_NAMESPACE: "newsletter";
-declare const newsletterI18n: _djangocfg_ext_base_i18n.ExtensionI18n<NewsletterTranslations>;
-declare const newsletterTranslations: Record<string, {
-    [namespace: string]: NewsletterTranslations;
-}>;
+/**
+ * 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 { NEWSLETTER_NAMESPACE, type NewsletterKeys, type NewsletterLocalKeys, type NewsletterTranslations, newsletterI18n, newsletterTranslations };
+export { type NewsletterLocalKeys, type NewsletterTranslations, en, ko, ru, useNewsletterT };

package/dist/i18n.js

@@ -1,5 +1,8 @@
-// src/i18n/index.ts
-import { createExtensionI18n } from "@djangocfg/ext-base/i18n";
+"use client";
+
+// src/i18n/useNewsletterT.ts
+import { useLocale } from "next-intl";
+import { useMemo, useCallback } from "react";
 
 // src/i18n/locales/en.ts
 var en = {
@@ -37,16 +40,31 @@ var ko = {
   }
 };
 
-// src/i18n/index.ts
-var NEWSLETTER_NAMESPACE = "newsletter";
-var newsletterI18n = createExtensionI18n({
-  namespace: NEWSLETTER_NAMESPACE,
-  defaultLocale: "en",
-  locales: { en, ru, ko }
-});
-var newsletterTranslations = newsletterI18n.getAllTranslations();
+// 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 {
-  NEWSLETTER_NAMESPACE,
-  newsletterI18n,
-  newsletterTranslations
+  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.22",
+  version: "1.0.23",
   description: "Newsletter and subscription management extension for DjangoCFG",
   keywords: [
     "django",
@@ -2188,6 +2188,7 @@ var package_default = {
     consola: "^3.4.2",
     "lucide-react": "^0.545.0",
     next: "^16",
+    "next-intl": "^4",
     "p-retry": "^7.0.0",
     react: "^19",
     "react-dom": "^19",
@@ -2202,6 +2203,7 @@ var package_default = {
     "@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.22",
+  version: "1.0.23",
   description: "Newsletter and subscription management extension for DjangoCFG",
   keywords: [
     "django",
@@ -2182,6 +2182,7 @@ var package_default = {
     consola: "^3.4.2",
     "lucide-react": "^0.545.0",
     next: "^16",
+    "next-intl": "^4",
     "p-retry": "^7.0.0",
     react: "^19",
     "react-dom": "^19",
@@ -2196,6 +2197,7 @@ var package_default = {
     "@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.22",
+  "version": "1.0.23",
   "description": "Newsletter and subscription management extension for DjangoCFG",
   "keywords": [
     "django",
@@ -64,13 +64,14 @@
     "check": "tsc --noEmit"
   },
   "peerDependencies": {
-    "@djangocfg/api": "^2.1.111",
-    "@djangocfg/ext-base": "^1.0.17",
-    "@djangocfg/i18n": "^2.1.111",
-    "@djangocfg/ui-core": "^2.1.111",
+    "@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",
@@ -78,13 +79,14 @@
     "zod": "^4.3.4"
   },
   "devDependencies": {
-    "@djangocfg/api": "^2.1.111",
-    "@djangocfg/ext-base": "^1.0.17",
-    "@djangocfg/i18n": "^2.1.111",
-    "@djangocfg/typescript-config": "^2.1.111",
+    "@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

@@ -8,9 +8,7 @@
 import { AlertCircle, CheckCircle2, Loader2, Mail } from 'lucide-react';
 import React, { useMemo, useState } from 'react';
 
-import { createTypedExtensionT } from '@djangocfg/ext-base/i18n';
-import { useT } from '@djangocfg/i18n';
-import { NEWSLETTER_NAMESPACE, type NewsletterTranslations } from '../../i18n';
+import { useNewsletterT } from '../../i18n';
 import { Button, Input } from '@djangocfg/ui-core';
 
 import { newsletterLogger } from '../../utils/logger';
@@ -28,16 +26,12 @@ export function Hero({
   onNewsletterSubmit,
   className = '',
 }: HeroProps) {
-  const baseT = useT();
+  const nt = useNewsletterT();
   const [email, setEmail] = useState('');
   const [isLoading, setIsLoading] = useState(false);
   const [status, setStatus] = useState<'idle' | 'success' | 'error'>('idle');
   const [message, setMessage] = useState('');
 
-  // Type-safe translation function for newsletter extension
-  // Keys are validated at compile time: nt('hero.placeholder') OK, nt('hero.typo') Error
-  const nt = createTypedExtensionT<typeof NEWSLETTER_NAMESPACE, NewsletterTranslations>(baseT, NEWSLETTER_NAMESPACE);
-
   // Prepare labels before JSX render
   const labels = useMemo(() => ({
     placeholder: newsletterPlaceholder ?? nt('hero.placeholder'),

package/src/i18n/index.ts

@@ -1,23 +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>;
+ * }
+ * ```
  */
 
-import { createExtensionI18n } from '@djangocfg/ext-base/i18n';
-import type { NewsletterTranslations } from './types';
-import { en } from './locales/en';
-import { ru } from './locales/ru';
-import { ko } from './locales/ko';
-
-/** Newsletter extension namespace */
-export const NEWSLETTER_NAMESPACE = 'newsletter' as const;
-
-export const newsletterI18n = createExtensionI18n<NewsletterTranslations>({
-  namespace: NEWSLETTER_NAMESPACE,
-  defaultLocale: 'en',
-  locales: { en, ru, ko },
-});
-
-export const newsletterTranslations = newsletterI18n.getAllTranslations();
+// Self-contained hook (recommended)
+export { useNewsletterT } from './useNewsletterT';
 
 // Types
-export type { NewsletterTranslations, NewsletterKeys, NewsletterLocalKeys } from './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/types.ts

@@ -2,15 +2,21 @@
  * Newsletter Extension I18n Types
  */
 
-import type { ExtensionKeys, PathKeys } from '@djangocfg/ext-base/i18n';
-
 /**
- * All valid keys for newsletter translations (with namespace)
+ * Helper type to get dot-notation paths from nested object
  */
-export type NewsletterKeys = ExtensionKeys<'newsletter', NewsletterTranslations>;
+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 without namespace prefix (for createTypedExtensionT)
+ * Keys for newsletter translations
  */
 export type NewsletterLocalKeys = PathKeys<NewsletterTranslations>;
 

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]
+  );
+}