@digitaldefiance/i18n-lib 1.1.1 → 1.1.2

package/README.md

@@ -721,6 +721,52 @@ yarn test enum-registry.spec.ts
 yarn test i18n-engine.spec.ts
 ```
 
+### Test Cleanup and Instance Management
+
+For proper test isolation when using the plugin-based architecture, use the cleanup utilities:
+
+```typescript
+import { PluginI18nEngine, resetAllI18nEngines } from '@digitaldefiance/i18n-lib';
+
+describe('My tests', () => {
+  beforeEach(() => {
+    // Clean up any existing instances before each test
+    PluginI18nEngine.clearAllInstances();
+  });
+
+  afterEach(() => {
+    // Or use the convenience function
+    resetAllI18nEngines();
+  });
+
+  // Or use specific cleanup methods
+  it('should manage instances', () => {
+    const engine1 = PluginI18nEngine.createInstance('app1', [englishLang]);
+    const engine2 = PluginI18nEngine.createInstance('app2', [frenchLang]);
+
+    // Check if instances exist
+    expect(PluginI18nEngine.hasInstance('app1')).toBe(true);
+    expect(PluginI18nEngine.hasInstance('app2')).toBe(true);
+
+    // Remove specific instance
+    PluginI18nEngine.removeInstance('app1');
+    expect(PluginI18nEngine.hasInstance('app1')).toBe(false);
+
+    // Clear all instances and component registrations
+    PluginI18nEngine.resetAll();
+    expect(PluginI18nEngine.hasInstance('app2')).toBe(false);
+  });
+});
+```
+
+#### Available Cleanup Methods
+
+- `PluginI18nEngine.clearAllInstances()` - Remove all engine instances
+- `PluginI18nEngine.removeInstance(key?)` - Remove specific instance by key
+- `PluginI18nEngine.hasInstance(key?)` - Check if instance exists  
+- `PluginI18nEngine.resetAll()` - Clear instances and component registrations
+- `resetAllI18nEngines()` - Convenience function that calls `resetAll()`
+
 ## Extensible Configuration
 
 The library supports layered extension across multiple libraries using TypeScript module augmentation:
@@ -890,6 +936,11 @@ Part of the DigitalBurnbag project - a secure file sharing and automated protoco
 
 ## ChangeLog
 
+### Version 1.1.2
+
+- Sat Oct 11 2025 19:25:00 GMT-0700 (Pacific Daylight Time)
+  - Added cleanup mechanisms for other modules to deregister, etc.
+
 ### Version 1.1.1
 
 - Sat Oct 11 2025 17:47:00 GMT-0700 (Pacific Daylight Time)

package/dist/component-registry.d.ts

@@ -61,4 +61,8 @@ export declare class ComponentRegistry<TLanguages extends string> {
      * Merge existing strings with new strings
      */
     private mergeStrings;
+    /**
+     * Clear all components and their strings (useful for testing)
+     */
+    clearAllComponents(): void;
 }

package/dist/component-registry.js

@@ -234,5 +234,12 @@ class ComponentRegistry {
         }
         return result;
     }
+    /**
+     * Clear all components and their strings (useful for testing)
+     */
+    clearAllComponents() {
+        this.components.clear();
+        this.componentStrings.clear();
+    }
 }
 exports.ComponentRegistry = ComponentRegistry;

package/dist/index.d.ts

@@ -33,3 +33,8 @@ export * from './translation-response';
 export { createCoreI18nEngine as createCoreI18n } from './core-i18n';
 export { I18nEngine as I18n } from './i18n-engine';
 export { PluginI18nEngine as PluginI18n } from './plugin-i18n-engine';
+/**
+ * Reset all I18n engines and clear component registrations
+ * Useful for test cleanup
+ */
+export declare function resetAllI18nEngines(): void;

package/dist/index.js

@@ -15,6 +15,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.PluginI18n = exports.I18n = exports.createCoreI18n = void 0;
+exports.resetAllI18nEngines = resetAllI18nEngines;
 // Legacy exports (for backwards compatibility)
 __exportStar(require("./active-context"), exports);
 __exportStar(require("./component-definition"), exports);
@@ -55,3 +56,12 @@ var i18n_engine_1 = require("./i18n-engine");
 Object.defineProperty(exports, "I18n", { enumerable: true, get: function () { return i18n_engine_1.I18nEngine; } });
 var plugin_i18n_engine_1 = require("./plugin-i18n-engine");
 Object.defineProperty(exports, "PluginI18n", { enumerable: true, get: function () { return plugin_i18n_engine_1.PluginI18nEngine; } });
+// Testing utilities
+const plugin_i18n_engine_2 = require("./plugin-i18n-engine");
+/**
+ * Reset all I18n engines and clear component registrations
+ * Useful for test cleanup
+ */
+function resetAllI18nEngines() {
+    plugin_i18n_engine_2.PluginI18nEngine.resetAll();
+}

package/dist/plugin-i18n-engine.d.ts

@@ -123,4 +123,25 @@ export declare class PluginI18nEngine<TLanguages extends string> {
         errors: string[];
         warnings: string[];
     };
+    /**
+     * Clear all component registrations for this instance (useful for testing)
+     */
+    clearAllComponents(): void;
+    /**
+     * Clear all named instances (useful for testing)
+     */
+    static clearAllInstances(): void;
+    /**
+     * Remove a specific named instance
+     */
+    static removeInstance(key?: string): boolean;
+    /**
+     * Check if an instance exists
+     */
+    static hasInstance(key?: string): boolean;
+    /**
+     * Reset all plugin engines and clear component registrations
+     * Useful for test cleanup
+     */
+    static resetAll(): void;
 }

package/dist/plugin-i18n-engine.js

@@ -49,6 +49,11 @@ class PluginI18nEngine {
             timezone: this.config.timezone,
             adminTimezone: this.config.adminTimezone,
         };
+        // Auto-register as default instance if none exists
+        if (!PluginI18nEngine._defaultKey) {
+            PluginI18nEngine._instances.set(PluginI18nEngine.DefaultInstanceKey, this);
+            PluginI18nEngine._defaultKey = PluginI18nEngine.DefaultInstanceKey;
+        }
     }
     /**
      * Create a new instance with a specific key
@@ -256,6 +261,50 @@ class PluginI18nEngine {
         }
         return { isValid, errors, warnings };
     }
+    /**
+     * Clear all component registrations for this instance (useful for testing)
+     */
+    clearAllComponents() {
+        this.componentRegistry.clearAllComponents();
+    }
+    /**
+     * Clear all named instances (useful for testing)
+     */
+    static clearAllInstances() {
+        PluginI18nEngine._instances.clear();
+        PluginI18nEngine._defaultKey = null;
+    }
+    /**
+     * Remove a specific named instance
+     */
+    static removeInstance(key) {
+        const instanceKey = key || PluginI18nEngine.DefaultInstanceKey;
+        const removed = PluginI18nEngine._instances.delete(instanceKey);
+        // If we removed the default instance, clear the default key
+        if (removed && PluginI18nEngine._defaultKey === instanceKey) {
+            PluginI18nEngine._defaultKey = null;
+        }
+        return removed;
+    }
+    /**
+     * Check if an instance exists
+     */
+    static hasInstance(key) {
+        const instanceKey = key || PluginI18nEngine.DefaultInstanceKey;
+        return PluginI18nEngine._instances.has(instanceKey);
+    }
+    /**
+     * Reset all plugin engines and clear component registrations
+     * Useful for test cleanup
+     */
+    static resetAll() {
+        for (const [key, engine] of PluginI18nEngine._instances) {
+            // Clear component registrations for each engine
+            engine.clearAllComponents();
+        }
+        PluginI18nEngine._instances.clear();
+        PluginI18nEngine._defaultKey = null;
+    }
 }
 exports.PluginI18nEngine = PluginI18nEngine;
 /**

package/package.json

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