i18ntk 1.10.2 → 2.0.3

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "i18ntk",
-  "version": "1.10.2",
+  "version": "2.0.3",
   "description": "🚀 The fastest i18n toolkit with 97% performance boost! Zero-dependency, enterprise-grade internationalization for React, Vue, Angular, Python, Java, PHP & more. Features PIN protection, auto framework detection, 7+ UI languages, and comprehensive translation management. Perfect for startups to enterprises.",
   "keywords": [
     "i18n",
@@ -116,10 +116,10 @@
     "url": "https://github.com/vladnoskv"
   },
   "type": "commonjs",
-  "main": "main/i18ntk-manage.js",
+  "main": "main/manage/index.js",
   "types": "runtime/i18ntk.d.ts",
   "exports": {
-    ".": "./main/i18ntk-manage.js",
+    ".": "./main/manage/index.js",
     "./runtime": {
       "types": "./runtime/i18ntk.d.ts",
       "require": "./runtime/index.js",
@@ -139,9 +139,9 @@
     "./package.json": "./package.json"
   },
   "bin": {
-    "i18ntk": "main/i18ntk-manage.js",
+    "i18ntk": "main/manage/index.js",
     "i18ntk-setup": "main/i18ntk-setup.js",
-    "i18ntk-manage": "main/i18ntk-manage.js",
+    "i18ntk-manage": "main/manage/index.js",
     "i18ntk-init": "main/i18ntk-init.js",
     "i18ntk-analyze": "main/i18ntk-analyze.js",
     "i18ntk-validate": "main/i18ntk-validate.js",
@@ -150,9 +150,9 @@
     "i18ntk-sizing": "main/i18ntk-sizing.js",
     "i18ntk-summary": "main/i18ntk-summary.js",
     "i18ntk-doctor": "main/i18ntk-doctor.js",
-    "i18ntk-fixer": "./main/i18ntk-fixer.js",
-    "i18ntk-scanner": "./main/i18ntk-scanner.js",
-    "i18ntk-backup": "./main/i18ntk-backup.js"
+    "i18ntk-fixer": "main/i18ntk-fixer.js",
+    "i18ntk-scanner": "main/i18ntk-scanner.js",
+    "i18ntk-backup": "main/i18ntk-backup.js"
   },
   "directories": {
     "doc": "docs",
@@ -171,9 +171,9 @@
   ],
   "sideEffects": false,
   "scripts": {
-    "i18ntk": "node main/i18ntk-manage.js",
+    "i18ntk": "node main/manage/index.js",
     "i18ntk-setup": "node main/i18ntk-setup.js",
-    "i18ntk-manage": "node main/i18ntk-manage.js",
+    "i18ntk-manage": "node main/manage/index.js",
     "i18ntk-init": "node main/i18ntk-init.js",
     "i18ntk-analyze": "node main/i18ntk-analyze.js",
     "i18ntk-validate": "node main/i18ntk-validate.js",
@@ -190,8 +190,14 @@
     "i18ntk-java": "node main/i18ntk-java.js",
     "i18ntk-php": "node main/i18ntk-php.js",
     "i18ntk-go": "node main/i18ntk-go.js",
-    "start": "node main/i18ntk-manage.js",
-    "security:check": "node utils/security-check.js",
+    "start": "node main/manage/index.js",
+    "security:check": "node utils/security-check-improved.js",
+    "security:test": "node --test tests/security.test.js",
+    "security:audit": "npm run security:check && npm run security:test",
+    "test": "npm run security:test",
+    "test:all": "npm run security:audit",
+    "prepublishOnly": "npm run security:audit",
+    "prepare": "npm run security:check",
     "backup:create": "node main/i18ntk-backup.js create",
     "backup:restore": "node main/i18ntk-backup.js restore",
     "backup:list": "node main/i18ntk-backup.js list",
@@ -200,6 +206,7 @@
     "languages:select": "node settings/settings-cli.js",
     "languages:list": "node settings/settings-cli.js --list-languages",
     "languages:status": "node settings/settings-cli.js --language-status",
+    "lint:locales": "node scripts/lint-locales.js",
     "deprecate:versions": "node scripts/deprecate-versions.js",
     "deprecate:dry-run": "node scripts/deprecate-versions.js --dry-run",
     "deprecate:verify": "node scripts/verify-deprecations.js"
@@ -213,26 +220,20 @@
   },
   "preferGlobal": true,
   "versionInfo": {
-    "version": "1.10.2",
-    "releaseDate": "23/08/2025",
-    "lastUpdated": "23/08/2025",
+    "version": "2.0.0",
+    "releaseDate": "01/01/2026",
+    "lastUpdated": "11/04/2026",
     "maintainer": "Vladimir Noskov",
     "changelog": "./CHANGELOG.md",
     "documentation": "./README.md",
     "apiReference": "./docs/api/API_REFERENCE.md",
     "majorChanges": [
-      "SECURITY: Complete removal of child_process dependencies - zero shell access",
-      "FEATURE: Python framework support (Django, Flask, FastAPI)",
-      "PERFORMANCE: 97% faster processing (15.38ms for 200k keys)",
-      "FEATURE: Enhanced framework detection with 95% accuracy",
-      "ENHANCEMENT: Multi-language support with 8 built-in UI languages",
-      "FEATURE: Interactive translation fixer with custom placeholders",
-      "SECURITY: PIN protection and encrypted configuration storage",
-      "OPTIMIZATION: Memory usage <2MB for any operation",
-      "FEATURE: Comprehensive backup and recovery system",
-      "BUGFIX: Windows path resolution improvements",
-      "DOCUMENTATION: Updated for v1.10.1 with Python support",
-      "MAINTENANCE: Clean package structure - 2.2 MB total size"
+      "BREAKING: Unified v2 command surface and release metadata",
+      "SECURITY: Zero runtime dependencies and hardened config IO",
+      "I18N: Added missing translation keys used by init/fixer/sizing/summary/usage/settings flows",
+      "RELIABILITY: Initialization detection now honors .i18ntk-config setup state",
+      "RELIABILITY: Added async safeReadFile/safeWriteFile + safeParseJSON compatibility helpers",
+      "INIT: Auto-bootstrap source locale file when source language directory is empty"
     ],
     "breakingChanges": [],
     "deprecations": [
@@ -258,9 +259,11 @@
       "1.8.2",
       "1.8.3",
       "1.9.0",
-      "1.10.1"
+      "1.10.1",
+      "1.10.2",
+      "1.10.3"
     ],
-    "nextVersion": "1.11.0",
+    "nextVersion": "2.1.0",
     "supportedNodeVersions": ">=16.0.0",
     "supportedFrameworks": {
       "react-i18next": ">=11.0.0",

package/runtime/enhanced.d.ts

@@ -1,222 +1,222 @@
-// runtime/enhanced.d.ts
-// Enhanced runtime API with TypeScript support and AES-256-GCM encryption
-
-export interface TranslationParams extends Record<string, unknown> {
-  count?: number;
-  context?: string;
-  [key: string]: unknown;
-}
-
-export interface TranslationOptions {
-  language?: string;
-  fallbackLanguage?: string;
-  namespace?: string;
-  encryptionKey?: string;
-  enableEncryption?: boolean;
-}
-
-export interface TranslationResult {
-  text: string;
-  language: string;
-  key: string;
-  params: TranslationParams;
-  encrypted: boolean;
-}
-
-export interface I18nConfig {
-  baseDir: string;
-  defaultLanguage: string;
-  fallbackLanguage: string;
-  keySeparator: string;
-  preload: boolean;
-  encryption: {
-    enabled: boolean;
-    algorithm: string;
-    keyLength: number;
-    ivLength: number;
-    authTagLength: number;
-  };
-  cache: {
-    enabled: boolean;
-    maxSize: number;
-    ttl: number;
-  };
-  security: {
-    validateInputs: boolean;
-    sanitizeOutput: boolean;
-    maxKeyLength: number;
-    maxValueLength: number;
-  };
-}
-
-export interface TranslationKey<T = string> {
-  key: string;
-  defaultValue?: T;
-  description?: string;
-  context?: string;
-  plural?: boolean;
-}
-
-export interface PluralizationRule {
-  rule: (count: number) => number;
-  examples: string[];
-}
-
-export interface LanguageConfig {
-  code: string;
-  name: string;
-  direction: 'ltr' | 'rtl';
-  pluralRules: PluralizationRule;
-  dateFormat: string;
-  numberFormat: string;
-}
-
-// Enhanced TypeScript-compatible translation functions
-export function translate<T = string>(key: string, params?: TranslationParams, options?: TranslationOptions): T;
-export function translate<T = string>(key: TranslationKey<T>, params?: TranslationParams, options?: TranslationOptions): T;
-
-export const t: typeof translate;
-
-// Type-safe translation with strict typing
-export function tTyped<T = string>(key: string, params?: TranslationParams, options?: TranslationOptions): T;
-
-// Translation with encryption support
-export function translateEncrypted<T = string>(key: string, params?: TranslationParams, options?: TranslationOptions): Promise<T>;
-
-// Batch translation operations
-export function translateBatch<T = string>(keys: string[], params?: TranslationParams[], options?: TranslationOptions): T[];
-export function translateBatchEncrypted<T = string>(keys: string[], params?: TranslationParams[], options?: TranslationOptions): Promise<T[]>;
-
-// Configuration and initialization
-export function initI18nRuntime(options?: Partial<I18nConfig>): Promise<I18nRuntimeInstance>;
-
-export interface I18nRuntimeInstance {
-  t: typeof translate;
-  translate: typeof translate;
-  translateEncrypted: typeof translateEncrypted;
-  translateBatch: typeof translateBatch;
-  translateBatchEncrypted: typeof translateBatchEncrypted;
-  
-  // Language management
-  setLanguage: (lang: string) => Promise<void>;
-  getLanguage: () => string;
-  getAvailableLanguages: () => string[];
-  refresh: (lang?: string) => Promise<void>;
-  
-  // Configuration
-  getConfig: () => I18nConfig;
-  updateConfig: (updates: Partial<I18nConfig>) => Promise<void>;
-  
-  // Security and encryption
-  setEncryptionKey: (key: string) => void;
-  getEncryptionStatus: () => boolean;
-  encryptData: (data: string) => Promise<string>;
-  decryptData: (encryptedData: string) => Promise<string>;
-  
-  // Validation and utilities
-  validateTranslationKey: (key: string) => boolean;
-  sanitizeTranslation: (text: string) => string;
-  getTranslationMetadata: (key: string) => TranslationResult;
-  
-  // Type utilities
-  createTypedTranslator<T>(): TypedTranslator<T>;
-}
-
-export interface TypedTranslator<T> {
-  t: (key: string, params?: TranslationParams, options?: TranslationOptions) => T;
-  translate: (key: string, params?: TranslationParams, options?: TranslationOptions) => T;
-}
-
-// Utility types for better TypeScript support
-export type TranslationNamespace = string;
-export type TranslationKeyPath = string;
-export type TranslationValue = string | number | boolean | null;
-
-export interface TranslationSchema {
-  [key: string]: TranslationValue | TranslationSchema;
-}
-
-// Error handling types
-export interface TranslationError extends Error {
-  code: string;
-  key: string;
-  language: string;
-  params?: TranslationParams;
-}
-
-export interface ValidationError extends TranslationError {
-  validationErrors: string[];
-}
-
-// Plugin system for extensibility
-export interface TranslationPlugin {
-  name: string;
-  version: string;
-  transform?: (text: string, params: TranslationParams, options: TranslationOptions) => string;
-  validate?: (key: string, params: TranslationParams) => boolean;
-  encrypt?: (data: string, key: string) => Promise<string>;
-  decrypt?: (encryptedData: string, key: string) => Promise<string>;
-}
-
-// Event system for monitoring
-export interface TranslationEvent {
-  type: 'translation' | 'error' | 'validation' | 'encryption';
-  key: string;
-  language: string;
-  params?: TranslationParams;
-  result?: string;
-  error?: TranslationError;
-  timestamp: Date;
-  duration: number;
-}
-
-export type TranslationEventHandler = (event: TranslationEvent) => void;
-
-// Performance monitoring
-export interface PerformanceMetrics {
-  totalTranslations: number;
-  cacheHitRate: number;
-  averageTranslationTime: number;
-  encryptionTime: number;
-  memoryUsage: number;
-}
-
-// Advanced configuration builders
-export class I18nConfigBuilder {
-  static create(): I18nConfigBuilder;
-  withBaseDir(dir: string): I18nConfigBuilder;
-  withDefaultLanguage(lang: string): I18nConfigBuilder;
-  withEncryption(key: string): I18nConfigBuilder;
-  withCache(enabled: boolean, maxSize?: number, ttl?: number): I18nConfigBuilder;
-  withSecurity(options: Partial<I18nConfig['security']>): I18nConfigBuilder;
-  build(): I18nConfig;
-}
-
-// Namespace management
-export interface NamespaceManager {
-  addNamespace(name: string, translations: TranslationSchema): Promise<void>;
-  removeNamespace(name: string): Promise<void>;
-  getNamespace(name: string): TranslationSchema | null;
-  listNamespaces(): string[];
-}
-
-// Migration utilities
-export interface MigrationOptions {
-  fromVersion: string;
-  toVersion: string;
-  backup: boolean;
-  dryRun: boolean;
-}
-
-export function migrateTranslations(options: MigrationOptions): Promise<MigrationResult>;
-
-export interface MigrationResult {
-  success: boolean;
-  migratedKeys: number;
-  errors: string[];
-  warnings: string[];
-  backupPath?: string;
-}
-
-// Export compatibility with existing runtime
+// runtime/enhanced.d.ts
+// Enhanced runtime API with TypeScript support and AES-256-GCM encryption
+
+export interface TranslationParams extends Record<string, unknown> {
+  count?: number;
+  context?: string;
+  [key: string]: unknown;
+}
+
+export interface TranslationOptions {
+  language?: string;
+  fallbackLanguage?: string;
+  namespace?: string;
+  encryptionKey?: string;
+  enableEncryption?: boolean;
+}
+
+export interface TranslationResult {
+  text: string;
+  language: string;
+  key: string;
+  params: TranslationParams;
+  encrypted: boolean;
+}
+
+export interface I18nConfig {
+  baseDir: string;
+  defaultLanguage: string;
+  fallbackLanguage: string;
+  keySeparator: string;
+  preload: boolean;
+  encryption: {
+    enabled: boolean;
+    algorithm: string;
+    keyLength: number;
+    ivLength: number;
+    authTagLength: number;
+  };
+  cache: {
+    enabled: boolean;
+    maxSize: number;
+    ttl: number;
+  };
+  security: {
+    validateInputs: boolean;
+    sanitizeOutput: boolean;
+    maxKeyLength: number;
+    maxValueLength: number;
+  };
+}
+
+export interface TranslationKey<T = string> {
+  key: string;
+  defaultValue?: T;
+  description?: string;
+  context?: string;
+  plural?: boolean;
+}
+
+export interface PluralizationRule {
+  rule: (count: number) => number;
+  examples: string[];
+}
+
+export interface LanguageConfig {
+  code: string;
+  name: string;
+  direction: 'ltr' | 'rtl';
+  pluralRules: PluralizationRule;
+  dateFormat: string;
+  numberFormat: string;
+}
+
+// Enhanced TypeScript-compatible translation functions
+export function translate<T = string>(key: string, params?: TranslationParams, options?: TranslationOptions): T;
+export function translate<T = string>(key: TranslationKey<T>, params?: TranslationParams, options?: TranslationOptions): T;
+
+export const t: typeof translate;
+
+// Type-safe translation with strict typing
+export function tTyped<T = string>(key: string, params?: TranslationParams, options?: TranslationOptions): T;
+
+// Translation with encryption support
+export function translateEncrypted<T = string>(key: string, params?: TranslationParams, options?: TranslationOptions): Promise<T>;
+
+// Batch translation operations
+export function translateBatch<T = string>(keys: string[], params?: TranslationParams[], options?: TranslationOptions): T[];
+export function translateBatchEncrypted<T = string>(keys: string[], params?: TranslationParams[], options?: TranslationOptions): Promise<T[]>;
+
+// Configuration and initialization
+export function initI18nRuntime(options?: Partial<I18nConfig>): Promise<I18nRuntimeInstance>;
+
+export interface I18nRuntimeInstance {
+  t: typeof translate;
+  translate: typeof translate;
+  translateEncrypted: typeof translateEncrypted;
+  translateBatch: typeof translateBatch;
+  translateBatchEncrypted: typeof translateBatchEncrypted;
+  
+  // Language management
+  setLanguage: (lang: string) => Promise<void>;
+  getLanguage: () => string;
+  getAvailableLanguages: () => string[];
+  refresh: (lang?: string) => Promise<void>;
+  
+  // Configuration
+  getConfig: () => I18nConfig;
+  updateConfig: (updates: Partial<I18nConfig>) => Promise<void>;
+  
+  // Security and encryption
+  setEncryptionKey: (key: string) => void;
+  getEncryptionStatus: () => boolean;
+  encryptData: (data: string) => Promise<string>;
+  decryptData: (encryptedData: string) => Promise<string>;
+  
+  // Validation and utilities
+  validateTranslationKey: (key: string) => boolean;
+  sanitizeTranslation: (text: string) => string;
+  getTranslationMetadata: (key: string) => TranslationResult;
+  
+  // Type utilities
+  createTypedTranslator<T>(): TypedTranslator<T>;
+}
+
+export interface TypedTranslator<T> {
+  t: (key: string, params?: TranslationParams, options?: TranslationOptions) => T;
+  translate: (key: string, params?: TranslationParams, options?: TranslationOptions) => T;
+}
+
+// Utility types for better TypeScript support
+export type TranslationNamespace = string;
+export type TranslationKeyPath = string;
+export type TranslationValue = string | number | boolean | null;
+
+export interface TranslationSchema {
+  [key: string]: TranslationValue | TranslationSchema;
+}
+
+// Error handling types
+export interface TranslationError extends Error {
+  code: string;
+  key: string;
+  language: string;
+  params?: TranslationParams;
+}
+
+export interface ValidationError extends TranslationError {
+  validationErrors: string[];
+}
+
+// Plugin system for extensibility
+export interface TranslationPlugin {
+  name: string;
+  version: string;
+  transform?: (text: string, params: TranslationParams, options: TranslationOptions) => string;
+  validate?: (key: string, params: TranslationParams) => boolean;
+  encrypt?: (data: string, key: string) => Promise<string>;
+  decrypt?: (encryptedData: string, key: string) => Promise<string>;
+}
+
+// Event system for monitoring
+export interface TranslationEvent {
+  type: 'translation' | 'error' | 'validation' | 'encryption';
+  key: string;
+  language: string;
+  params?: TranslationParams;
+  result?: string;
+  error?: TranslationError;
+  timestamp: Date;
+  duration: number;
+}
+
+export type TranslationEventHandler = (event: TranslationEvent) => void;
+
+// Performance monitoring
+export interface PerformanceMetrics {
+  totalTranslations: number;
+  cacheHitRate: number;
+  averageTranslationTime: number;
+  encryptionTime: number;
+  memoryUsage: number;
+}
+
+// Advanced configuration builders
+export class I18nConfigBuilder {
+  static create(): I18nConfigBuilder;
+  withBaseDir(dir: string): I18nConfigBuilder;
+  withDefaultLanguage(lang: string): I18nConfigBuilder;
+  withEncryption(key: string): I18nConfigBuilder;
+  withCache(enabled: boolean, maxSize?: number, ttl?: number): I18nConfigBuilder;
+  withSecurity(options: Partial<I18nConfig['security']>): I18nConfigBuilder;
+  build(): I18nConfig;
+}
+
+// Namespace management
+export interface NamespaceManager {
+  addNamespace(name: string, translations: TranslationSchema): Promise<void>;
+  removeNamespace(name: string): Promise<void>;
+  getNamespace(name: string): TranslationSchema | null;
+  listNamespaces(): string[];
+}
+
+// Migration utilities
+export interface MigrationOptions {
+  fromVersion: string;
+  toVersion: string;
+  backup: boolean;
+  dryRun: boolean;
+}
+
+export function migrateTranslations(options: MigrationOptions): Promise<MigrationResult>;
+
+export interface MigrationResult {
+  success: boolean;
+  migratedKeys: number;
+  errors: string[];
+  warnings: string[];
+  backupPath?: string;
+}
+
+// Export compatibility with existing runtime
 export * from './index.d.ts';

package/runtime/index.d.ts

@@ -1,29 +1,29 @@
-// runtime/index.d.ts
-// Public runtime API types for i18ntk
-
-export interface InitOptions {
-  baseDir?: string;
-  language?: string;
-  fallbackLanguage?: string;
-  keySeparator?: string;
-  preload?: boolean;
-}
-
-export type TranslateParams = Record<string, unknown>;
-
-export function translate(key: string, params?: TranslateParams): string;
-export const t: typeof translate;
-
-export function initRuntime(options?: InitOptions): {
-  t: typeof translate;
-  translate: typeof translate;
-  setLanguage: typeof setLanguage;
-  getLanguage: typeof getLanguage;
-  getAvailableLanguages: typeof getAvailableLanguages;
-  refresh: typeof refresh;
-};
-
-export function setLanguage(lang: string): void;
-export function getLanguage(): string;
-export function getAvailableLanguages(): string[];
-export function refresh(lang?: string): void;
+// runtime/index.d.ts
+// Public runtime API types for i18ntk
+
+export interface InitOptions {
+  baseDir?: string;
+  language?: string;
+  fallbackLanguage?: string;
+  keySeparator?: string;
+  preload?: boolean;
+}
+
+export type TranslateParams = Record<string, unknown>;
+
+export function translate(key: string, params?: TranslateParams): string;
+export const t: typeof translate;
+
+export function initRuntime(options?: InitOptions): {
+  t: typeof translate;
+  translate: typeof translate;
+  setLanguage: typeof setLanguage;
+  getLanguage: typeof getLanguage;
+  getAvailableLanguages: typeof getAvailableLanguages;
+  refresh: typeof refresh;
+};
+
+export function setLanguage(lang: string): void;
+export function getLanguage(): string;
+export function getAvailableLanguages(): string[];
+export function refresh(lang?: string): void;