/**
 * Provides easy access to all drag drop components that are registered on a page.
 * Items can be retrieved either directly by DOM node id, or by passing in the drag drop event
 * that occurred and looking up the event target.
 */
Ext.define('Ext.dd.Registry', {
    singleton: true,
    constructor: function() {
        this.elements = {};
        this.handles = {};
        this.autoIdSeed = 0;
    },
    
    getId: function(el, autogen) {
        var id;
        
        if (typeof el === "string") {
            return el;
        }
        
        id = el.id;
 
        if (!id && autogen !== false) {
            id = "extdd-" + (++this.autoIdSeed);
            el.id = id;
        }
 
        return id;
    },
    
    /**
     * Registers a drag drop element.
     *
     * @param {String/HTMLElement} el The id or DOM node to register
     * @param {Object} data An custom data object that will be passed between the elements that are
     * involved in drag drop operations. You can populate this object with any arbitrary properties
     * that your own code knows how to interpret, plus there are some specific properties known to
     * the Registry that should be populated in the data object (if applicable):
     * @param {HTMLElement[]} data.handles Array of DOM nodes that trigger dragging for the element
     * being registered.
     * @param {Boolean} data.isHandle True if the element passed in triggers dragging itself,
     * else false.
     */
    register: function(el, data) {
        var hs, i, len;
        
        data = data || {};
 
        if (typeof el === "string") {
            el = document.getElementById(el);
        }
 
        data.ddel = el;
        this.elements[this.getId(el)] = data;
 
        if (data.isHandle !== false) {
            this.handles[data.ddel.id] = data;
        }
 
        if (data.handles) {
            hs = data.handles;
 
            for (= 0, len = hs.length; i < len; i++) {
                this.handles[this.getId(hs[i])] = data;
            }
        }
    },
 
    /**
     * Unregister a drag drop element
     * @param {String/HTMLElement} el The id or DOM node to unregister
     */
    unregister: function(el) {
        var id = this.getId(el, false),
            data = this.elements[id],
            hs, i, len;
 
        if (data) {
            delete this.elements[id];
 
            if (data.handles) {
                hs = data.handles;
 
                for (= 0, len = hs.length; i < len; i++) {
                    delete this.handles[this.getId(hs[i], false)];
                }
            }
        }
    },
 
    /**
     * Returns the handle registered for a DOM Node by id
     * @param {String/HTMLElement} id The DOM node or id to look up
     * @return {Object} handle The custom handle data
     */
    getHandle: function(id) {
        if (typeof id !== "string") { // must be element?
            id = id.id;
        }
 
        return this.handles[id];
    },
 
    /**
     * Returns the handle that is registered for the DOM node that is the target of the event
     * @param {Event} e The event
     * @return {Object} handle The custom handle data
     */
    getHandleFromEvent: function(e) {
        var t = e.getTarget();
 
        return t ? this.handles[t.id] : null;
    },
 
    /**
     * Returns a custom data object that is registered for a DOM node by id
     * @param {String/HTMLElement} id The DOM node or id to look up
     * @return {Object} data The custom data
     */
    getTarget: function(id) {
        if (typeof id !== "string") { // must be element?
            id = id.id;
        }
 
        return this.elements[id];
    },
 
    /**
     * Returns a custom data object that is registered for the DOM node that is the target
     * of the event
     * @param {Event} e The event
     * @return {Object} data The custom data
     */
    getTargetFromEvent: function(e) {
        var t = e.getTarget();
 
        return t ? this.elements[t.id] || this.handles[t.id] : null;
    }
});