/**
 * An adapter for the Shadowbox media viewer and the Yahoo! User Interface (YUI)
 * JavaScript library.
 *
 * This file is part of Shadowbox.
 *
 * Shadowbox is free software: you can redistribute it and/or modify it under
 * the terms of the GNU Lesser General Public License as published by the Free
 * Software Foundation, either version 3 of the License, or (at your option)
 * any later version.
 *
 * Shadowbox is distributed in the hope that it will be useful, but WITHOUT ANY
 * WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
 * FOR A PARTICULAR PURPOSE.  See the GNU Lesser General Public License for
 * more details.
 *
 * You should have received a copy of the GNU Lesser General Public License
 * along with Shadowbox.  If not, see <http://www.gnu.org/licenses/>.
 *
 * @author  Michael J. I. Jackson <mjijackson@gmail.com>
 * @copyright 2007 Michael J. I. Jackson
 * @license   http://www.gnu.org/licenses/lgpl-3.0.txt GNU LGPL 3.0
 * @version   SVN: $Id: shadowbox-yui.js 48 2008-01-26 09:58:25Z mjijackson $
 */

if(typeof YAHOO == 'undefined'){
  throw 'Unable to load Shadowbox, core YUI utilities (yahoo, dom, event, anim) not found.';
}

// create the Shadowbox object first
var Shadowbox = {};

Shadowbox.lib = function(){

  var E = YAHOO.util.Event;
  var D = YAHOO.util.Dom;

  return {

    /**
   * Gets the value of the style on the given element.
   *
   * @param {HTMLElement} el  The DOM element
   * @param {String}    style The name of the style (e.g. margin-top)
   * @return  {mixed}       The value of the given style
   * @public
   */
    getStyle: function(el, style){
    return D.getStyle(el, style);
    },

    /**
   * Sets the style on the given element to the given value. May be an
   * object to specify multiple values.
   *
   * @param {HTMLElement} el  The DOM element
   * @param {String/Object} style The name of the style to set if a
   *            string, or an object of name =>
   *            value pairs
   * @param {String}    value The value to set the given style to
   * @return  void
   * @public
   */
    setStyle: function(el, style, value){
    if(typeof style != 'object'){
      var temp = {};
      temp[style] = value;
      style = temp;
    }
    for(var s in style){
      D.setStyle(el, s, style[s]);
    }
    },

    /**
   * Gets a reference to the given element.
   *
   * @param {String/HTMLElement}  el  The element to fetch
   * @return  {HTMLElement}       A reference to the element
   * @public
   */
    get: function(el){
    return D.get(el);
    },

    /**
   * Removes an element from the DOM.
   *
   * @param {HTMLElement}     el  The element to remove
   * @return  void
   * @public
   */
    remove: function(el){
    el.parentNode.removeChild(el);
    },

    /**
   * Gets the target of the given event. The event object passed will be
   * the same object that is passed to listeners registered with
   * addEvent().
   *
   * @param {mixed}       e   The event object
   * @return  {HTMLElement}       The event's target element
   * @public
   */
    getTarget: function(e){
    return E.getTarget(e.browserEvent || e);
    },

    /**
   * Prevents the event's default behavior. The event object passed will
   * be the same object that is passed to listeners registered with
   * addEvent().
   *
   * @param {mixed}       e   The event object
   * @return  void
   * @public
   */
    preventDefault: function(e){
    E.preventDefault(e.browserEvent || e);
    },

    /**
   * Adds an event listener to the given element. It is expected that this
   * function will be passed the event as its first argument.
   *
   * @param {HTMLElement} el    The DOM element to listen to
   * @param {String}    name    The name of the event to register
   *              (i.e. 'click', 'scroll', etc.)
   * @param {Function}  handler   The event handler function
   * @return  void
   * @public
   */
    addEvent: function(el, name, handler){
    E.addListener(el, name, handler);
    },

    /**
   * Removes an event listener from the given element.
   *
   * @param {HTMLElement} el    The DOM element to stop listening to
   * @param {String}    name    The name of the event to stop
   *              listening for (i.e. 'click')
   * @param {Function}  handler   The event handler function
   * @return  void
   * @public
   */
    removeEvent: function(el, name, handler){
    E.removeListener(el, name, handler);
    },

    /**
   * Animates numerous styles of the given element. The second parameter
   * of this function will be an object of the type that is expected by
   * YAHOO.util.Anim. See http://developer.yahoo.com/yui/docs/YAHOO.util.Anim.html
   * for more information.
   *
   * @param {HTMLElement} el    The DOM element to animate
   * @param {Object}    obj   The animation attributes/parameters
   * @param {Number}    duration  The duration of the animation
   *              (in seconds)
   * @param {Function}  callback  A callback function to call when
   *              the animation completes
   * @return  void
   * @public
   */
    animate: function(el, obj, duration, callback){
    var anim = new YAHOO.util.Anim(el, obj, duration, YAHOO.util.Easing.easeOut);
    if(typeof callback == 'function'){
      var f = function(){
        anim.onComplete.unsubscribe(f);
        callback.call(anim, anim);
      };
      anim.onComplete.subscribe(f, anim, true);
    }
    anim.animate();
    }

  };

}();