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

package org.openautonomousconnection.luascript.hosts;

/**
 * Abstraction over DOM event subscription for scripting.
 *
 * <p>Implementations forward DOM events into a {@code LuaEventRouter}.</p>
 */
public interface EventHost {

    /**
     * Adds a listener for an element's event.
     *
     * @param elementId element id
     * @param eventName normalized event name
     */
    void addListener(String elementId, String eventName);

    /**
     * Removes a listener for an element's event.
     *
     * @param elementId element id
     * @param eventName normalized event name
     */
    void removeListener(String elementId, String eventName);

    /**
     * Adds a global (document-level) listener.
     *
     * @param eventName normalized event name
     */
    void addGlobalListener(String eventName);

    /**
     * Removes a global (document-level) listener.
     *
     * @param eventName normalized event name
     */
    void removeGlobalListener(String eventName);
}