@djangocfg/ext-base 1.0.16 → 1.0.17

package/dist/api.js

@@ -1,2 +1,2 @@
-export { createExtensionAPI, getSharedAuthStorage, initializeExtensionAPI } from './chunk-555TSGMD.js';
+export { createExtensionAPI, getSharedAuthStorage, initializeExtensionAPI } from './chunk-Q4JJNC2D.js';
 import './chunk-3RG5ZIWI.js';

package/dist/{chunk-RKB5BOPI.js → chunk-AU2RS5WG.js}

@@ -1,4 +1,4 @@
-import { package_default } from './chunk-555TSGMD.js';
+import { package_default } from './chunk-Q4JJNC2D.js';
 import { createConsola } from 'consola';
 
 // src/types/context.ts

package/dist/{chunk-555TSGMD.js → chunk-Q4JJNC2D.js}

@@ -3,7 +3,7 @@ import { __require } from './chunk-3RG5ZIWI.js';
 // package.json
 var package_default = {
   name: "@djangocfg/ext-base",
-  version: "1.0.16",
+  version: "1.0.17",
   description: "Base utilities and common code for DjangoCFG extensions",
   keywords: [
     "django",
@@ -52,6 +52,11 @@ var package_default = {
       types: "./dist/api.d.ts",
       import: "./dist/api.js",
       require: "./dist/api.cjs"
+    },
+    "./i18n": {
+      types: "./dist/i18n.d.ts",
+      import: "./dist/i18n.js",
+      require: "./dist/i18n.cjs"
     }
   },
   files: [

package/dist/hooks.cjs

@@ -33,7 +33,7 @@ var EXTENSION_CATEGORIES = [
 // package.json
 var package_default = {
   name: "@djangocfg/ext-base",
-  version: "1.0.16",
+  version: "1.0.17",
   description: "Base utilities and common code for DjangoCFG extensions",
   keywords: [
     "django",

package/dist/hooks.js

@@ -1,7 +1,7 @@
-import { createExtensionLogger } from './chunk-RKB5BOPI.js';
-export { EXTENSION_CATEGORIES, createExtensionConfig, createExtensionError, createExtensionLogger, extensionConfig, formatErrorMessage, handleExtensionError, isExtensionError } from './chunk-RKB5BOPI.js';
-import { isDevelopment } from './chunk-555TSGMD.js';
-export { createExtensionAPI, getApiUrl, getSharedAuthStorage, initializeExtensionAPI, isDevelopment, isProduction, isStaticBuild } from './chunk-555TSGMD.js';
+import { createExtensionLogger } from './chunk-AU2RS5WG.js';
+export { EXTENSION_CATEGORIES, createExtensionConfig, createExtensionError, createExtensionLogger, extensionConfig, formatErrorMessage, handleExtensionError, isExtensionError } from './chunk-AU2RS5WG.js';
+import { isDevelopment } from './chunk-Q4JJNC2D.js';
+export { createExtensionAPI, getApiUrl, getSharedAuthStorage, initializeExtensionAPI, isDevelopment, isProduction, isStaticBuild } from './chunk-Q4JJNC2D.js';
 import './chunk-3RG5ZIWI.js';
 import React, { createContext, useEffect, useContext } from 'react';
 import { jsx, Fragment } from 'react/jsx-runtime';

package/dist/i18n.cjs

@@ -0,0 +1,52 @@
+'use strict';
+
+// src/i18n/utils.ts
+function createExtensionI18n(config) {
+  const { namespace, defaultLocale, locales } = config;
+  return {
+    namespace,
+    defaultLocale,
+    locales: Object.keys(locales),
+    getTranslations(locale) {
+      return locales[locale] ?? locales[defaultLocale];
+    },
+    getAllTranslations() {
+      const result = {};
+      for (const [locale, translations] of Object.entries(locales)) {
+        result[locale] = {
+          [namespace]: translations
+        };
+      }
+      return result;
+    }
+  };
+}
+function mergeExtensionTranslations(base, extensions) {
+  const result = { ...base };
+  for (const ext of extensions) {
+    for (const [key, value] of Object.entries(ext)) {
+      if (typeof value === "object" && value !== null && !Array.isArray(value)) {
+        result[key] = {
+          ...result[key] || {},
+          ...value
+        };
+      } else {
+        result[key] = value;
+      }
+    }
+  }
+  return result;
+}
+function createNamespacedT(t, namespace) {
+  return (key, params) => {
+    return t(`${namespace}.${key}`, params);
+  };
+}
+function createTypedExtensionT(t, namespace) {
+  return (key, params) => t(`${namespace}.${key}`, params);
+}
+
+exports.createExtensionI18n = createExtensionI18n;
+exports.createNamespacedT = createNamespacedT;
+exports.createTypedExtensionT = createTypedExtensionT;
+exports.mergeExtensionTranslations = mergeExtensionTranslations;

package/dist/i18n.d.cts

@@ -0,0 +1,189 @@
+/**
+ * Extension I18n Types
+ *
+ * Base types for extension localization.
+ * Each extension defines its own translation structure.
+ */
+/**
+ * Recursively generates dot-notation paths for nested object types
+ * Re-exported from @djangocfg/i18n for convenience
+ */
+type PathKeys<T, Prefix extends string = '', Depth extends number[] = []> = Depth['length'] extends 10 ? never : T extends string ? Prefix : T extends object ? {
+    [K in keyof T & string]: PathKeys<T[K], Prefix extends '' ? K : `${Prefix}.${K}`, [
+        ...Depth,
+        0
+    ]>;
+}[keyof T & string] : never;
+/**
+ * Generates extension keys with namespace prefix
+ *
+ * @example
+ * ```typescript
+ * type LeadsTranslations = {
+ *   form: { title: string; submit: string }
+ * }
+ *
+ * type Keys = ExtensionKeys<'leads', LeadsTranslations>
+ * // = "leads.form.title" | "leads.form.submit"
+ * ```
+ */
+type ExtensionKeys<Namespace extends string, T extends object> = PathKeys<T> extends infer K ? K extends string ? `${Namespace}.${K}` : never : never;
+/**
+ * Type-safe translation function for an extension
+ *
+ * @example
+ * ```typescript
+ * type LeadsT = ExtensionTranslationFn<'leads', LeadsTranslations>
+ *
+ * const t: LeadsT = useT() as LeadsT
+ * t('leads.form.title') // OK
+ * t('leads.form.typo') // Error
+ * ```
+ */
+type ExtensionTranslationFn<Namespace extends string, T extends object> = {
+    (key: ExtensionKeys<Namespace, T>, params?: Record<string, string | number>): string;
+};
+/**
+ * Supported locale codes for extensions
+ */
+type ExtensionLocale = 'en' | 'ru' | 'ko' | string;
+/**
+ * Base structure for extension translations
+ * Extensions can use any object structure for their translations
+ */
+interface ExtensionTranslations {
+}
+/**
+ * Extension i18n configuration
+ */
+interface ExtensionI18nConfig<T extends object> {
+    /** Extension namespace (e.g., 'payments', 'support') */
+    namespace: string;
+    /** Default locale */
+    defaultLocale: ExtensionLocale;
+    /** Translations by locale */
+    locales: Record<ExtensionLocale, T>;
+}
+/**
+ * Extension i18n instance returned by createExtensionI18n
+ */
+interface ExtensionI18n<T extends object> {
+    /** Extension namespace */
+    namespace: string;
+    /** Default locale */
+    defaultLocale: ExtensionLocale;
+    /** Get translations for a specific locale */
+    getTranslations: (locale: ExtensionLocale) => T;
+    /** Get all translations (for merging with app i18n) */
+    getAllTranslations: () => Record<ExtensionLocale, {
+        [namespace: string]: T;
+    }>;
+    /** Available locales */
+    locales: ExtensionLocale[];
+}
+/**
+ * Deep partial type for translation overrides
+ */
+type DeepPartial<T> = T extends object ? {
+    [P in keyof T]?: DeepPartial<T[P]>;
+} : T;
+
+/**
+ * Creates an extension i18n instance
+ *
+ * @example
+ * ```typescript
+ * // In ext-payments/src/i18n/index.ts
+ * import { createExtensionI18n } from '@djangocfg/ext-base/i18n';
+ * import { en } from './locales/en';
+ * import { ru } from './locales/ru';
+ * import { ko } from './locales/ko';
+ *
+ * export const paymentsI18n = createExtensionI18n({
+ *   namespace: 'payments',
+ *   defaultLocale: 'en',
+ *   locales: { en, ru, ko },
+ * });
+ *
+ * // Export for app to merge
+ * export const paymentsTranslations = paymentsI18n.getAllTranslations();
+ * ```
+ */
+declare function createExtensionI18n<T extends object>(config: ExtensionI18nConfig<T>): ExtensionI18n<T>;
+/**
+ * Merges extension translations into app translations
+ *
+ * @example
+ * ```typescript
+ * // In app's i18n setup
+ * import { en, ru, ko, mergeTranslations } from '@djangocfg/i18n';
+ * import { paymentsTranslations } from '@djangocfg/ext-payments/i18n';
+ * import { supportTranslations } from '@djangocfg/ext-support/i18n';
+ *
+ * const appTranslations = {
+ *   en: mergeExtensionTranslations(en, [
+ *     paymentsTranslations.en,
+ *     supportTranslations.en,
+ *   ]),
+ *   ru: mergeExtensionTranslations(ru, [
+ *     paymentsTranslations.ru,
+ *     supportTranslations.ru,
+ *   ]),
+ * };
+ * ```
+ */
+declare function mergeExtensionTranslations<T extends Record<string, any>>(base: T, extensions: Array<Record<string, any>>): T;
+/**
+ * Creates a namespaced translation getter
+ *
+ * @example
+ * ```typescript
+ * // In extension component
+ * const t = useT(); // from @djangocfg/i18n
+ * const pt = createNamespacedT(t, 'payments');
+ *
+ * // Instead of t('payments.balance.available')
+ * // You can use pt('balance.available')
+ * ```
+ */
+declare function createNamespacedT(t: (key: string, params?: Record<string, string | number>) => string, namespace: string): (key: string, params?: Record<string, string | number>) => string;
+/**
+ * Creates a type-safe translation function for an extension
+ *
+ * @example
+ * ```typescript
+ * // In ext-leads component
+ * import { createTypedExtensionT } from '@djangocfg/ext-base/i18n';
+ * import { useT } from '@djangocfg/i18n';
+ * import type { LeadsTranslations } from '../i18n/types';
+ *
+ * function ContactForm() {
+ *   const t = useT();
+ *   const lt = createTypedExtensionT<'leads', LeadsTranslations>(t, 'leads');
+ *
+ *   return <span>{lt('form.title')}</span>; // Type-safe!
+ *   // lt('form.typo') // Compile error!
+ * }
+ * ```
+ */
+declare function createTypedExtensionT<Namespace extends string, T extends object>(t: (key: string, params?: Record<string, string | number>) => string, namespace: Namespace): <K extends PathKeys<T>>(key: K, params?: Record<string, string | number>) => string;
+/**
+ * Type helper for creating extension key types
+ *
+ * @example
+ * ```typescript
+ * // In ext-leads/src/i18n/types.ts
+ * import type { CreateExtensionKeys } from '@djangocfg/ext-base/i18n';
+ *
+ * export interface LeadsTranslations {
+ *   form: { title: string; submit: string }
+ *   success: { title: string }
+ * }
+ *
+ * // Type of all valid keys: "leads.form.title" | "leads.form.submit" | "leads.success.title"
+ * export type LeadsKeys = CreateExtensionKeys<'leads', LeadsTranslations>;
+ * ```
+ */
+type CreateExtensionKeys<Namespace extends string, T extends object> = ExtensionKeys<Namespace, T>;
+
+export { type CreateExtensionKeys, type DeepPartial, type ExtensionI18n, type ExtensionI18nConfig, type ExtensionKeys, type ExtensionLocale, type ExtensionTranslationFn, type ExtensionTranslations, type PathKeys, createExtensionI18n, createNamespacedT, createTypedExtensionT, mergeExtensionTranslations };

package/dist/i18n.d.ts

@@ -0,0 +1,189 @@
+/**
+ * Extension I18n Types
+ *
+ * Base types for extension localization.
+ * Each extension defines its own translation structure.
+ */
+/**
+ * Recursively generates dot-notation paths for nested object types
+ * Re-exported from @djangocfg/i18n for convenience
+ */
+type PathKeys<T, Prefix extends string = '', Depth extends number[] = []> = Depth['length'] extends 10 ? never : T extends string ? Prefix : T extends object ? {
+    [K in keyof T & string]: PathKeys<T[K], Prefix extends '' ? K : `${Prefix}.${K}`, [
+        ...Depth,
+        0
+    ]>;
+}[keyof T & string] : never;
+/**
+ * Generates extension keys with namespace prefix
+ *
+ * @example
+ * ```typescript
+ * type LeadsTranslations = {
+ *   form: { title: string; submit: string }
+ * }
+ *
+ * type Keys = ExtensionKeys<'leads', LeadsTranslations>
+ * // = "leads.form.title" | "leads.form.submit"
+ * ```
+ */
+type ExtensionKeys<Namespace extends string, T extends object> = PathKeys<T> extends infer K ? K extends string ? `${Namespace}.${K}` : never : never;
+/**
+ * Type-safe translation function for an extension
+ *
+ * @example
+ * ```typescript
+ * type LeadsT = ExtensionTranslationFn<'leads', LeadsTranslations>
+ *
+ * const t: LeadsT = useT() as LeadsT
+ * t('leads.form.title') // OK
+ * t('leads.form.typo') // Error
+ * ```
+ */
+type ExtensionTranslationFn<Namespace extends string, T extends object> = {
+    (key: ExtensionKeys<Namespace, T>, params?: Record<string, string | number>): string;
+};
+/**
+ * Supported locale codes for extensions
+ */
+type ExtensionLocale = 'en' | 'ru' | 'ko' | string;
+/**
+ * Base structure for extension translations
+ * Extensions can use any object structure for their translations
+ */
+interface ExtensionTranslations {
+}
+/**
+ * Extension i18n configuration
+ */
+interface ExtensionI18nConfig<T extends object> {
+    /** Extension namespace (e.g., 'payments', 'support') */
+    namespace: string;
+    /** Default locale */
+    defaultLocale: ExtensionLocale;
+    /** Translations by locale */
+    locales: Record<ExtensionLocale, T>;
+}
+/**
+ * Extension i18n instance returned by createExtensionI18n
+ */
+interface ExtensionI18n<T extends object> {
+    /** Extension namespace */
+    namespace: string;
+    /** Default locale */
+    defaultLocale: ExtensionLocale;
+    /** Get translations for a specific locale */
+    getTranslations: (locale: ExtensionLocale) => T;
+    /** Get all translations (for merging with app i18n) */
+    getAllTranslations: () => Record<ExtensionLocale, {
+        [namespace: string]: T;
+    }>;
+    /** Available locales */
+    locales: ExtensionLocale[];
+}
+/**
+ * Deep partial type for translation overrides
+ */
+type DeepPartial<T> = T extends object ? {
+    [P in keyof T]?: DeepPartial<T[P]>;
+} : T;
+
+/**
+ * Creates an extension i18n instance
+ *
+ * @example
+ * ```typescript
+ * // In ext-payments/src/i18n/index.ts
+ * import { createExtensionI18n } from '@djangocfg/ext-base/i18n';
+ * import { en } from './locales/en';
+ * import { ru } from './locales/ru';
+ * import { ko } from './locales/ko';
+ *
+ * export const paymentsI18n = createExtensionI18n({
+ *   namespace: 'payments',
+ *   defaultLocale: 'en',
+ *   locales: { en, ru, ko },
+ * });
+ *
+ * // Export for app to merge
+ * export const paymentsTranslations = paymentsI18n.getAllTranslations();
+ * ```
+ */
+declare function createExtensionI18n<T extends object>(config: ExtensionI18nConfig<T>): ExtensionI18n<T>;
+/**
+ * Merges extension translations into app translations
+ *
+ * @example
+ * ```typescript
+ * // In app's i18n setup
+ * import { en, ru, ko, mergeTranslations } from '@djangocfg/i18n';
+ * import { paymentsTranslations } from '@djangocfg/ext-payments/i18n';
+ * import { supportTranslations } from '@djangocfg/ext-support/i18n';
+ *
+ * const appTranslations = {
+ *   en: mergeExtensionTranslations(en, [
+ *     paymentsTranslations.en,
+ *     supportTranslations.en,
+ *   ]),
+ *   ru: mergeExtensionTranslations(ru, [
+ *     paymentsTranslations.ru,
+ *     supportTranslations.ru,
+ *   ]),
+ * };
+ * ```
+ */
+declare function mergeExtensionTranslations<T extends Record<string, any>>(base: T, extensions: Array<Record<string, any>>): T;
+/**
+ * Creates a namespaced translation getter
+ *
+ * @example
+ * ```typescript
+ * // In extension component
+ * const t = useT(); // from @djangocfg/i18n
+ * const pt = createNamespacedT(t, 'payments');
+ *
+ * // Instead of t('payments.balance.available')
+ * // You can use pt('balance.available')
+ * ```
+ */
+declare function createNamespacedT(t: (key: string, params?: Record<string, string | number>) => string, namespace: string): (key: string, params?: Record<string, string | number>) => string;
+/**
+ * Creates a type-safe translation function for an extension
+ *
+ * @example
+ * ```typescript
+ * // In ext-leads component
+ * import { createTypedExtensionT } from '@djangocfg/ext-base/i18n';
+ * import { useT } from '@djangocfg/i18n';
+ * import type { LeadsTranslations } from '../i18n/types';
+ *
+ * function ContactForm() {
+ *   const t = useT();
+ *   const lt = createTypedExtensionT<'leads', LeadsTranslations>(t, 'leads');
+ *
+ *   return <span>{lt('form.title')}</span>; // Type-safe!
+ *   // lt('form.typo') // Compile error!
+ * }
+ * ```
+ */
+declare function createTypedExtensionT<Namespace extends string, T extends object>(t: (key: string, params?: Record<string, string | number>) => string, namespace: Namespace): <K extends PathKeys<T>>(key: K, params?: Record<string, string | number>) => string;
+/**
+ * Type helper for creating extension key types
+ *
+ * @example
+ * ```typescript
+ * // In ext-leads/src/i18n/types.ts
+ * import type { CreateExtensionKeys } from '@djangocfg/ext-base/i18n';
+ *
+ * export interface LeadsTranslations {
+ *   form: { title: string; submit: string }
+ *   success: { title: string }
+ * }
+ *
+ * // Type of all valid keys: "leads.form.title" | "leads.form.submit" | "leads.success.title"
+ * export type LeadsKeys = CreateExtensionKeys<'leads', LeadsTranslations>;
+ * ```
+ */
+type CreateExtensionKeys<Namespace extends string, T extends object> = ExtensionKeys<Namespace, T>;
+
+export { type CreateExtensionKeys, type DeepPartial, type ExtensionI18n, type ExtensionI18nConfig, type ExtensionKeys, type ExtensionLocale, type ExtensionTranslationFn, type ExtensionTranslations, type PathKeys, createExtensionI18n, createNamespacedT, createTypedExtensionT, mergeExtensionTranslations };

package/dist/i18n.js

@@ -0,0 +1,49 @@
+import './chunk-3RG5ZIWI.js';
+
+// src/i18n/utils.ts
+function createExtensionI18n(config) {
+  const { namespace, defaultLocale, locales } = config;
+  return {
+    namespace,
+    defaultLocale,
+    locales: Object.keys(locales),
+    getTranslations(locale) {
+      return locales[locale] ?? locales[defaultLocale];
+    },
+    getAllTranslations() {
+      const result = {};
+      for (const [locale, translations] of Object.entries(locales)) {
+        result[locale] = {
+          [namespace]: translations
+        };
+      }
+      return result;
+    }
+  };
+}
+function mergeExtensionTranslations(base, extensions) {
+  const result = { ...base };
+  for (const ext of extensions) {
+    for (const [key, value] of Object.entries(ext)) {
+      if (typeof value === "object" && value !== null && !Array.isArray(value)) {
+        result[key] = {
+          ...result[key] || {},
+          ...value
+        };
+      } else {
+        result[key] = value;
+      }
+    }
+  }
+  return result;
+}
+function createNamespacedT(t, namespace) {
+  return (key, params) => {
+    return t(`${namespace}.${key}`, params);
+  };
+}
+function createTypedExtensionT(t, namespace) {
+  return (key, params) => t(`${namespace}.${key}`, params);
+}
+
+export { createExtensionI18n, createNamespacedT, createTypedExtensionT, mergeExtensionTranslations };

package/dist/index.cjs

@@ -25,7 +25,7 @@ var EXTENSION_CATEGORIES = [
 // package.json
 var package_default = {
   name: "@djangocfg/ext-base",
-  version: "1.0.16",
+  version: "1.0.17",
   description: "Base utilities and common code for DjangoCFG extensions",
   keywords: [
     "django",

package/dist/index.js

@@ -1,3 +1,3 @@
-export { EXTENSION_CATEGORIES, createExtensionConfig, createExtensionError, createExtensionLogger, extensionConfig, formatErrorMessage, handleExtensionError, isExtensionError } from './chunk-RKB5BOPI.js';
-export { createExtensionAPI, getApiUrl, getSharedAuthStorage, initializeExtensionAPI, isDevelopment, isProduction, isStaticBuild } from './chunk-555TSGMD.js';
+export { EXTENSION_CATEGORIES, createExtensionConfig, createExtensionError, createExtensionLogger, extensionConfig, formatErrorMessage, handleExtensionError, isExtensionError } from './chunk-AU2RS5WG.js';
+export { createExtensionAPI, getApiUrl, getSharedAuthStorage, initializeExtensionAPI, isDevelopment, isProduction, isStaticBuild } from './chunk-Q4JJNC2D.js';
 import './chunk-3RG5ZIWI.js';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@djangocfg/ext-base",
-  "version": "1.0.16",
+  "version": "1.0.17",
   "description": "Base utilities and common code for DjangoCFG extensions",
   "keywords": [
     "django",
@@ -49,6 +49,11 @@
       "types": "./dist/api.d.ts",
       "import": "./dist/api.js",
       "require": "./dist/api.cjs"
+    },
+    "./i18n": {
+      "types": "./dist/i18n.d.ts",
+      "import": "./dist/i18n.js",
+      "require": "./dist/i18n.cjs"
     }
   },
   "files": [
@@ -73,7 +78,7 @@
     "cli:info": "tsx src/cli/index.ts info"
   },
   "peerDependencies": {
-    "@djangocfg/api": "^2.1.109",
+    "@djangocfg/api": "^2.1.111",
     "consola": "^3.4.2",
     "react": "^19",
     "react-dom": "^19",
@@ -86,8 +91,8 @@
     "prompts": "^2.4.2"
   },
   "devDependencies": {
-    "@djangocfg/api": "^2.1.109",
-    "@djangocfg/typescript-config": "^2.1.109",
+    "@djangocfg/api": "^2.1.111",
+    "@djangocfg/typescript-config": "^2.1.111",
     "@types/node": "^24.7.2",
     "@types/prompts": "^2.4.9",
     "@types/react": "^19.0.0",

package/src/i18n/index.ts

@@ -0,0 +1,58 @@
+/**
+ * Extension I18n
+ *
+ * Base i18n infrastructure for DjangoCFG extensions.
+ *
+ * @example
+ * ```typescript
+ * // Creating extension translations (in ext-payments/src/i18n/index.ts)
+ * import { createExtensionI18n } from '@djangocfg/ext-base/i18n';
+ *
+ * export const paymentsI18n = createExtensionI18n({
+ *   namespace: 'payments',
+ *   defaultLocale: 'en',
+ *   locales: {
+ *     en: { balance: { available: 'Available Balance' } },
+ *     ru: { balance: { available: 'Доступный баланс' } },
+ *   },
+ * });
+ *
+ * export const paymentsTranslations = paymentsI18n.getAllTranslations();
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // Merging in app (in apps/web/providers/I18nProvider.tsx)
+ * import { mergeExtensionTranslations } from '@djangocfg/ext-base/i18n';
+ * import { en, ru } from '@djangocfg/i18n';
+ * import { paymentsTranslations } from '@djangocfg/ext-payments/i18n';
+ *
+ * const translations = {
+ *   en: mergeExtensionTranslations(en, [paymentsTranslations.en]),
+ *   ru: mergeExtensionTranslations(ru, [paymentsTranslations.ru]),
+ * };
+ * ```
+ */
+
+// Types
+export type {
+  ExtensionLocale,
+  ExtensionTranslations,
+  ExtensionI18nConfig,
+  ExtensionI18n,
+  DeepPartial,
+  // Type-safe keys
+  PathKeys,
+  ExtensionKeys,
+  ExtensionTranslationFn,
+} from './types';
+
+// Utils
+export {
+  createExtensionI18n,
+  mergeExtensionTranslations,
+  createNamespacedT,
+  createTypedExtensionT,
+} from './utils';
+
+export type { CreateExtensionKeys } from './utils';

package/src/i18n/types.ts

@@ -0,0 +1,108 @@
+/**
+ * Extension I18n Types
+ *
+ * Base types for extension localization.
+ * Each extension defines its own translation structure.
+ */
+
+/**
+ * Recursively generates dot-notation paths for nested object types
+ * Re-exported from @djangocfg/i18n for convenience
+ */
+export type PathKeys<T, Prefix extends string = '', Depth extends number[] = []> =
+  Depth['length'] extends 10
+    ? never
+    : T extends string
+      ? Prefix
+      : T extends object
+        ? {
+            [K in keyof T & string]: PathKeys<
+              T[K],
+              Prefix extends '' ? K : `${Prefix}.${K}`,
+              [...Depth, 0]
+            >
+          }[keyof T & string]
+        : never;
+
+/**
+ * Generates extension keys with namespace prefix
+ *
+ * @example
+ * ```typescript
+ * type LeadsTranslations = {
+ *   form: { title: string; submit: string }
+ * }
+ *
+ * type Keys = ExtensionKeys<'leads', LeadsTranslations>
+ * // = "leads.form.title" | "leads.form.submit"
+ * ```
+ */
+export type ExtensionKeys<Namespace extends string, T extends object> =
+  PathKeys<T> extends infer K
+    ? K extends string
+      ? `${Namespace}.${K}`
+      : never
+    : never;
+
+/**
+ * Type-safe translation function for an extension
+ *
+ * @example
+ * ```typescript
+ * type LeadsT = ExtensionTranslationFn<'leads', LeadsTranslations>
+ *
+ * const t: LeadsT = useT() as LeadsT
+ * t('leads.form.title') // OK
+ * t('leads.form.typo') // Error
+ * ```
+ */
+export type ExtensionTranslationFn<Namespace extends string, T extends object> = {
+  (key: ExtensionKeys<Namespace, T>, params?: Record<string, string | number>): string;
+};
+
+/**
+ * Supported locale codes for extensions
+ */
+export type ExtensionLocale = 'en' | 'ru' | 'ko' | string;
+
+/**
+ * Base structure for extension translations
+ * Extensions can use any object structure for their translations
+ */
+// eslint-disable-next-line @typescript-eslint/no-empty-object-type
+export interface ExtensionTranslations {}
+
+/**
+ * Extension i18n configuration
+ */
+export interface ExtensionI18nConfig<T extends object> {
+  /** Extension namespace (e.g., 'payments', 'support') */
+  namespace: string;
+  /** Default locale */
+  defaultLocale: ExtensionLocale;
+  /** Translations by locale */
+  locales: Record<ExtensionLocale, T>;
+}
+
+/**
+ * Extension i18n instance returned by createExtensionI18n
+ */
+export interface ExtensionI18n<T extends object> {
+  /** Extension namespace */
+  namespace: string;
+  /** Default locale */
+  defaultLocale: ExtensionLocale;
+  /** Get translations for a specific locale */
+  getTranslations: (locale: ExtensionLocale) => T;
+  /** Get all translations (for merging with app i18n) */
+  getAllTranslations: () => Record<ExtensionLocale, { [namespace: string]: T }>;
+  /** Available locales */
+  locales: ExtensionLocale[];
+}
+
+/**
+ * Deep partial type for translation overrides
+ */
+export type DeepPartial<T> = T extends object
+  ? { [P in keyof T]?: DeepPartial<T[P]> }
+  : T;

package/src/i18n/utils.ts

@@ -0,0 +1,181 @@
+/**
+ * Extension I18n Utilities
+ *
+ * Helper functions for creating and managing extension translations.
+ */
+
+import type {
+  ExtensionI18n,
+  ExtensionI18nConfig,
+  ExtensionLocale,
+  ExtensionKeys,
+} from './types';
+
+/**
+ * Creates an extension i18n instance
+ *
+ * @example
+ * ```typescript
+ * // In ext-payments/src/i18n/index.ts
+ * import { createExtensionI18n } from '@djangocfg/ext-base/i18n';
+ * import { en } from './locales/en';
+ * import { ru } from './locales/ru';
+ * import { ko } from './locales/ko';
+ *
+ * export const paymentsI18n = createExtensionI18n({
+ *   namespace: 'payments',
+ *   defaultLocale: 'en',
+ *   locales: { en, ru, ko },
+ * });
+ *
+ * // Export for app to merge
+ * export const paymentsTranslations = paymentsI18n.getAllTranslations();
+ * ```
+ */
+export function createExtensionI18n<T extends object>(
+  config: ExtensionI18nConfig<T>
+): ExtensionI18n<T> {
+  const { namespace, defaultLocale, locales } = config;
+
+  return {
+    namespace,
+    defaultLocale,
+    locales: Object.keys(locales) as ExtensionLocale[],
+
+    getTranslations(locale: ExtensionLocale): T {
+      return locales[locale] ?? locales[defaultLocale];
+    },
+
+    getAllTranslations(): Record<ExtensionLocale, { [ns: string]: T }> {
+      const result: Record<ExtensionLocale, { [ns: string]: T }> = {} as any;
+
+      for (const [locale, translations] of Object.entries(locales)) {
+        result[locale as ExtensionLocale] = {
+          [namespace]: translations as T,
+        };
+      }
+
+      return result;
+    },
+  };
+}
+
+/**
+ * Merges extension translations into app translations
+ *
+ * @example
+ * ```typescript
+ * // In app's i18n setup
+ * import { en, ru, ko, mergeTranslations } from '@djangocfg/i18n';
+ * import { paymentsTranslations } from '@djangocfg/ext-payments/i18n';
+ * import { supportTranslations } from '@djangocfg/ext-support/i18n';
+ *
+ * const appTranslations = {
+ *   en: mergeExtensionTranslations(en, [
+ *     paymentsTranslations.en,
+ *     supportTranslations.en,
+ *   ]),
+ *   ru: mergeExtensionTranslations(ru, [
+ *     paymentsTranslations.ru,
+ *     supportTranslations.ru,
+ *   ]),
+ * };
+ * ```
+ */
+export function mergeExtensionTranslations<T extends Record<string, any>>(
+  base: T,
+  extensions: Array<Record<string, any>>
+): T {
+  const result = { ...base };
+
+  for (const ext of extensions) {
+    for (const [key, value] of Object.entries(ext)) {
+      if (typeof value === 'object' && value !== null && !Array.isArray(value)) {
+        (result as any)[key] = {
+          ...((result as any)[key] || {}),
+          ...value,
+        };
+      } else {
+        (result as any)[key] = value;
+      }
+    }
+  }
+
+  return result;
+}
+
+/**
+ * Creates a namespaced translation getter
+ *
+ * @example
+ * ```typescript
+ * // In extension component
+ * const t = useT(); // from @djangocfg/i18n
+ * const pt = createNamespacedT(t, 'payments');
+ *
+ * // Instead of t('payments.balance.available')
+ * // You can use pt('balance.available')
+ * ```
+ */
+export function createNamespacedT(
+  t: (key: string, params?: Record<string, string | number>) => string,
+  namespace: string
+): (key: string, params?: Record<string, string | number>) => string {
+  return (key: string, params?: Record<string, string | number>) => {
+    return t(`${namespace}.${key}`, params);
+  };
+}
+
+/**
+ * Creates a type-safe translation function for an extension
+ *
+ * @example
+ * ```typescript
+ * // In ext-leads component
+ * import { createTypedExtensionT } from '@djangocfg/ext-base/i18n';
+ * import { useT } from '@djangocfg/i18n';
+ * import type { LeadsTranslations } from '../i18n/types';
+ *
+ * function ContactForm() {
+ *   const t = useT();
+ *   const lt = createTypedExtensionT<'leads', LeadsTranslations>(t, 'leads');
+ *
+ *   return <span>{lt('form.title')}</span>; // Type-safe!
+ *   // lt('form.typo') // Compile error!
+ * }
+ * ```
+ */
+export function createTypedExtensionT<
+  Namespace extends string,
+  T extends object
+>(
+  t: (key: string, params?: Record<string, string | number>) => string,
+  namespace: Namespace
+): <K extends import('./types').PathKeys<T>>(
+  key: K,
+  params?: Record<string, string | number>
+) => string {
+  return (key, params) => t(`${namespace}.${key}`, params);
+}
+
+/**
+ * Type helper for creating extension key types
+ *
+ * @example
+ * ```typescript
+ * // In ext-leads/src/i18n/types.ts
+ * import type { CreateExtensionKeys } from '@djangocfg/ext-base/i18n';
+ *
+ * export interface LeadsTranslations {
+ *   form: { title: string; submit: string }
+ *   success: { title: string }
+ * }
+ *
+ * // Type of all valid keys: "leads.form.title" | "leads.form.submit" | "leads.success.title"
+ * export type LeadsKeys = CreateExtensionKeys<'leads', LeadsTranslations>;
+ * ```
+ */
+export type CreateExtensionKeys<
+  Namespace extends string,
+  T extends object
+> = ExtensionKeys<Namespace, T>;