i18n-typed-store 0.1.0

package/LICENSE

@@ -0,0 +1,19 @@
+Copyright (c) 2025 Alexander Lvov
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the “Software”), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,452 @@
+# i18n-typed-store
+
+Type-safe translation store for managing i18n locales with full TypeScript support. A lightweight, zero-dependency library for handling internationalization with compile-time type safety.
+
+## Features
+
+- ✅ **Full TypeScript support** - Complete type safety for translations and locales
+- ✅ **Lazy loading** - Load translations only when needed
+- ✅ **Type-safe API** - Compile-time validation of translation keys and locales
+- ✅ **Pluralization support** - Built-in plural form selector using `Intl.PluralRules`
+- ✅ **Flexible module loading** - Support for any module format (ESM, CommonJS, dynamic imports)
+- ✅ **Zero runtime dependencies** - Lightweight and framework-agnostic
+
+## Installation
+
+```bash
+npm install i18n-typed-store
+```
+
+```bash
+yarn add i18n-typed-store
+```
+
+```bash
+pnpm add i18n-typed-store
+```
+
+## Quick Start
+
+### Basic Usage
+
+```typescript
+import { createTranslationStore } from 'i18n-typed-store';
+
+// Define your translation keys
+const translations = {
+  common: 'common',
+  errors: 'errors',
+} as const;
+
+// Define your locales
+const locales = {
+  en: 'en',
+  ru: 'ru',
+} as const;
+
+// Define your translation data structure
+type TranslationData = {
+  common: {
+    title: string;
+    description: string;
+  };
+  errors: {
+    notFound: string;
+  };
+};
+
+// Create the store
+const storeFactory = createTranslationStore(
+  translations,
+  locales,
+  async (locale, translation) => {
+    // Load translation module dynamically
+    const module = await import(`./locales/${locale}/${translation}.json`);
+    return module.default;
+  },
+  (module, locale, translation) => module // Extract translation data
+);
+
+// Create typed store
+const store = storeFactory.type<TranslationData>();
+
+// Load and use translations
+await store.common.load('en');
+console.log(store.common.translation?.title); // Type-safe access
+```
+
+## Core API
+
+### `createTranslationStore`
+
+Creates a type-safe translation store with lazy loading support.
+
+```typescript
+const storeFactory = createTranslationStore<T, L, Module>(
+  translations: T,
+  locales: L,
+  loadModule: (locale: keyof L, translation: keyof T) => Promise<Module>,
+  extractTranslation: (module: Module, locale: keyof L, translation: keyof T) => unknown
+);
+```
+
+**Parameters:**
+
+- `translations` - Object with translation keys (e.g., `{ common: 'common', errors: 'errors' }`)
+- `locales` - Object with locale keys (e.g., `{ en: 'en', ru: 'ru' }`)
+- `loadModule` - Async function to load a translation module
+- `extractTranslation` - Function to extract translation data from the loaded module. Receives the module, locale, and translation key as parameters, allowing for locale-specific or translation-specific extraction logic.
+
+**Returns:** Object with `type<M>()` method that creates a typed store.
+
+**Example:**
+
+```typescript
+const storeFactory = createTranslationStore(
+  { common: 'common' },
+  { en: 'en', ru: 'ru' },
+  async (locale, translation) => {
+    return await import(`./locales/${locale}/${translation}.json`);
+  },
+  (module, locale, translation) => module.default
+);
+
+type TranslationData = {
+  common: { title: string; description: string };
+};
+
+const store = storeFactory.type<TranslationData>();
+
+// Load translation
+await store.common.load('en');
+
+// Access translation (type-safe)
+const title = store.common.translation?.title;
+```
+
+### `createTranslationModuleMap`
+
+Creates a map of translation module loaders for all combinations of translations and locales.
+
+```typescript
+const moduleMap = createTranslationModuleMap<T, L, Module>(
+  translations: T,
+  locales: L,
+  loadModule: (locale: keyof L, translation: keyof T) => Promise<Module>
+);
+```
+
+**Example:**
+
+```typescript
+const moduleMap = createTranslationModuleMap(
+  { common: 'common' },
+  { en: 'en', ru: 'ru' },
+  async (locale, translation) => {
+    return await import(`./locales/${locale}/${translation}.json`);
+  }
+);
+
+// Access loader
+const loader = moduleMap.common.en;
+const module = await loader();
+```
+
+### `createPluralSelector`
+
+Creates a plural form selector function for a specific locale using `Intl.PluralRules`.
+
+```typescript
+const selectPlural = createPluralSelector(locale: string);
+```
+
+**Example:**
+
+```typescript
+import { createPluralSelector } from 'i18n-typed-store';
+import type { PluralVariants } from 'i18n-typed-store';
+
+const selectPlural = createPluralSelector('en');
+
+const variants: PluralVariants = {
+  one: 'item',
+  other: 'items',
+};
+
+selectPlural(1, variants); // => 'item'
+selectPlural(5, variants); // => 'items'
+```
+
+**Russian example:**
+
+```typescript
+const selectPlural = createPluralSelector('ru');
+
+const variants: PluralVariants = {
+  one: 'яблоко',
+  few: 'яблока',
+  many: 'яблок',
+  other: 'яблок',
+};
+
+selectPlural(1, variants);  // => 'яблоко'
+selectPlural(2, variants);  // => 'яблока'
+selectPlural(5, variants);  // => 'яблок'
+```
+
+## Advanced Usage
+
+### Working with Dynamic Imports
+
+```typescript
+const storeFactory = createTranslationStore(
+  translations,
+  locales,
+  async (locale, translation) => {
+    // Dynamic import with error handling
+    try {
+      const module = await import(
+        `./locales/${locale}/${translation}.json`
+      );
+      return module.default;
+    } catch (error) {
+      console.error(`Failed to load ${translation} for ${locale}`);
+      throw error;
+    }
+  },
+  (module, locale, translation) => module
+);
+```
+
+### Custom Module Extraction
+
+The `extractTranslation` function receives the module, locale, and translation key, allowing for advanced extraction logic:
+
+```typescript
+const storeFactory = createTranslationStore(
+  translations,
+  locales,
+  async (locale, translation) => {
+    // Load module that exports default
+    return await import(`./locales/${locale}/${translation}.ts`);
+  },
+  (module, locale, translation) => {
+    // Extract from module.default or module
+    // You can use locale and translation parameters for custom logic
+    if (locale === 'en' && translation === 'common') {
+      // Special handling for English common translations
+      return module.default?.en || module.default;
+    }
+    return module.default || module;
+  }
+);
+```
+
+### Handling Multiple Translation Namespaces
+
+```typescript
+const translations = {
+  common: 'common',
+  errors: 'errors',
+  ui: 'ui',
+  admin: 'admin',
+} as const;
+
+type TranslationData = {
+  common: { title: string };
+  errors: { notFound: string };
+  ui: { buttons: { save: string } };
+  admin: { dashboard: { title: string } };
+};
+
+const store = storeFactory.type<TranslationData>();
+
+// Load specific translations
+await store.common.load('en');
+await store.ui.load('en');
+
+// Access translations
+const title = store.common.translation?.title;
+const saveButton = store.ui.translation?.buttons.save;
+```
+
+## Type Safety
+
+The library provides complete type safety:
+
+```typescript
+// ✅ TypeScript knows all available translation keys
+const title = store.common.translation?.title;
+
+// ❌ TypeScript error: 'invalidKey' doesn't exist
+const invalid = store.common.translation?.invalidKey;
+
+// ✅ TypeScript knows all available locales
+await store.common.load('en');
+
+// ❌ TypeScript error: 'fr' is not a valid locale
+await store.common.load('fr');
+```
+
+## Pluralization
+
+The library uses `Intl.PluralRules` for plural form selection, supporting all Unicode CLDR plural rules:
+
+- `zero` - For languages with explicit zero form (e.g., Arabic)
+- `one` - Singular form
+- `two` - Dual form (e.g., Arabic, Slovenian)
+- `few` - Few form (e.g., Russian, Polish)
+- `many` - Many form (e.g., Russian, Polish)
+- `other` - Default/plural form
+
+**Supported locales:**
+
+- English, German, French, Spanish, etc. (one/other)
+- Russian, Ukrainian, Serbian, etc. (one/few/many/other)
+- Polish (one/few/many/other)
+- Arabic (zero/one/two/few/many/other)
+- And many more...
+
+## API Reference
+
+### `createTranslationStore`
+
+```typescript
+function createTranslationStore<
+  T extends Record<string, string>,
+  L extends Record<string, string>,
+  Module = unknown
+>(
+  translations: T,
+  locales: L,
+  loadModule: (locale: keyof L, translation: keyof T) => Promise<Module>,
+  extractTranslation: (module: Module, locale: keyof L, translation: keyof T) => unknown
+): {
+  type<M extends { [K in keyof T]: Record<string, unknown> }>(): TranslationStore<T, L, M>;
+}
+```
+
+### `createTranslationModuleMap`
+
+```typescript
+function createTranslationModuleMap<
+  T extends Record<string, string>,
+  L extends Record<string, string>,
+  Module = unknown
+>(
+  translations: T,
+  locales: L,
+  loadModule: (locale: keyof L, translation: keyof T) => Promise<Module>
+): Record<keyof T, Record<keyof L, () => Promise<Module>>>
+```
+
+### `createPluralSelector`
+
+```typescript
+function createPluralSelector(locale: string): (
+  count: number,
+  variants: PluralVariants
+) => string
+```
+
+### `PluralVariants`
+
+```typescript
+type PluralVariants = {
+  zero?: string;
+  one?: string;
+  two?: string;
+  few?: string;
+  many?: string;
+  other?: string;
+};
+```
+
+## Examples
+
+### Example: E-commerce Application
+
+```typescript
+const translations = {
+  products: 'products',
+  cart: 'cart',
+  checkout: 'checkout',
+} as const;
+
+const locales = {
+  en: 'en',
+  ru: 'ru',
+  de: 'de',
+} as const;
+
+type TranslationData = {
+  products: {
+    title: string;
+    addToCart: string;
+    price: string;
+  };
+  cart: {
+    title: string;
+    empty: string;
+    total: string;
+  };
+  checkout: {
+    title: string;
+    placeOrder: string;
+  };
+};
+
+const storeFactory = createTranslationStore(
+  translations,
+  locales,
+  async (locale, translation) => {
+    return await import(`./locales/${locale}/${translation}.json`);
+  },
+  (module, locale, translation) => module.default
+);
+
+const store = storeFactory.type<TranslationData>();
+
+// Load translations
+await store.products.load('en');
+await store.cart.load('en');
+
+// Use translations
+const productTitle = store.products.translation?.title;
+const cartTitle = store.cart.translation?.title;
+```
+
+### Example: Pluralization in Product List
+
+```typescript
+import { createPluralSelector } from 'i18n-typed-store';
+
+const selectPlural = createPluralSelector('en');
+
+function getProductCountText(count: number): string {
+  return selectPlural(count, {
+    one: `${count} product`,
+    other: `${count} products`,
+  });
+}
+
+// Usage
+getProductCountText(1);  // => "1 product"
+getProductCountText(5);  // => "5 products"
+```
+
+## Contributing
+
+Contributions are welcome! Please feel free to submit a Pull Request.
+
+## License
+
+MIT
+
+## Author
+
+Alexander Lvov
+
+## Repository
+
+[GitHub](https://github.com/ialexanderlvov/i18n-typed-store)

package/dist/index.d.mts

@@ -0,0 +1,64 @@
+/**
+ * Creates a map of translation module loaders for all combinations of translations and locales.
+ *
+ * @param translations - Object with translation keys
+ * @param locales - Object with locale keys
+ * @param loadModule - Function to load a translation module for a specific locale and translation
+ * @returns Map where each translation key contains an object with loader functions for each locale
+ */
+declare const createTranslationModuleMap: <T extends Record<string, string>, L extends Record<string, string>, Module = unknown>(translations: T, locales: L, loadModule: (locale: keyof L, translation: keyof T) => Promise<Module>) => Record<keyof T, Record<keyof L, () => Promise<Module>>>;
+
+/**
+ * Creates a translation store with typed translations for different locales.
+ *
+ * @param translations - Object with translation keys
+ * @param locales - Object with locale keys
+ * @param loadModule - Function to load a translation module
+ * @param extractTranslation - Function to extract translation data from the loaded module.
+ *   Receives three parameters: (module, locale, translation) allowing for locale-specific
+ *   or translation-specific extraction logic.
+ * @returns Object with a type() method for creating a typed translation store
+ */
+declare const createTranslationStore: <T extends Record<string, string>, L extends Record<string, string>, Module = unknown>(translations: T, locales: L, loadModule: (locale: keyof L, translation: keyof T) => Promise<Module>, extractTranslation: (module: Module, locale: keyof L, translation: keyof T) => unknown) => {
+    /**
+     * Creates a typed translation store.
+     *
+     * @template M - Type of translation object where each key corresponds to a key from translations
+     * @returns Store with methods to load translations for each locale
+     */
+    type: <M extends { [K in keyof T]: any; }>() => { [K in keyof T]: {
+        translation?: M[K];
+        load: (locale: keyof L) => Promise<void>;
+    }; };
+};
+
+/**
+ * Plural form variants for different plural categories.
+ * Based on Unicode CLDR plural rules: zero, one, two, few, many, other.
+ */
+type PluralVariants = {
+    zero?: string;
+    one?: string;
+    two?: string;
+    few?: string;
+    many?: string;
+    other?: string;
+};
+
+/**
+ * Creates a plural selector function for a specific locale.
+ * The returned function selects the appropriate plural form based on the count.
+ *
+ * @param locale - Locale string (e.g., 'en', 'ru', 'fr')
+ * @returns Function that takes a count and plural variants, returns the matching variant
+ *
+ * @example
+ * ```ts
+ * const selectPlural = createPluralSelector('en');
+ * selectPlural(1, { one: 'item', other: 'items' }); // => 'item'
+ * selectPlural(5, { one: 'item', other: 'items' }); // => 'items'
+ * ```
+ */
+declare const createPluralSelector: (locale: string) => (count: number, variants: PluralVariants) => string;
+
+export { createPluralSelector, createTranslationModuleMap, createTranslationStore };

package/dist/index.d.ts

@@ -0,0 +1,64 @@
+/**
+ * Creates a map of translation module loaders for all combinations of translations and locales.
+ *
+ * @param translations - Object with translation keys
+ * @param locales - Object with locale keys
+ * @param loadModule - Function to load a translation module for a specific locale and translation
+ * @returns Map where each translation key contains an object with loader functions for each locale
+ */
+declare const createTranslationModuleMap: <T extends Record<string, string>, L extends Record<string, string>, Module = unknown>(translations: T, locales: L, loadModule: (locale: keyof L, translation: keyof T) => Promise<Module>) => Record<keyof T, Record<keyof L, () => Promise<Module>>>;
+
+/**
+ * Creates a translation store with typed translations for different locales.
+ *
+ * @param translations - Object with translation keys
+ * @param locales - Object with locale keys
+ * @param loadModule - Function to load a translation module
+ * @param extractTranslation - Function to extract translation data from the loaded module.
+ *   Receives three parameters: (module, locale, translation) allowing for locale-specific
+ *   or translation-specific extraction logic.
+ * @returns Object with a type() method for creating a typed translation store
+ */
+declare const createTranslationStore: <T extends Record<string, string>, L extends Record<string, string>, Module = unknown>(translations: T, locales: L, loadModule: (locale: keyof L, translation: keyof T) => Promise<Module>, extractTranslation: (module: Module, locale: keyof L, translation: keyof T) => unknown) => {
+    /**
+     * Creates a typed translation store.
+     *
+     * @template M - Type of translation object where each key corresponds to a key from translations
+     * @returns Store with methods to load translations for each locale
+     */
+    type: <M extends { [K in keyof T]: any; }>() => { [K in keyof T]: {
+        translation?: M[K];
+        load: (locale: keyof L) => Promise<void>;
+    }; };
+};
+
+/**
+ * Plural form variants for different plural categories.
+ * Based on Unicode CLDR plural rules: zero, one, two, few, many, other.
+ */
+type PluralVariants = {
+    zero?: string;
+    one?: string;
+    two?: string;
+    few?: string;
+    many?: string;
+    other?: string;
+};
+
+/**
+ * Creates a plural selector function for a specific locale.
+ * The returned function selects the appropriate plural form based on the count.
+ *
+ * @param locale - Locale string (e.g., 'en', 'ru', 'fr')
+ * @returns Function that takes a count and plural variants, returns the matching variant
+ *
+ * @example
+ * ```ts
+ * const selectPlural = createPluralSelector('en');
+ * selectPlural(1, { one: 'item', other: 'items' }); // => 'item'
+ * selectPlural(5, { one: 'item', other: 'items' }); // => 'items'
+ * ```
+ */
+declare const createPluralSelector: (locale: string) => (count: number, variants: PluralVariants) => string;
+
+export { createPluralSelector, createTranslationModuleMap, createTranslationStore };

package/dist/index.js

@@ -0,0 +1,63 @@
+'use strict';
+
+// src/utils/create-translation-module-map.ts
+var createTranslationModuleMap = (translations, locales, loadModule) => {
+  const translationModules = {};
+  for (const translationKey of Object.keys(translations)) {
+    translationModules[translationKey] = {};
+    for (const localeKey of Object.keys(locales)) {
+      translationModules[translationKey][localeKey] = () => loadModule(localeKey, translationKey);
+    }
+  }
+  return translationModules;
+};
+
+// src/utils/create-translation-store.ts
+var createTranslationStore = (translations, locales, loadModule, extractTranslation) => {
+  return {
+    /**
+     * Creates a typed translation store.
+     *
+     * @template M - Type of translation object where each key corresponds to a key from translations
+     * @returns Store with methods to load translations for each locale
+     */
+    type: () => {
+      const translationModuleMap = createTranslationModuleMap(translations, locales, loadModule);
+      const store = {};
+      for (const translationKey of Object.keys(translations)) {
+        store[translationKey] = {
+          translation: void 0,
+          load: async (locale) => {
+            const moduleLoader = translationModuleMap[translationKey][locale];
+            const loadedModule = await moduleLoader();
+            store[translationKey].translation = extractTranslation(
+              loadedModule,
+              locale,
+              translationKey
+            );
+          }
+        };
+      }
+      return store;
+    }
+  };
+};
+
+// src/utils/create-plural-selector.ts
+var createPluralSelector = (locale) => {
+  const pluralRules = new Intl.PluralRules(locale);
+  return (count, variants) => {
+    const pluralCategory = pluralRules.select(count);
+    const selectedVariant = variants[pluralCategory];
+    if (selectedVariant) {
+      return selectedVariant;
+    }
+    return variants.other ?? "";
+  };
+};
+
+exports.createPluralSelector = createPluralSelector;
+exports.createTranslationModuleMap = createTranslationModuleMap;
+exports.createTranslationStore = createTranslationStore;
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/utils/create-translation-module-map.ts","../src/utils/create-translation-store.ts","../src/utils/create-plural-selector.ts"],"names":[],"mappings":";;;AAQO,IAAM,0BAAA,GAA6B,CACzC,YAAA,EACA,OAAA,EACA,UAAA,KACI;AAGJ,EAAA,MAAM,qBAAqB,EAAC;AAE5B,EAAA,KAAA,MAAW,cAAA,IAAkB,MAAA,CAAO,IAAA,CAAK,YAAY,CAAA,EAAkB;AACtE,IAAA,kBAAA,CAAmB,cAAc,IAAI,EAAC;AAEtC,IAAA,KAAA,MAAW,SAAA,IAAa,MAAA,CAAO,IAAA,CAAK,OAAO,CAAA,EAAkB;AAC5D,MAAA,kBAAA,CAAmB,cAAc,CAAA,CAAE,SAAS,IAAI,MAAM,UAAA,CAAW,WAAW,cAAc,CAAA;AAAA,IAC3F;AAAA,EACD;AAEA,EAAA,OAAO,kBAAA;AACR;;;ACbO,IAAM,sBAAA,GAAyB,CACrC,YAAA,EACA,OAAA,EACA,YACA,kBAAA,KACI;AACJ,EAAA,OAAO;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,IAON,MAAM,MAAyC;AAC9C,MAAA,MAAM,oBAAA,GAAuB,0BAAA,CAA2B,YAAA,EAAc,OAAA,EAAS,UAAU,CAAA;AASzF,MAAA,MAAM,QAAQ,EAAC;AAEf,MAAA,KAAA,MAAW,cAAA,IAAkB,MAAA,CAAO,IAAA,CAAK,YAAY,CAAA,EAAkB;AACtE,QAAA,KAAA,CAAM,cAAc,CAAA,GAAI;AAAA,UACvB,WAAA,EAAa,MAAA;AAAA,UACb,IAAA,EAAM,OAAO,MAAA,KAAoB;AAChC,YAAA,MAAM,YAAA,GAAe,oBAAA,CAAqB,cAAc,CAAA,CAAE,MAAM,CAAA;AAChE,YAAA,MAAM,YAAA,GAAe,MAAM,YAAA,EAAa;AACxC,YAAA,KAAA,CAAM,cAAc,EAAE,WAAA,GAAc,kBAAA;AAAA,cACnC,YAAA;AAAA,cACA,MAAA;AAAA,cACA;AAAA,aACD;AAAA,UACD;AAAA,SACD;AAAA,MACD;AAEA,MAAA,OAAO,KAAA;AAAA,IACR;AAAA,GACD;AACD;;;ACxCO,IAAM,oBAAA,GAAuB,CAAC,MAAA,KAAmB;AACvD,EAAA,MAAM,WAAA,GAAc,IAAI,IAAA,CAAK,WAAA,CAAY,MAAM,CAAA;AAS/C,EAAA,OAAO,CAAC,OAAe,QAAA,KAAqC;AAC3D,IAAA,MAAM,cAAA,GAAiB,WAAA,CAAY,MAAA,CAAO,KAAK,CAAA;AAC/C,IAAA,MAAM,eAAA,GAAkB,SAAS,cAAc,CAAA;AAE/C,IAAA,IAAI,eAAA,EAAiB;AACpB,MAAA,OAAO,eAAA;AAAA,IACR;AAGA,IAAA,OAAO,SAAS,KAAA,IAAS,EAAA;AAAA,EAC1B,CAAA;AACD","file":"index.js","sourcesContent":["/**\n * Creates a map of translation module loaders for all combinations of translations and locales.\n *\n * @param translations - Object with translation keys\n * @param locales - Object with locale keys\n * @param loadModule - Function to load a translation module for a specific locale and translation\n * @returns Map where each translation key contains an object with loader functions for each locale\n */\nexport const createTranslationModuleMap = <T extends Record<string, string>, L extends Record<string, string>, Module = unknown>(\n\ttranslations: T,\n\tlocales: L,\n\tloadModule: (locale: keyof L, translation: keyof T) => Promise<Module>,\n) => {\n\ttype TranslationLoadModules = Record<keyof T, Record<keyof L, () => Promise<Module>>>;\n\n\tconst translationModules = {} as TranslationLoadModules;\n\n\tfor (const translationKey of Object.keys(translations) as (keyof T)[]) {\n\t\ttranslationModules[translationKey] = {} as TranslationLoadModules[keyof T];\n\n\t\tfor (const localeKey of Object.keys(locales) as (keyof L)[]) {\n\t\t\ttranslationModules[translationKey][localeKey] = () => loadModule(localeKey, translationKey);\n\t\t}\n\t}\n\n\treturn translationModules;\n};\n","import { createTranslationModuleMap } from './create-translation-module-map';\n\n/**\n * Creates a translation store with typed translations for different locales.\n *\n * @param translations - Object with translation keys\n * @param locales - Object with locale keys\n * @param loadModule - Function to load a translation module\n * @param extractTranslation - Function to extract translation data from the loaded module.\n *   Receives three parameters: (module, locale, translation) allowing for locale-specific\n *   or translation-specific extraction logic.\n * @returns Object with a type() method for creating a typed translation store\n */\nexport const createTranslationStore = <T extends Record<string, string>, L extends Record<string, string>, Module = unknown>(\n\ttranslations: T,\n\tlocales: L,\n\tloadModule: (locale: keyof L, translation: keyof T) => Promise<Module>,\n\textractTranslation: (module: Module, locale: keyof L, translation: keyof T) => unknown,\n) => {\n\treturn {\n\t\t/**\n\t\t * Creates a typed translation store.\n\t\t *\n\t\t * @template M - Type of translation object where each key corresponds to a key from translations\n\t\t * @returns Store with methods to load translations for each locale\n\t\t */\n\t\ttype: <M extends { [K in keyof T]: any }>() => {\n\t\t\tconst translationModuleMap = createTranslationModuleMap(translations, locales, loadModule);\n\n\t\t\ttype TranslationStore = {\n\t\t\t\t[K in keyof T]: {\n\t\t\t\t\ttranslation?: M[K];\n\t\t\t\t\tload: (locale: keyof L) => Promise<void>;\n\t\t\t\t};\n\t\t\t};\n\n\t\t\tconst store = {} as TranslationStore;\n\n\t\t\tfor (const translationKey of Object.keys(translations) as (keyof T)[]) {\n\t\t\t\tstore[translationKey] = {\n\t\t\t\t\ttranslation: undefined,\n\t\t\t\t\tload: async (locale: keyof L) => {\n\t\t\t\t\t\tconst moduleLoader = translationModuleMap[translationKey][locale];\n\t\t\t\t\t\tconst loadedModule = await moduleLoader();\n\t\t\t\t\t\tstore[translationKey].translation = extractTranslation(\n\t\t\t\t\t\t\tloadedModule,\n\t\t\t\t\t\t\tlocale,\n\t\t\t\t\t\t\ttranslationKey,\n\t\t\t\t\t\t) as M[typeof translationKey];\n\t\t\t\t\t},\n\t\t\t\t};\n\t\t\t}\n\n\t\t\treturn store;\n\t\t},\n\t};\n};\n","import { PluralVariants } from '../types/plural-variants';\n\n/**\n * Creates a plural selector function for a specific locale.\n * The returned function selects the appropriate plural form based on the count.\n *\n * @param locale - Locale string (e.g., 'en', 'ru', 'fr')\n * @returns Function that takes a count and plural variants, returns the matching variant\n *\n * @example\n * ```ts\n * const selectPlural = createPluralSelector('en');\n * selectPlural(1, { one: 'item', other: 'items' }); // => 'item'\n * selectPlural(5, { one: 'item', other: 'items' }); // => 'items'\n * ```\n */\nexport const createPluralSelector = (locale: string) => {\n\tconst pluralRules = new Intl.PluralRules(locale);\n\n\t/**\n\t * Selects the appropriate plural form variant based on the count.\n\t *\n\t * @param count - Number to determine plural form for\n\t * @param variants - Object containing plural form variants\n\t * @returns The selected variant string, or 'other' variant as fallback, or empty string if no variant found\n\t */\n\treturn (count: number, variants: PluralVariants): string => {\n\t\tconst pluralCategory = pluralRules.select(count) as keyof PluralVariants;\n\t\tconst selectedVariant = variants[pluralCategory];\n\n\t\tif (selectedVariant) {\n\t\t\treturn selectedVariant;\n\t\t}\n\n\t\t// Fallback to 'other' if the specific category is not provided\n\t\treturn variants.other ?? '';\n\t};\n};\n"]}

package/dist/index.mjs

@@ -0,0 +1,59 @@
+// src/utils/create-translation-module-map.ts
+var createTranslationModuleMap = (translations, locales, loadModule) => {
+  const translationModules = {};
+  for (const translationKey of Object.keys(translations)) {
+    translationModules[translationKey] = {};
+    for (const localeKey of Object.keys(locales)) {
+      translationModules[translationKey][localeKey] = () => loadModule(localeKey, translationKey);
+    }
+  }
+  return translationModules;
+};
+
+// src/utils/create-translation-store.ts
+var createTranslationStore = (translations, locales, loadModule, extractTranslation) => {
+  return {
+    /**
+     * Creates a typed translation store.
+     *
+     * @template M - Type of translation object where each key corresponds to a key from translations
+     * @returns Store with methods to load translations for each locale
+     */
+    type: () => {
+      const translationModuleMap = createTranslationModuleMap(translations, locales, loadModule);
+      const store = {};
+      for (const translationKey of Object.keys(translations)) {
+        store[translationKey] = {
+          translation: void 0,
+          load: async (locale) => {
+            const moduleLoader = translationModuleMap[translationKey][locale];
+            const loadedModule = await moduleLoader();
+            store[translationKey].translation = extractTranslation(
+              loadedModule,
+              locale,
+              translationKey
+            );
+          }
+        };
+      }
+      return store;
+    }
+  };
+};
+
+// src/utils/create-plural-selector.ts
+var createPluralSelector = (locale) => {
+  const pluralRules = new Intl.PluralRules(locale);
+  return (count, variants) => {
+    const pluralCategory = pluralRules.select(count);
+    const selectedVariant = variants[pluralCategory];
+    if (selectedVariant) {
+      return selectedVariant;
+    }
+    return variants.other ?? "";
+  };
+};
+
+export { createPluralSelector, createTranslationModuleMap, createTranslationStore };
+//# sourceMappingURL=index.mjs.map
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/utils/create-translation-module-map.ts","../src/utils/create-translation-store.ts","../src/utils/create-plural-selector.ts"],"names":[],"mappings":";AAQO,IAAM,0BAAA,GAA6B,CACzC,YAAA,EACA,OAAA,EACA,UAAA,KACI;AAGJ,EAAA,MAAM,qBAAqB,EAAC;AAE5B,EAAA,KAAA,MAAW,cAAA,IAAkB,MAAA,CAAO,IAAA,CAAK,YAAY,CAAA,EAAkB;AACtE,IAAA,kBAAA,CAAmB,cAAc,IAAI,EAAC;AAEtC,IAAA,KAAA,MAAW,SAAA,IAAa,MAAA,CAAO,IAAA,CAAK,OAAO,CAAA,EAAkB;AAC5D,MAAA,kBAAA,CAAmB,cAAc,CAAA,CAAE,SAAS,IAAI,MAAM,UAAA,CAAW,WAAW,cAAc,CAAA;AAAA,IAC3F;AAAA,EACD;AAEA,EAAA,OAAO,kBAAA;AACR;;;ACbO,IAAM,sBAAA,GAAyB,CACrC,YAAA,EACA,OAAA,EACA,YACA,kBAAA,KACI;AACJ,EAAA,OAAO;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,IAON,MAAM,MAAyC;AAC9C,MAAA,MAAM,oBAAA,GAAuB,0BAAA,CAA2B,YAAA,EAAc,OAAA,EAAS,UAAU,CAAA;AASzF,MAAA,MAAM,QAAQ,EAAC;AAEf,MAAA,KAAA,MAAW,cAAA,IAAkB,MAAA,CAAO,IAAA,CAAK,YAAY,CAAA,EAAkB;AACtE,QAAA,KAAA,CAAM,cAAc,CAAA,GAAI;AAAA,UACvB,WAAA,EAAa,MAAA;AAAA,UACb,IAAA,EAAM,OAAO,MAAA,KAAoB;AAChC,YAAA,MAAM,YAAA,GAAe,oBAAA,CAAqB,cAAc,CAAA,CAAE,MAAM,CAAA;AAChE,YAAA,MAAM,YAAA,GAAe,MAAM,YAAA,EAAa;AACxC,YAAA,KAAA,CAAM,cAAc,EAAE,WAAA,GAAc,kBAAA;AAAA,cACnC,YAAA;AAAA,cACA,MAAA;AAAA,cACA;AAAA,aACD;AAAA,UACD;AAAA,SACD;AAAA,MACD;AAEA,MAAA,OAAO,KAAA;AAAA,IACR;AAAA,GACD;AACD;;;ACxCO,IAAM,oBAAA,GAAuB,CAAC,MAAA,KAAmB;AACvD,EAAA,MAAM,WAAA,GAAc,IAAI,IAAA,CAAK,WAAA,CAAY,MAAM,CAAA;AAS/C,EAAA,OAAO,CAAC,OAAe,QAAA,KAAqC;AAC3D,IAAA,MAAM,cAAA,GAAiB,WAAA,CAAY,MAAA,CAAO,KAAK,CAAA;AAC/C,IAAA,MAAM,eAAA,GAAkB,SAAS,cAAc,CAAA;AAE/C,IAAA,IAAI,eAAA,EAAiB;AACpB,MAAA,OAAO,eAAA;AAAA,IACR;AAGA,IAAA,OAAO,SAAS,KAAA,IAAS,EAAA;AAAA,EAC1B,CAAA;AACD","file":"index.mjs","sourcesContent":["/**\n * Creates a map of translation module loaders for all combinations of translations and locales.\n *\n * @param translations - Object with translation keys\n * @param locales - Object with locale keys\n * @param loadModule - Function to load a translation module for a specific locale and translation\n * @returns Map where each translation key contains an object with loader functions for each locale\n */\nexport const createTranslationModuleMap = <T extends Record<string, string>, L extends Record<string, string>, Module = unknown>(\n\ttranslations: T,\n\tlocales: L,\n\tloadModule: (locale: keyof L, translation: keyof T) => Promise<Module>,\n) => {\n\ttype TranslationLoadModules = Record<keyof T, Record<keyof L, () => Promise<Module>>>;\n\n\tconst translationModules = {} as TranslationLoadModules;\n\n\tfor (const translationKey of Object.keys(translations) as (keyof T)[]) {\n\t\ttranslationModules[translationKey] = {} as TranslationLoadModules[keyof T];\n\n\t\tfor (const localeKey of Object.keys(locales) as (keyof L)[]) {\n\t\t\ttranslationModules[translationKey][localeKey] = () => loadModule(localeKey, translationKey);\n\t\t}\n\t}\n\n\treturn translationModules;\n};\n","import { createTranslationModuleMap } from './create-translation-module-map';\n\n/**\n * Creates a translation store with typed translations for different locales.\n *\n * @param translations - Object with translation keys\n * @param locales - Object with locale keys\n * @param loadModule - Function to load a translation module\n * @param extractTranslation - Function to extract translation data from the loaded module.\n *   Receives three parameters: (module, locale, translation) allowing for locale-specific\n *   or translation-specific extraction logic.\n * @returns Object with a type() method for creating a typed translation store\n */\nexport const createTranslationStore = <T extends Record<string, string>, L extends Record<string, string>, Module = unknown>(\n\ttranslations: T,\n\tlocales: L,\n\tloadModule: (locale: keyof L, translation: keyof T) => Promise<Module>,\n\textractTranslation: (module: Module, locale: keyof L, translation: keyof T) => unknown,\n) => {\n\treturn {\n\t\t/**\n\t\t * Creates a typed translation store.\n\t\t *\n\t\t * @template M - Type of translation object where each key corresponds to a key from translations\n\t\t * @returns Store with methods to load translations for each locale\n\t\t */\n\t\ttype: <M extends { [K in keyof T]: any }>() => {\n\t\t\tconst translationModuleMap = createTranslationModuleMap(translations, locales, loadModule);\n\n\t\t\ttype TranslationStore = {\n\t\t\t\t[K in keyof T]: {\n\t\t\t\t\ttranslation?: M[K];\n\t\t\t\t\tload: (locale: keyof L) => Promise<void>;\n\t\t\t\t};\n\t\t\t};\n\n\t\t\tconst store = {} as TranslationStore;\n\n\t\t\tfor (const translationKey of Object.keys(translations) as (keyof T)[]) {\n\t\t\t\tstore[translationKey] = {\n\t\t\t\t\ttranslation: undefined,\n\t\t\t\t\tload: async (locale: keyof L) => {\n\t\t\t\t\t\tconst moduleLoader = translationModuleMap[translationKey][locale];\n\t\t\t\t\t\tconst loadedModule = await moduleLoader();\n\t\t\t\t\t\tstore[translationKey].translation = extractTranslation(\n\t\t\t\t\t\t\tloadedModule,\n\t\t\t\t\t\t\tlocale,\n\t\t\t\t\t\t\ttranslationKey,\n\t\t\t\t\t\t) as M[typeof translationKey];\n\t\t\t\t\t},\n\t\t\t\t};\n\t\t\t}\n\n\t\t\treturn store;\n\t\t},\n\t};\n};\n","import { PluralVariants } from '../types/plural-variants';\n\n/**\n * Creates a plural selector function for a specific locale.\n * The returned function selects the appropriate plural form based on the count.\n *\n * @param locale - Locale string (e.g., 'en', 'ru', 'fr')\n * @returns Function that takes a count and plural variants, returns the matching variant\n *\n * @example\n * ```ts\n * const selectPlural = createPluralSelector('en');\n * selectPlural(1, { one: 'item', other: 'items' }); // => 'item'\n * selectPlural(5, { one: 'item', other: 'items' }); // => 'items'\n * ```\n */\nexport const createPluralSelector = (locale: string) => {\n\tconst pluralRules = new Intl.PluralRules(locale);\n\n\t/**\n\t * Selects the appropriate plural form variant based on the count.\n\t *\n\t * @param count - Number to determine plural form for\n\t * @param variants - Object containing plural form variants\n\t * @returns The selected variant string, or 'other' variant as fallback, or empty string if no variant found\n\t */\n\treturn (count: number, variants: PluralVariants): string => {\n\t\tconst pluralCategory = pluralRules.select(count) as keyof PluralVariants;\n\t\tconst selectedVariant = variants[pluralCategory];\n\n\t\tif (selectedVariant) {\n\t\t\treturn selectedVariant;\n\t\t}\n\n\t\t// Fallback to 'other' if the specific category is not provided\n\t\treturn variants.other ?? '';\n\t};\n};\n"]}

package/package.json

@@ -0,0 +1,49 @@
+{
+	"name": "i18n-typed-store",
+	"version": "0.1.0",
+	"description": "Type-safe translation store for managing i18n locales with full TypeScript support",
+	"main": "dist/index.js",
+	"module": "dist/index.mjs",
+	"types": "dist/index.d.ts",
+	"files": [
+		"dist"
+	],
+	"scripts": {
+		"build": "tsup",
+		"test": "vitest",
+		"push": "npm run test && npm run build && npm publish"
+	},
+	"keywords": [
+		"i18n",
+		"internationalization",
+		"localization",
+		"locale",
+		"translation",
+		"typescript",
+		"type-safe",
+		"typed",
+		"store",
+		"translations"
+	],
+	"author": "Alexander Lvov",
+	"repository": {
+		"type": "git",
+		"url": "git+https://github.com/ialexanderlvov/i18n-typed-store.git"
+	},
+	"license": "MIT",
+	"type": "commonjs",
+	"devDependencies": {
+		"@eslint/js": "^9.39.1",
+		"@eslint/json": "^0.14.0",
+		"@eslint/markdown": "^7.5.1",
+		"@types/node": "^24.10.1",
+		"@vitest/coverage-v8": "^4.0.14",
+		"eslint": "^9.39.1",
+		"globals": "^16.5.0",
+		"prettier": "^3.6.2",
+		"tsup": "^8.5.1",
+		"typescript": "^5.9.3",
+		"typescript-eslint": "^8.48.0",
+		"vitest": "^4.0.14"
+	}
+}