/*

Copyright (c) 2009, Yahoo! Inc. All rights reserved.

Code licensed under the BSD License:

http://developer.yahoo.net/yui/license.txt

version: 3.0.0b1

build: 1163

*/

YUI.add('console', function(Y) {

/**

 * Console creates a visualization for messages logged through calls to a YUI

 * instance's <code>Y.log( message, category, source )</code> method.  The

 * debug versions of YUI modules will include logging statements to offer some

 * insight into the steps executed during that module's operation.  Including

 * log statements in your code will cause those messages to also appear in the

 * Console.  Use Console to aid in developing your page or application.

 *

 * Entry categories "info", "warn", and "error"

 * are also referred to as the log level, and entries are filtered against the

 * configured logLevel.

 *

 * @module console

 * @class Console

 * @extends Widget

 * @param conf {Object} Configuration object (see Configuration attributes)

 * @constructor

 */

var getCN = Y.ClassNameManager.getClassName,

    CHECKED        = 'checked',

    CLEAR          = 'clear',

    CLICK          = 'click',

    COLLAPSED      = 'collapsed',

    CONSOLE        = 'console',

    CONTENT_BOX    = 'contentBox',

    DISABLED       = 'disabled',

    ENTRY          = 'entry',

    ENTRY_TEMPLATE = 'entryTemplate',

    ERROR          = 'error',

    HEIGHT         = 'height',

    INFO           = 'info',

    INNER_HTML     = 'innerHTML',

    LAST_TIME      = 'lastTime',

    PAUSE          = 'pause',

    PAUSED         = 'paused',

    RESET          = 'reset',

    START_TIME     = 'startTime',

    TITLE          = 'title',

    WARN           = 'warn',

    DOT = '.',

    C_BUTTON           = getCN(CONSOLE,'button'),

    C_CHECKBOX         = getCN(CONSOLE,'checkbox'),

    C_CLEAR            = getCN(CONSOLE,CLEAR),

    C_COLLAPSE         = getCN(CONSOLE,'collapse'),

    C_COLLAPSED        = getCN(CONSOLE,COLLAPSED),

    C_CONSOLE_CONTROLS = getCN(CONSOLE,'controls'),

    C_CONSOLE_HD       = getCN(CONSOLE,'hd'),

    C_CONSOLE_BD       = getCN(CONSOLE,'bd'),

    C_CONSOLE_FT       = getCN(CONSOLE,'ft'),

    C_CONSOLE_TITLE    = getCN(CONSOLE,TITLE),

    C_ENTRY            = getCN(CONSOLE,ENTRY),

    C_ENTRY_CAT        = getCN(CONSOLE,ENTRY,'cat'),

    C_ENTRY_CONTENT    = getCN(CONSOLE,ENTRY,'content'),

    C_ENTRY_META       = getCN(CONSOLE,ENTRY,'meta'),

    C_ENTRY_SRC        = getCN(CONSOLE,ENTRY,'src'),

    C_ENTRY_TIME       = getCN(CONSOLE,ENTRY,'time'),

    C_PAUSE            = getCN(CONSOLE,PAUSE),

    C_PAUSE_LABEL      = getCN(CONSOLE,PAUSE,'label'),

    RE_INLINE_SOURCE = /^(\S+)\s/,

    RE_AMP = /&/g,

    RE_GT  = />/g,

    RE_LT  = /</g,

    ESC_AMP = '&',

    ESC_GT  = '>',

    ESC_LT  = '<',

    L = Y.Lang,

    create     = Y.Node.create,

    isNumber   = L.isNumber,

    isString   = L.isString,

    merge      = Y.merge,

    substitute = Y.substitute;

function Console() {

    Console.superclass.constructor.apply(this,arguments);

}

Y.mix(Console, {

    /**

     * The identity of the widget.

     *

     * @property Console.NAME

     * @type String

     * @static

     */

    NAME : CONSOLE,

    /**

     * Static identifier for logLevel configuration setting to allow all

     * incoming messages to generate Console entries.

     *

     * @property Console.LOG_LEVEL_INFO

     * @type String

     * @static

     */

    LOG_LEVEL_INFO  : INFO,

    /**

     * Static identifier for logLevel configuration setting to allow only

     * incoming messages of logLevel "warn" or "error"

     * to generate Console entries.

     *

     * @property Console.LOG_LEVEL_WARN

     * @type String

     * @static

     */

    LOG_LEVEL_WARN  : WARN,

    /**

     * Static identifier for logLevel configuration setting to allow only

     * incoming messages of logLevel "error" to generate

     * Console entries.

     *

     * @property Console.LOG_LEVEL_ERROR

     * @type String

     * @static

     */

    LOG_LEVEL_ERROR : ERROR,

    /**

     * Map (object) of classNames used to populate the placeholders in the

     * Console.ENTRY_TEMPLATE markup when rendering a new Console entry.

     *

     * <p>By default, the keys contained in the object are:</p>

     * <ul>

     *    <li>entry_class</li>

     *    <li>entry_meta_class</li>

     *    <li>entry_cat_class</li>

     *    <li>entry_src_class</li>

     *    <li>entry_time_class</li>

     *    <li>entry_content_class</li>

     * </ul>

     *

     * @property Console.ENTRY_CLASSES

     * @type Object

     * @static

     */

    ENTRY_CLASSES   : {

        entry_class         : C_ENTRY,

        entry_meta_class    : C_ENTRY_META,

        entry_cat_class     : C_ENTRY_CAT,

        entry_src_class     : C_ENTRY_SRC,

        entry_time_class    : C_ENTRY_TIME,

        entry_content_class : C_ENTRY_CONTENT

    },

    /**

     * Map (object) of classNames used to populate the placeholders in the

     * Console.HEADER_TEMPLATE, Console.BODY_TEMPLATE, and

     * Console.FOOTER_TEMPLATE markup when rendering the Console UI.

     *

     * <p>By default, the keys contained in the object are:</p>

     * <ul>

     *   <li>console_hd_class</li>

     *   <li>console_bd_class</li>

     *   <li>console_ft_class</li>

     *   <li>console_controls_class</li>

     *   <li>console_checkbox_class</li>

     *   <li>console_pause_class</li>

     *   <li>console_pause_label_class</li>

     *   <li>console_button_class</li>

     *   <li>console_clear_class</li>

     *   <li>console_collapse_class</li>

     *   <li>console_title_class</li>

     * </ul>

     *

     * @property Console.CHROME_CLASSES

     * @type Object

     * @static

     */

    CHROME_CLASSES  : {

        console_hd_class       : C_CONSOLE_HD,

        console_bd_class       : C_CONSOLE_BD,

        console_ft_class       : C_CONSOLE_FT,

        console_controls_class : C_CONSOLE_CONTROLS,

        console_checkbox_class : C_CHECKBOX,

        console_pause_class    : C_PAUSE,

        console_pause_label_class : C_PAUSE_LABEL,

        console_button_class   : C_BUTTON,

        console_clear_class    : C_CLEAR,

        console_collapse_class : C_COLLAPSE,

        console_title_class    : C_CONSOLE_TITLE

    },

    /**

     * Markup template used to generate the DOM structure for the header

     * section of the Console when it is rendered.  The template includes

     * these {placeholder}s:

     *

     * <ul>

     *   <li>console_button_class - contributed by Console.CHROME_CLASSES</li>

     *   <li>console_collapse_class - contributed by Console.CHROME_CLASSES</li>

     *   <li>console_hd_class - contributed by Console.CHROME_CLASSES</li>

     *   <li>console_title_class - contributed by Console.CHROME_CLASSES</li>

     *   <li>str_collapse - pulled from attribute strings.collapse</li>

     *   <li>str_title - pulled from attribute strings.title</li>

     * </ul>

     *

     * @property Console.HEADER_TEMPLATE

     * @type String

     * @static

     */

    HEADER_TEMPLATE :

        '<div class="{console_hd_class}">'+

            '<h4 class="{console_title_class}">{str_title}</h4>'+

            '<button type="button" class="'+

                '{console_button_class} {console_collapse_class}">{str_collapse}'+

            '</button>'+

        '</div>',

    /**

     * Markup template used to generate the DOM structure for the Console body

     * (where the messages are inserted) when it is rendered.  The template

     * includes only the {placeholder} "console_bd_class", which is

     * constributed by Console.CHROME_CLASSES.

     *

     * @property Console.BODY_TEMPLATE

     * @type String

     * @static

     */

    BODY_TEMPLATE : '<div class="{console_bd_class}"></div>',

    /**

     * Markup template used to generate the DOM structure for the footer

     * section of the Console when it is rendered.  The template includes

     * many of the {placeholder}s from Console.CHROME_CLASSES as well as:

     *

     * <ul>

     *   <li>id_guid - generated unique id, relates the label and checkbox</li>

     *   <li>str_pause - pulled from attribute strings.pause</li>

     *   <li>str_clear - pulled from attribute strings.clear</li>

     * </ul>

     *

     * @property Console.FOOTER_TEMPLATE

     * @type String

     * @static

     */

    FOOTER_TEMPLATE :

        '<div class="{console_ft_class}">'+

            '<div class="{console_controls_class}">'+

                '<label for="{id_guid}" class="{console_pause_label_class}">'+

                    '<input type="checkbox" class="{console_checkbox_class} '+

                        '{console_pause_class}" value="1" id="{id_guid}"> '+

                    '{str_pause}</label>' +

                '<button type="button" class="'+

                    '{console_button_class} {console_clear_class}">{str_clear}'+

                '</button>'+

            '</div>'+

        '</div>',

    /**

     * Default markup template used to create the DOM structure for Console

     * entries. The markup contains {placeholder}s for content and classes

     * that are replaced via Y.substitute.  The default template contains

     * the {placeholder}s identified in Console.ENTRY_CLASSES as well as the

     * following placeholders that will be populated by the log entry data:

     *

     * <ul>

     *   <li>cat_class</li>

     *   <li>src_class</li>

     *   <li>label</li>

     *   <li>totalTime</li>

     *   <li>elapsedTime</li>

     *   <li>localTime</li>

     *   <li>sourceAndDetail</li>

     *   <li>message</li>

     * </ul>

     *

     * @property Console.ENTRY_TEMPLATE

     * @type String

     * @static

     */

    ENTRY_TEMPLATE :

        '<div class="{entry_class} {cat_class} {src_class}">'+

            '<p class="{entry_meta_class}">'+

                '<span class="{entry_src_class}">'+

                    '{sourceAndDetail}'+

                '</span>'+

                '<span class="{entry_cat_class}">'+

                    '{label}</span>'+

                '<span class="{entry_time_class}">'+

                    ' {totalTime}ms (+{elapsedTime}) {localTime}'+

                '</span>'+

            '</p>'+

            '<pre class="{entry_content_class}">{message}</pre>'+

        '</div>',

    /**

     * Static property used to define the default attribute configuration of

     * the Widget.

     *

     * @property Console.ATTRS

     * @Type Object

     * @static

     */

    ATTRS : {

        /**

         * Name of the custom event that will communicate log messages.

         *

         * @attribute logEvent

         * @type String

         * @default "yui:log"

         */

        logEvent : {

            value : 'yui:log',

            writeOnce : true,

            validator : isString

        },

        /**

         * Object that will emit the log events.  By default the YUI instance.

         * To have a single Console capture events from all YUI instances, set

         * this to the Y.Global object.

         *

         * @attribute logSource

         * @type EventTarget

         * @default Y

         */

        logSource : {

            value : Y,

            writeOnce : true,

            validator : function (v) {

                return v && Y.Lang.isFunction(v.on);

            }

        },

        /**

         * Collection of strings used to label elements in the Console UI.

         * Default collection contains the following name:value pairs:

         *

         * <ul>

         *   <li>title : &quot;Log Console&quot;</li>

         *   <li>pause : &quot;Pause&quot;</li>

         *   <li>clear : &quot;Clear&quot;</li>

         *   <li>collapse : &quot;Collapse&quot;</li>

         *   <li>expand : &quot;Expand&quot;</li>

         * </ul>

         *

         * @attribute strings

         * @type Object

         */

        strings : {

            value : {

                title : "Log Console",

                pause : "Pause",

                clear : "Clear",

                collapse : "Collapse",

                expand   : "Expand"

            }

        },

        /**

         * Boolean to pause the outputting of new messages to the console.

         * When paused, messages will accumulate in the buffer.

         *

         * @attribute paused

         * @type boolean

         * @default false

         */

        paused : {

            value : false,

            validator : L.isBoolean

        },

        /**

         * If a category is not specified in the Y.log(..) statement, this

         * category will be used. Categories "info",

         * "warn", and "error" are also called log level.

         *

         * @attribute defaultCategory

         * @type String

         * @default "info"

         */

        defaultCategory : {

            value : INFO,

            validator : isString

        },

        /**

         * If a source is not specified in the Y.log(..) statement, this

         * source will be used.

         *

         * @attribute defaultSource

         * @type String

         * @default "global"

         */

        defaultSource   : {

            value : 'global',

            validator : isString

        },

        /**

         * Markup template used to create the DOM structure for Console entries.

         *

         * @attribute entryTemplate

         * @type String

         * @default (see Console.ENTRY_TEMPLATE)

         */

        entryTemplate : {

            value : '',

            validator : isString

        },

        /**

         * Minimum entry log level to render into the Console.  The initial

         * logLevel value for all Console instances defaults from the

         * Y.config.logLevel YUI configuration, or Console.LOG_LEVEL_INFO if

         * that configuration is not set.

         *

         * Possible values are "info", "warn",

         * "error" (case insensitive), or their corresponding statics

         * Console.LOG_LEVEL_INFO and so on.

         *

         * @attribute logLevel

         * @type String

         * @default Y.config.logLevel or Console.LOG_LEVEL_INFO

         */

        logLevel : {

            value : Y.config.logLevel || INFO,

            setter : function (v) {

                return this._setLogLevel(v);

            }

        },