@digitaldefiance/i18n-lib 2.1.40 → 3.5.0

package/README.md

@@ -6,7 +6,11 @@ Part of [Express Suite](https://github.com/Digital-Defiance/express-suite)
 
 ## Features
 
+- **ICU MessageFormat**: Industry-standard message formatting with plural, select, date/time/number formatting
 - **Component-Based Architecture**: Register translation components with full type safety
+- **37 Supported Languages**: CLDR-compliant plural rules for world's most complex languages
+- **Pluralization Support**: Automatic plural form selection based on count (one/few/many/other)
+- **Gender Support**: Gender-aware translations (male/female/neutral/other)
 - **8 Built-in Languages**: English (US/UK), French, Spanish, German, Chinese, Japanese, Ukrainian
 - **Advanced Template Processing**: 
   - Component references: `{{Component.key}}`
@@ -69,6 +73,258 @@ console.log(engine.translate('app', 'welcome', { appName: 'MyApp' }));
 engine.setLanguage(LanguageCodes.FR);
 console.log(engine.translate('app', 'welcome', { appName: 'MyApp' }));
 // Output: "Bienvenue sur MyApp!"
+
+// Pluralization (automatic form selection)
+engine.register({
+  id: 'cart',
+  strings: {
+    'en-US': {
+      items: {
+        one: '1 item',
+        other: '{count} items'
+      }
+    }
+  }
+});
+
+console.log(engine.translate('cart', 'items', { count: 1 }));
+// Output: "1 item"
+console.log(engine.translate('cart', 'items', { count: 5 }));
+// Output: "5 items"
+```
+
+## ICU MessageFormat
+
+Industry-standard message formatting with powerful features. See [@docs/ICU_MESSAGEFORMAT.md](../../docs/ICU_MESSAGEFORMAT.md) for complete guide.
+
+### Quick Example
+
+```typescript
+import { formatICUMessage } from '@digitaldefiance/i18n-lib';
+
+// Simple variable
+formatICUMessage('Hello {name}', { name: 'Alice' });
+// → "Hello Alice"
+
+// Plural
+formatICUMessage('{count, plural, one {# item} other {# items}}', { count: 1 });
+// → "1 item"
+
+// Select
+formatICUMessage('{gender, select, male {He} female {She} other {They}}', { gender: 'male' });
+// → "He"
+
+// Number formatting
+formatICUMessage('{price, number, currency}', { price: 99.99 }, 'en-US');
+// → "$99.99"
+
+// Complex nested
+formatICUMessage(
+  '{gender, select, male {He has} female {She has}} {count, plural, one {# item} other {# items}}',
+  { gender: 'female', count: 2 }
+);
+// → "She has 2 items"
+```
+
+### Features
+
+- ✅ **Full ICU Syntax**: Variables, plural, select, selectordinal
+- ✅ **Formatters**: Number (integer, currency, percent), Date, Time
+- ✅ **37 Languages**: CLDR plural rules for all supported languages
+- ✅ **Nested Messages**: Up to 4 levels deep
+- ✅ **Performance**: <1ms per format, message caching
+- ✅ **Specification Compliant**: Unicode ICU, CLDR, FormatJS compatible
+
+### Documentation
+
+- **[@docs/ICU_MESSAGEFORMAT.md](../../docs/ICU_MESSAGEFORMAT.md)** - Complete guide with syntax reference and examples
+- **[@docs/ICU_COMPREHENSIVE_VALIDATION.md](../../docs/ICU_COMPREHENSIVE_VALIDATION.md)** - Validation report with test coverage
+- **[@docs/ICU_PROJECT_COMPLETE.md](../../docs/ICU_PROJECT_COMPLETE.md)** - Implementation summary
+
+### API
+
+```typescript
+import { 
+  formatICUMessage,      // One-line formatting
+  isICUMessage,          // Detect ICU format
+  parseICUMessage,       // Parse to AST
+  compileICUMessage,     // Compile to function
+  validateICUMessage,    // Validate syntax
+  Runtime                // Advanced usage
+} from '@digitaldefiance/i18n-lib';
+```
+
+---
+
+## Pluralization & Gender
+
+### Pluralization
+
+Automatic plural form selection based on count with CLDR-compliant rules for 37 languages:
+
+```typescript
+import { createPluralString } from '@digitaldefiance/i18n-lib';
+
+// English (one/other)
+engine.register({
+  id: 'shop',
+  strings: {
+    'en-US': {
+      items: createPluralString({
+        one: '{count} item',
+        other: '{count} items'
+      })
+    }
+  }
+});
+
+// Russian (one/few/many)
+engine.register({
+  id: 'shop',
+  strings: {
+    'ru': {
+      items: createPluralString({
+        one: '{count} товар',
+        few: '{count} товара',
+        many: '{count} товаров'
+      })
+    }
+  }
+});
+
+// Arabic (zero/one/two/few/many/other)
+engine.register({
+  id: 'shop',
+  strings: {
+    'ar': {
+      items: createPluralString({
+        zero: 'لا عناصر',
+        one: 'عنصر واحد',
+        two: 'عنصران',
+        few: '{count} عناصر',
+        many: '{count} عنصرًا',
+        other: '{count} عنصر'
+      })
+    }
+  }
+});
+
+// Automatic form selection
+engine.translate('shop', 'items', { count: 1 });  // "1 item"
+engine.translate('shop', 'items', { count: 5 });  // "5 items"
+engine.translate('shop', 'items', { count: 21 }, 'ru'); // "21 товар"
+```
+
+**Supported Languages** (37 total):
+- **Simple** (other only): Japanese, Chinese, Korean, Turkish, Vietnamese, Thai, Indonesian, Malay
+- **Two forms** (one/other): English, German, Spanish, Italian, Portuguese, Dutch, Swedish, Norwegian, Danish, Finnish, Greek, Hebrew, Hindi
+- **Three forms** (one/few/many): Russian, Ukrainian, Romanian, Latvian
+- **Four forms**: Polish, Czech, Lithuanian, Slovenian, Scottish Gaelic
+- **Five forms**: Irish, Breton
+- **Six forms**: Arabic, Welsh
+
+See [PLURALIZATION_SUPPORT.md](docs/PLURALIZATION_SUPPORT.md) for complete language matrix.
+
+### Gender Support
+
+Gender-aware translations with intelligent fallback:
+
+```typescript
+import { createGenderedString } from '@digitaldefiance/i18n-lib';
+
+engine.register({
+  id: 'profile',
+  strings: {
+    'en-US': {
+      greeting: createGenderedString({
+        male: 'Welcome, Mr. {name}',
+        female: 'Welcome, Ms. {name}',
+        neutral: 'Welcome, {name}'
+      })
+    }
+  }
+});
+
+engine.translate('profile', 'greeting', { name: 'Smith', gender: 'male' });
+// Output: "Welcome, Mr. Smith"
+```
+
+### Combined Plural + Gender
+
+Nested plural and gender forms:
+
+```typescript
+// Plural → Gender
+const pluralGender = {
+  one: {
+    male: 'He has {count} item',
+    female: 'She has {count} item'
+  },
+  other: {
+    male: 'He has {count} items',
+    female: 'She has {count} items'
+  }
+};
+
+// Gender → Plural
+const genderPlural = {
+  male: {
+    one: 'He has {count} item',
+    other: 'He has {count} items'
+  },
+  female: {
+    one: 'She has {count} item',
+    other: 'She has {count} items'
+  }
+};
+```
+
+### Helper Functions
+
+```typescript
+import { 
+  createPluralString, 
+  createGenderedString, 
+  getRequiredPluralForms 
+} from '@digitaldefiance/i18n-lib';
+
+// Get required forms for a language
+const forms = getRequiredPluralForms('ru');
+// Returns: ['one', 'few', 'many']
+
+// Type-safe plural string creation
+const plural = createPluralString({
+  one: '1 item',
+  other: '{count} items'
+});
+
+// Type-safe gender string creation
+const gender = createGenderedString({
+  male: 'He',
+  female: 'She',
+  neutral: 'They'
+});
+```
+
+### Validation
+
+```typescript
+import { validatePluralForms } from '@digitaldefiance/i18n-lib';
+
+// Validate plural forms for a language
+const result = validatePluralForms(
+  { one: 'item', other: 'items' },
+  'en',
+  'items',
+  { strict: true, checkUnused: true, checkVariables: true }
+);
+
+if (!result.isValid) {
+  console.error('Errors:', result.errors);
+}
+if (result.warnings.length > 0) {
+  console.warn('Warnings:', result.warnings);
+}
 ```
 
 ## Core Concepts
@@ -502,6 +758,155 @@ Contributions welcome! Please:
 
 ## ChangeLog
 
+### Version 3.5.0
+
+**Major Feature Release** - ICU MessageFormat Support
+
+**New Features:**
+
+- **ICU MessageFormat**: Full industry-standard message formatting
+  - Parser with 6 AST node types (MESSAGE, LITERAL, ARGUMENT, PLURAL, SELECT, SELECTORDINAL)
+  - Tokenizer with sophisticated depth tracking
+  - Semantic validator with configurable options
+  - Message compiler (AST → executable function)
+  - Runtime with message caching
+  - 304 tests passing (100%)
+
+- **Formatters**: 6 built-in formatters
+  - NumberFormatter (integer, currency, percent)
+  - DateFormatter (short, medium, long, full)
+  - TimeFormatter (short, medium, long, full)
+  - PluralFormatter (37 languages via CLDR)
+  - SelectFormatter
+  - SelectOrdinalFormatter
+  - FormatterRegistry (pluggable system)
+
+- **Helper Functions**: Easy-to-use utilities
+  - `formatICUMessage()` - One-line formatting
+  - `isICUMessage()` - Detect ICU format
+  - `parseICUMessage()` - Parse to AST
+  - `compileICUMessage()` - Compile to function
+  - `validateICUMessage()` - Validate syntax
+
+- **Advanced Features**:
+  - Nested messages (4 levels tested)
+  - Missing value handling
+  - Performance optimization (<1ms/format)
+  - Memory-efficient caching
+  - Multilingual validation (12 languages, 6 writing systems)
+
+**Documentation:**
+
+- [ICU_MESSAGEFORMAT.md](docs/ICU_MESSAGEFORMAT.md) - Complete guide
+- [ICU_COMPREHENSIVE_VALIDATION.md](docs/ICU_COMPREHENSIVE_VALIDATION.md) - Validation report
+- [ICU_PROJECT_COMPLETE.md](docs/ICU_PROJECT_COMPLETE.md) - Implementation summary
+
+**Testing:**
+
+- 304 ICU tests passing (100%)
+- Specification compliance (Unicode ICU, CLDR)
+- Industry compatibility (React Intl, Vue I18n, Angular)
+- Edge case coverage (nesting, Unicode, RTL, special chars)
+- Performance validation (<1ms, 1000 formats in <100ms)
+
+**Migration:**
+
+```typescript
+// Use ICU MessageFormat
+import { formatICUMessage } from '@digitaldefiance/i18n-lib';
+
+formatICUMessage('Hello {name}', { name: 'Alice' });
+formatICUMessage('{count, plural, one {# item} other {# items}}', { count: 1 });
+```
+
+### Version 3.0.0
+
+**Major Feature Release** - Pluralization & Gender Support
+
+**New Features:**
+
+- **CLDR Pluralization**: Full support for 37 languages with automatic plural form selection
+  - 19 unique plural rule implementations (English, Russian, Arabic, Polish, French, Spanish, Japanese, Ukrainian, Chinese, German, Scottish Gaelic, Welsh, Breton, Slovenian, Czech, Lithuanian, Latvian, Irish, Romanian)
+  - 18 additional languages reusing existing rules
+  - Handles world's most complex plural systems (Arabic 6 forms, Welsh 6 forms, Breton 5 forms)
+  - Intelligent fallback: requested form → 'other' → first available
+  - Type-safe `PluralString` type with backward compatibility
+
+- **Gender Support**: Gender-aware translations with 4 categories
+  - Gender categories: male, female, neutral, other
+  - `GenderedString` type for type-safe gender forms
+  - Intelligent fallback: requested → neutral → other → first available
+  - Works seamlessly with pluralization
+
+- **Combined Plural + Gender**: Nested plural and gender resolution
+  - Supports both plural→gender and gender→plural nesting
+  - Full fallback support for missing forms
+  - Works with all 37 supported languages
+
+- **Validation System**: Comprehensive plural form validation
+  - `validatePluralForms()` - Validates required forms per language
+  - `validateCountVariable()` - Ensures count variable exists
+  - Strict and lenient modes
+  - Variable consistency checking
+  - Unused form detection
+
+- **Helper Functions**: Utilities for easy plural/gender string creation
+  - `createPluralString()` - Type-safe plural object creation
+  - `createGenderedString()` - Type-safe gender object creation
+  - `getRequiredPluralForms()` - Get required forms for any language
+
+- **Error Handling**: New error codes for pluralization
+  - `PLURAL_FORM_NOT_FOUND` - Missing plural form with suggestions
+  - `INVALID_PLURAL_CATEGORY` - Invalid category with valid options
+  - `MISSING_COUNT_VARIABLE` - Count variable missing when plurals used
+
+**Documentation:**
+
+- [PLURALIZATION_SUPPORT.md](docs/PLURALIZATION_SUPPORT.md) - Complete language support matrix
+- [PLURALIZATION_USAGE.md](docs/PLURALIZATION_USAGE.md) - Usage guide with examples
+- [ADDING_LANGUAGES.md](docs/ADDING_LANGUAGES.md) - Guide for adding custom languages
+- Updated README with pluralization and gender sections
+
+**Testing:**
+
+- 348 tests passing (92% of roadmap target)
+- 100% coverage on pluralization, gender, and validation code
+- Comprehensive edge case testing
+- Integration tests for complex scenarios
+
+**Migration:**
+
+```typescript
+// Simple strings continue to work unchanged
+engine.register({
+  id: 'app',
+  strings: {
+    'en-US': {
+      title: 'My App'  // Still works
+    }
+  }
+});
+
+// Add pluralization
+import { createPluralString } from '@digitaldefiance/i18n-lib';
+
+engine.register({
+  id: 'cart',
+  strings: {
+    'en-US': {
+      items: createPluralString({
+        one: '{count} item',
+        other: '{count} items'
+      })
+    }
+  }
+});
+
+// Use with count variable
+engine.translate('cart', 'items', { count: 5 });
+// Output: "5 items"
+```
+
 ### Version 2.1.40
 
 - Alignment

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@digitaldefiance/i18n-lib",
-  "version": "2.1.40",
+  "version": "3.5.0",
   "description": "i18n library with enum translation support",
   "main": "src/index.js",
   "types": "src/index.d.ts",

package/src/core/component-store.d.ts

@@ -13,6 +13,10 @@ export declare class ComponentStore {
     get(componentId: string): ComponentConfig;
     getAll(): readonly ComponentConfig[];
     translate(componentId: string, key: string, variables?: Record<string, any>, language?: string): string;
+    /**
+     * Resolve plural form from a PluralString based on count variable
+     */
+    private resolvePluralForm;
     safeTranslate(componentId: string, key: string, variables?: Record<string, any>, language?: string): string;
     private validate;
     setConstants(constants: Record<string, any>): void;

package/src/core/component-store.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"component-store.d.ts","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-i18n-lib/src/core/component-store.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAGlE,qBAAa,cAAc;IACzB,OAAO,CAAC,UAAU,CAAsC;IACxD,OAAO,CAAC,QAAQ,CAA6B;IAC7C,OAAO,CAAC,SAAS,CAAC,CAAsB;gBAE5B,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;IAI3C,QAAQ,CAAC,MAAM,EAAE,eAAe,GAAG,gBAAgB;IAkBnD,MAAM,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,GAAG,gBAAgB;IAe9F,GAAG,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO;IAIjC,GAAG,CAAC,WAAW,EAAE,MAAM,GAAG,eAAe;IASzC,MAAM,IAAI,SAAS,eAAe,EAAE;IAIpC,SAAS,CACP,WAAW,EAAE,MAAM,EACnB,GAAG,EAAE,MAAM,EACX,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAC/B,QAAQ,CAAC,EAAE,MAAM,GAChB,MAAM;IAgBT,aAAa,CACX,WAAW,EAAE,MAAM,EACnB,GAAG,EAAE,MAAM,EACX,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAC/B,QAAQ,CAAC,EAAE,MAAM,GAChB,MAAM;IAQT,OAAO,CAAC,QAAQ;IA2BhB,YAAY,CAAC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI;IAIlD,KAAK,IAAI,IAAI;CAId"}
+{"version":3,"file":"component-store.d.ts","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-i18n-lib/src/core/component-store.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAKlE,qBAAa,cAAc;IACzB,OAAO,CAAC,UAAU,CAAsC;IACxD,OAAO,CAAC,QAAQ,CAA6B;IAC7C,OAAO,CAAC,SAAS,CAAC,CAAsB;gBAE5B,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;IAI3C,QAAQ,CAAC,MAAM,EAAE,eAAe,GAAG,gBAAgB;IAkBnD,MAAM,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,GAAG,gBAAgB;IAe9F,GAAG,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO;IAIjC,GAAG,CAAC,WAAW,EAAE,MAAM,GAAG,eAAe;IASzC,MAAM,IAAI,SAAS,eAAe,EAAE;IAIpC,SAAS,CACP,WAAW,EAAE,MAAM,EACnB,GAAG,EAAE,MAAM,EACX,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAC/B,QAAQ,CAAC,EAAE,MAAM,GAChB,MAAM;IAoBT;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAsBzB,aAAa,CACX,WAAW,EAAE,MAAM,EACnB,GAAG,EAAE,MAAM,EACX,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAC/B,QAAQ,CAAC,EAAE,MAAM,GAChB,MAAM;IAQT,OAAO,CAAC,QAAQ;IA2BhB,YAAY,CAAC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI;IAIlD,KAAK,IAAI,IAAI;CAId"}

package/src/core/component-store.js

@@ -6,6 +6,8 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.ComponentStore = void 0;
 const errors_1 = require("../errors");
 const utils_1 = require("../utils");
+const plural_types_1 = require("../types/plural-types");
+const language_plural_map_1 = require("../pluralization/language-plural-map");
 class ComponentStore {
     components = new Map();
     aliasMap = new Map();
@@ -55,16 +57,36 @@ class ComponentStore {
     }
     translate(componentId, key, variables, language) {
         const component = this.get(componentId);
-        const langStrings = component.strings[language || 'en-US'];
+        const lang = language || 'en-US';
+        const langStrings = component.strings[lang];
         if (!langStrings) {
-            throw errors_1.I18nError.languageNotFound(language || 'en-US');
+            throw errors_1.I18nError.languageNotFound(lang);
         }
-        const translation = langStrings[key];
-        if (!translation) {
-            throw errors_1.I18nError.translationMissing(componentId, key, language || 'en-US');
+        const value = langStrings[key];
+        if (!value) {
+            throw errors_1.I18nError.translationMissing(componentId, key, lang);
         }
+        // Resolve plural form if needed
+        const translation = this.resolvePluralForm(value, variables?.count, lang);
         return (0, utils_1.replaceVariables)(translation, variables, this.constants);
     }
+    /**
+     * Resolve plural form from a PluralString based on count variable
+     */
+    resolvePluralForm(value, count, language) {
+        // If it's a simple string, return as-is
+        if (typeof value === 'string') {
+            return value;
+        }
+        // If no count provided, use 'other' form or first available
+        if (count === undefined) {
+            return (0, plural_types_1.resolvePluralString)(value, 'other') || '';
+        }
+        // Get the appropriate plural category for this count and language
+        const category = (0, language_plural_map_1.getPluralCategory)(language, count);
+        // Resolve the plural form with fallback logic
+        return (0, plural_types_1.resolvePluralString)(value, category) || '';
+    }
     safeTranslate(componentId, key, variables, language) {
         try {
             return this.translate(componentId, key, variables, language);

package/src/core/component-store.js.map

@@ -1 +1 @@
-{"version":3,"file":"component-store.js","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-i18n-lib/src/core/component-store.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"component-store.js","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-i18n-lib/src/core/component-store.ts"],"names":[],"mappings":"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"}

package/src/errors/i18n-error.d.ts

@@ -13,6 +13,9 @@ export declare const I18nErrorCode: {
     readonly INSTANCE_NOT_FOUND: "INSTANCE_NOT_FOUND";
     readonly INSTANCE_EXISTS: "INSTANCE_EXISTS";
     readonly INVALID_CONTEXT: "INVALID_CONTEXT";
+    readonly PLURAL_FORM_NOT_FOUND: "PLURAL_FORM_NOT_FOUND";
+    readonly INVALID_PLURAL_CATEGORY: "INVALID_PLURAL_CATEGORY";
+    readonly MISSING_COUNT_VARIABLE: "MISSING_COUNT_VARIABLE";
 };
 export type I18nErrorCode = (typeof I18nErrorCode)[keyof typeof I18nErrorCode];
 export declare class I18nError extends Error {
@@ -30,5 +33,8 @@ export declare class I18nError extends Error {
     static instanceNotFound(key: string): I18nError;
     static instanceExists(key: string): I18nError;
     static invalidContext(contextKey: string): I18nError;
+    static pluralFormNotFound(category: string, language: string, key: string, availableForms: string[]): I18nError;
+    static invalidPluralCategory(category: string, validCategories: string[]): I18nError;
+    static missingCountVariable(key: string): I18nError;
 }
 //# sourceMappingURL=i18n-error.d.ts.map

package/src/errors/i18n-error.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"i18n-error.d.ts","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-i18n-lib/src/errors/i18n-error.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,eAAO,MAAM,aAAa;;;;;;;;;;;;CAYhB,CAAC;AAEX,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,aAAa,CAAC,CAAC,MAAM,OAAO,aAAa,CAAC,CAAC;AAE/E,qBAAa,SAAU,SAAQ,KAAK;aAEhB,IAAI,EAAE,aAAa;aAEnB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;gBAF9B,IAAI,EAAE,aAAa,EACnC,OAAO,EAAE,MAAM,EACC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,YAAA;IAOhD,MAAM,CAAC,iBAAiB,CAAC,WAAW,EAAE,MAAM,GAAG,SAAS;IAQxD,MAAM,CAAC,iBAAiB,CAAC,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,SAAS;IAQ3E,MAAM,CAAC,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS;IAQpD,MAAM,CAAC,kBAAkB,CACvB,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,GACf,SAAS;IAQZ,MAAM,CAAC,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS;IAI/C,MAAM,CAAC,kBAAkB,CAAC,WAAW,EAAE,MAAM,GAAG,SAAS;IAQzD,MAAM,CAAC,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS;IAQrD,MAAM,CAAC,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,SAAS;IAQpD,MAAM,CAAC,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS;IAQ/C,MAAM,CAAC,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS;IAQ7C,MAAM,CAAC,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS;CAOrD"}
+{"version":3,"file":"i18n-error.d.ts","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-i18n-lib/src/errors/i18n-error.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;CAehB,CAAC;AAEX,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,aAAa,CAAC,CAAC,MAAM,OAAO,aAAa,CAAC,CAAC;AAE/E,qBAAa,SAAU,SAAQ,KAAK;aAEhB,IAAI,EAAE,aAAa;aAEnB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;gBAF9B,IAAI,EAAE,aAAa,EACnC,OAAO,EAAE,MAAM,EACC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,YAAA;IAOhD,MAAM,CAAC,iBAAiB,CAAC,WAAW,EAAE,MAAM,GAAG,SAAS;IAQxD,MAAM,CAAC,iBAAiB,CAAC,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,SAAS;IAQ3E,MAAM,CAAC,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS;IAQpD,MAAM,CAAC,kBAAkB,CACvB,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,GACf,SAAS;IAQZ,MAAM,CAAC,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS;IAI/C,MAAM,CAAC,kBAAkB,CAAC,WAAW,EAAE,MAAM,GAAG,SAAS;IAQzD,MAAM,CAAC,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS;IAQrD,MAAM,CAAC,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,SAAS;IAQpD,MAAM,CAAC,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS;IAQ/C,MAAM,CAAC,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS;IAQ7C,MAAM,CAAC,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS;IAQpD,MAAM,CAAC,kBAAkB,CACvB,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,GAAG,EAAE,MAAM,EACX,cAAc,EAAE,MAAM,EAAE,GACvB,SAAS;IAQZ,MAAM,CAAC,qBAAqB,CAAC,QAAQ,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,EAAE,GAAG,SAAS;IAQpF,MAAM,CAAC,oBAAoB,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS;CAOpD"}

package/src/errors/i18n-error.js

@@ -16,6 +16,9 @@ exports.I18nErrorCode = {
     INSTANCE_NOT_FOUND: 'INSTANCE_NOT_FOUND',
     INSTANCE_EXISTS: 'INSTANCE_EXISTS',
     INVALID_CONTEXT: 'INVALID_CONTEXT',
+    PLURAL_FORM_NOT_FOUND: 'PLURAL_FORM_NOT_FOUND',
+    INVALID_PLURAL_CATEGORY: 'INVALID_PLURAL_CATEGORY',
+    MISSING_COUNT_VARIABLE: 'MISSING_COUNT_VARIABLE',
 };
 class I18nError extends Error {
     code;
@@ -60,6 +63,15 @@ class I18nError extends Error {
     static invalidContext(contextKey) {
         return new I18nError(exports.I18nErrorCode.INVALID_CONTEXT, `Invalid context key '${contextKey}'`, { contextKey });
     }
+    static pluralFormNotFound(category, language, key, availableForms) {
+        return new I18nError(exports.I18nErrorCode.PLURAL_FORM_NOT_FOUND, `Plural form '${category}' not found for language '${language}' in key '${key}'. Available forms: ${availableForms.join(', ')}`, { category, language, key, availableForms });
+    }
+    static invalidPluralCategory(category, validCategories) {
+        return new I18nError(exports.I18nErrorCode.INVALID_PLURAL_CATEGORY, `Invalid plural category '${category}'. Valid categories: ${validCategories.join(', ')}`, { category, validCategories });
+    }
+    static missingCountVariable(key) {
+        return new I18nError(exports.I18nErrorCode.MISSING_COUNT_VARIABLE, `Plural forms used in key '${key}' but no 'count' variable provided`, { key });
+    }
 }
 exports.I18nError = I18nError;
 //# sourceMappingURL=i18n-error.js.map

package/src/errors/i18n-error.js.map

@@ -1 +1 @@
-{"version":3,"file":"i18n-error.js","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-i18n-lib/src/errors/i18n-error.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"i18n-error.js","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-i18n-lib/src/errors/i18n-error.ts"],"names":[],"mappings":"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"}

package/src/gender/gender-categories.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Gender categories for gendered translations
+ */
+export type GenderCategory = 'male' | 'female' | 'neutral' | 'other';
+export type GenderedString = string | Partial<Record<GenderCategory, string>>;
+export declare function isGenderedString(value: any): value is Partial<Record<GenderCategory, string>>;
+//# sourceMappingURL=gender-categories.d.ts.map

package/src/gender/gender-categories.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gender-categories.d.ts","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-i18n-lib/src/gender/gender-categories.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,QAAQ,GAAG,SAAS,GAAG,OAAO,CAAC;AAErE,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,cAAc,EAAE,MAAM,CAAC,CAAC,CAAC;AAE9E,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,GAAG,GAAG,KAAK,IAAI,OAAO,CAAC,MAAM,CAAC,cAAc,EAAE,MAAM,CAAC,CAAC,CAE7F"}

package/src/gender/gender-categories.js

@@ -0,0 +1,10 @@
+"use strict";
+/**
+ * Gender categories for gendered translations
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isGenderedString = isGenderedString;
+function isGenderedString(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+//# sourceMappingURL=gender-categories.js.map

package/src/gender/gender-categories.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gender-categories.js","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-i18n-lib/src/gender/gender-categories.ts"],"names":[],"mappings":";AAAA;;GAEG;;AAMH,4CAEC;AAFD,SAAgB,gBAAgB,CAAC,KAAU;IACzC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAC9E,CAAC"}

package/src/gender/gender-resolver.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Gender form resolution
+ */
+import { GenderCategory, GenderedString } from './gender-categories';
+/**
+ * Resolve gender form with fallback logic
+ */
+export declare function resolveGenderForm(value: GenderedString, gender: GenderCategory | string | undefined): string;
+//# sourceMappingURL=gender-resolver.d.ts.map

package/src/gender/gender-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gender-resolver.d.ts","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-i18n-lib/src/gender/gender-resolver.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,cAAc,EAAE,cAAc,EAAoB,MAAM,qBAAqB,CAAC;AAEvF;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,cAAc,EACrB,MAAM,EAAE,cAAc,GAAG,MAAM,GAAG,SAAS,GAC1C,MAAM,CAsBR"}

package/src/gender/gender-resolver.js

@@ -0,0 +1,30 @@
+"use strict";
+/**
+ * Gender form resolution
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveGenderForm = resolveGenderForm;
+const gender_categories_1 = require("./gender-categories");
+/**
+ * Resolve gender form with fallback logic
+ */
+function resolveGenderForm(value, gender) {
+    if (typeof value === 'string') {
+        return value;
+    }
+    if (!(0, gender_categories_1.isGenderedString)(value)) {
+        return '';
+    }
+    // No gender provided - use neutral or other or first available
+    if (!gender) {
+        return value.neutral || value.other || Object.values(value)[0] || '';
+    }
+    // Try requested gender
+    const requested = value[gender];
+    if (requested) {
+        return requested;
+    }
+    // Fallback: neutral → other → first available
+    return value.neutral || value.other || Object.values(value)[0] || '';
+}
+//# sourceMappingURL=gender-resolver.js.map