refactor: Update i18n registration process for dynamic translation support

Author: PyCompiler ARK++

Plugins/Cleaner/__init__.py

@@ -202,9 +202,9 @@ def _load_lang(c: str) -> bool:
 
 def bcasl_register(manager):
     manager.add_plugin(PLUGIN)
-    # Register in INSTANCES for i18n support
+    # Register in i18n registry for dynamic translation updates
     try:
-        from Plugins_SDK.GeneralContext.i18n import INSTANCES
-        INSTANCES[META.id] = PLUGIN
+        from Plugins_SDK.GeneralContext.i18n import register_instance
+        register_instance(META.id, PLUGIN)
     except Exception:
         pass

Plugins_SDK/GeneralContext/i18n.py

@@ -18,26 +18,43 @@
 
 """
 
-from typing import Any, Union
+from typing import Any
 
-try:
-    from bcasl import BcPluginBase
-except ImportError:
-    BcPluginBase = type(None)  # type: ignore
+# Keep live Plugins instances to support dynamic interactions (e.g., i18n refresh)
+# We avoid importing BCASL types here to keep this utility decoupled.
+INSTANCES: dict[str, Any] = {}
 
-try:
-    from acasl import AcPluginBase
-except ImportError:
-    AcPluginBase = type(None)  # type: ignore
 
+def register_instance(plugin_id: str, instance: Any) -> None:
+    """Register a live plugin instance for i18n updates.
+    The instance may optionally implement 'apply_i18n(gui, tr: dict)'.
+    """
+    try:
+        if plugin_id:
+            INSTANCES[str(plugin_id)] = instance
+    except Exception:
+        pass
 
 
-# Keep live Plugins Ac/Bc/Ce instances to support dynamic interactions (e.g., i18n refresh)
-INSTANCES: dict[str, Any] = {}
+def unregister_instance(plugin_id: str) -> None:
+    """Unregister a plugin instance when it is disposed/unloaded."""
+    try:
+        if plugin_id in INSTANCES:
+            INSTANCES.pop(plugin_id, None)
+    except Exception:
+        pass
+
+
+def clear_instances() -> None:
+    """Clear all tracked instances (e.g., when reloading plugins)."""
+    try:
+        INSTANCES.clear()
+    except Exception:
+        pass
 
 
-def apply_translations(gui, tr: dict) -> None:
-    """Propagate i18n translations to all Plugin types that expose 'apply_i18n(gui, tr)'."""
+def apply_translations(gui: Any, tr: dict) -> None:
+    """Propagate i18n translations to all plugins that expose 'apply_i18n(gui, tr)'."""
     try:
         for plugin_id, inst in list(INSTANCES.items()):
             try: