Fx ready

src/main/java/org/openautonomousconnection/luascript/hosts/EventHost.java

@@ -1,37 +1,41 @@
 package org.openautonomousconnection.luascript.hosts;
 
+import java.util.Map;
+
 /**
- * Event subscription abstraction (implemented by the client UI layer).
+ * Abstraction over DOM event subscription for scripting.
+ *
+ * <p>Implementations forward DOM events into a {@code LuaEventRouter}.</p>
  */
 public interface EventHost {
 
     /**
-     * Subscribes to an element event.
+     * Adds a listener for an element's event.
      *
      * @param elementId element id
-     * @param eventName event name (e.g. click)
+     * @param eventName normalized event name
      */
     void addListener(String elementId, String eventName);
 
     /**
-     * Unsubscribes from an element event.
+     * Removes a listener for an element's event.
      *
      * @param elementId element id
-     * @param eventName event name
+     * @param eventName normalized event name
      */
     void removeListener(String elementId, String eventName);
 
     /**
-     * Subscribes to a global event (app/window scope).
+     * Adds a global (document-level) listener.
      *
-     * @param eventName event name
+     * @param eventName normalized event name
      */
     void addGlobalListener(String eventName);
 
     /**
-     * Unsubscribes from a global event.
+     * Removes a global (document-level) listener.
      *
-     * @param eventName event name
+     * @param eventName normalized event name
      */
     void removeGlobalListener(String eventName);
-}
+}