@bennerinformatics/ember-fw-table 2.1.4 → 2.1.6

package/docs/assets/js/apidocs.js

@@ -0,0 +1,376 @@
+YUI().use(
+    'yuidoc-meta',
+    'api-list', 'history-hash', 'node-screen', 'node-style', 'pjax',
+function (Y) {
+
+var win          = Y.config.win,
+    localStorage = win.localStorage,
+
+    bdNode = Y.one('#bd'),
+
+    pjax,
+    defaultRoute,
+
+    classTabView,
+    selectedTab;
+
+// Kill pjax functionality unless serving over HTTP.
+if (!Y.getLocation().protocol.match(/^https?\:/)) {
+    Y.Router.html5 = false;
+}
+
+// Create the default route with middleware which enables syntax highlighting
+// on the loaded content.
+defaultRoute = Y.Pjax.defaultRoute.concat(function (req, res, next) {
+    prettyPrint();
+    bdNode.removeClass('loading');
+
+    next();
+});
+
+pjax = new Y.Pjax({
+    container      : '#docs-main',
+    contentSelector: '#docs-main > .content',
+    linkSelector   : '#bd a',
+    titleSelector  : '#xhr-title',
+
+    navigateOnHash: true,
+    root          : '/',
+    routes        : [
+        // -- / ----------------------------------------------------------------
+        {
+            path     : '/(index.html)?',
+            callbacks: defaultRoute
+        },
+
+        // -- /elements/* -------------------------------------------------------
+        {
+            path     : '/elements/:element.html*',
+            callbacks: defaultRoute
+        },
+
+        // -- /classes/* -------------------------------------------------------
+        {
+            path     : '/classes/:class.html*',
+            callbacks: [defaultRoute, 'handleClasses']
+        },
+
+        // -- /files/* ---------------------------------------------------------
+        {
+            path     : '/files/*file',
+            callbacks: [defaultRoute, 'handleFiles']
+        },
+
+        // -- /modules/* -------------------------------------------------------
+        {
+            path     : '/modules/:module.html*',
+            callbacks: defaultRoute
+        }
+    ]
+});
+
+// -- Utility Functions --------------------------------------------------------
+
+pjax.checkVisibility = function (tab) {
+    tab || (tab = selectedTab);
+
+    if (!tab) { return; }
+
+    var panelNode = tab.get('panelNode'),
+        visibleItems;
+
+    // If no items are visible in the tab panel due to the current visibility
+    // settings, display a message to that effect.
+    visibleItems = panelNode.all('.item,.index-item').some(function (itemNode) {
+        if (itemNode.getComputedStyle('display') !== 'none') {
+            return true;
+        }
+    });
+
+    panelNode.all('.no-visible-items').remove();
+
+    if (!visibleItems) {
+        if (Y.one('#index .index-item')) {
+            panelNode.append(
+                '<div class="no-visible-items">' +
+                    '<p>' +
+                    'Some items are not shown due to the current visibility ' +
+                    'settings. Use the checkboxes at the upper right of this ' +
+                    'page to change the visibility settings.' +
+                    '</p>' +
+                '</div>'
+            );
+        } else {
+            panelNode.append(
+                '<div class="no-visible-items">' +
+                    '<p>' +
+                    'This class doesn\'t provide any methods, properties, ' +
+                    'attributes, or events.' +
+                    '</p>' +
+                '</div>'
+            );
+        }
+    }
+
+    // Hide index sections without any visible items.
+    Y.all('.index-section').each(function (section) {
+        var items        = 0,
+            visibleItems = 0;
+
+        section.all('.index-item').each(function (itemNode) {
+            items += 1;
+
+            if (itemNode.getComputedStyle('display') !== 'none') {
+                visibleItems += 1;
+            }
+        });
+
+        section.toggleClass('hidden', !visibleItems);
+        section.toggleClass('no-columns', visibleItems < 4);
+    });
+};
+
+pjax.initClassTabView = function () {
+    if (!Y.all('#classdocs .api-class-tab').size()) {
+        return;
+    }
+
+    if (classTabView) {
+        classTabView.destroy();
+        selectedTab = null;
+    }
+
+    classTabView = new Y.TabView({
+        srcNode: '#classdocs',
+
+        on: {
+            selectionChange: pjax.onTabSelectionChange
+        }
+    });
+
+    pjax.updateTabState();
+    classTabView.render();
+};
+
+pjax.initLineNumbers = function () {
+    var hash      = win.location.hash.substring(1),
+        container = pjax.get('container'),
+        hasLines, node;
+
+    // Add ids for each line number in the file source view.
+    container.all('.linenums>li').each(function (lineNode, index) {
+        lineNode.set('id', 'l' + (index + 1));
+        lineNode.addClass('file-line');
+        hasLines = true;
+    });
+
+    // Scroll to the desired line.
+    if (hasLines && /^l\d+$/.test(hash)) {
+        if ((node = container.getById(hash))) {
+            win.scroll(0, node.getY());
+        }
+    }
+};
+
+pjax.initRoot = function () {
+    var terminators = /^(?:classes|files|elements|modules)$/,
+        parts       = pjax._getPathRoot().split('/'),
+        root        = [],
+        i, len, part;
+
+    for (i = 0, len = parts.length; i < len; i += 1) {
+        part = parts[i];
+
+        if (part.match(terminators)) {
+            // Makes sure the path will end with a "/".
+            root.push('');
+            break;
+        }
+
+        root.push(part);
+    }
+
+    pjax.set('root', root.join('/'));
+};
+
+pjax.updateTabState = function (src) {
+    var hash = win.location.hash.substring(1),
+        defaultTab, node, tab, tabPanel;
+
+    function scrollToNode() {
+        if (node.hasClass('protected')) {
+            Y.one('#api-show-protected').set('checked', true);
+            pjax.updateVisibility();
+        }
+
+        if (node.hasClass('private')) {
+            Y.one('#api-show-private').set('checked', true);
+            pjax.updateVisibility();
+        }
+
+        setTimeout(function () {
+            // For some reason, unless we re-get the node instance here,
+            // getY() always returns 0.
+            var node = Y.one('#classdocs').getById(hash);
+            win.scrollTo(0, node.getY() - 70);
+        }, 1);
+    }
+
+    if (!classTabView) {
+        return;
+    }
+
+    if (src === 'hashchange' && !hash) {
+        defaultTab = 'index';
+    } else {
+        if (localStorage) {
+            defaultTab = localStorage.getItem('tab_' + pjax.getPath()) ||
+                'index';
+        } else {
+            defaultTab = 'index';
+        }
+    }
+
+    if (hash && (node = Y.one('#classdocs').getById(hash))) {
+        if ((tabPanel = node.ancestor('.api-class-tabpanel', true))) {
+            if ((tab = Y.one('#classdocs .api-class-tab.' + tabPanel.get('id')))) {
+                if (classTabView.get('rendered')) {
+                    Y.Widget.getByNode(tab).set('selected', 1);
+                } else {
+                    tab.addClass('yui3-tab-selected');
+                }
+            }
+        }
+
+        // Scroll to the desired element if this is a hash URL.
+        if (node) {
+            if (classTabView.get('rendered')) {
+                scrollToNode();
+            } else {
+                classTabView.once('renderedChange', scrollToNode);
+            }
+        }
+    } else {
+        tab = Y.one('#classdocs .api-class-tab.' + defaultTab);
+
+        // When the `defaultTab` node isn't found, `localStorage` is stale.
+        if (!tab && defaultTab !== 'index') {
+            tab = Y.one('#classdocs .api-class-tab.index');
+        }
+
+        if (classTabView.get('rendered')) {
+            Y.Widget.getByNode(tab).set('selected', 1);
+        } else {
+            tab.addClass('yui3-tab-selected');
+        }
+    }
+};
+
+pjax.updateVisibility = function () {
+    var container = pjax.get('container');
+
+    container.toggleClass('hide-inherited',
+            !Y.one('#api-show-inherited').get('checked'));
+
+    container.toggleClass('show-deprecated',
+            Y.one('#api-show-deprecated').get('checked'));
+
+    container.toggleClass('show-protected',
+            Y.one('#api-show-protected').get('checked'));
+
+    container.toggleClass('show-private',
+            Y.one('#api-show-private').get('checked'));
+
+    pjax.checkVisibility();
+};
+
+// -- Route Handlers -----------------------------------------------------------
+
+pjax.handleClasses = function (req, res, next) {
+    var status = res.ioResponse.status;
+
+    // Handles success and local filesystem XHRs.
+    if (res.ioResponse.readyState === 4 && (!status || (status >= 200 && status < 300))) {
+        pjax.initClassTabView();
+    }
+
+    next();
+};
+
+pjax.handleFiles = function (req, res, next) {
+    var status = res.ioResponse.status;
+
+    // Handles success and local filesystem XHRs.
+    if (res.ioResponse.readyState === 4 && (!status || (status >= 200 && status < 300))) {
+        pjax.initLineNumbers();
+    }
+
+    next();
+};
+
+// -- Event Handlers -----------------------------------------------------------
+
+pjax.onNavigate = function (e) {
+    var hash         = e.hash,
+        originTarget = e.originEvent && e.originEvent.target,
+        tab;
+
+    if (hash) {
+        tab = originTarget && originTarget.ancestor('.yui3-tab', true);
+
+        if (hash === win.location.hash) {
+            pjax.updateTabState('hashchange');
+        } else if (!tab) {
+            win.location.hash = hash;
+        }
+
+        e.preventDefault();
+        return;
+    }
+
+    // Only scroll to the top of the page when the URL doesn't have a hash.
+    this.set('scrollToTop', !e.url.match(/#.+$/));
+
+    bdNode.addClass('loading');
+};
+
+pjax.onOptionClick = function (e) {
+    pjax.updateVisibility();
+};
+
+pjax.onTabSelectionChange = function (e) {
+    var tab   = e.newVal,
+        tabId = tab.get('contentBox').getAttribute('href').substring(1);
+
+    selectedTab = tab;
+
+    // If switching from a previous tab (i.e., this is not the default tab),
+    // replace the history entry with a hash URL that will cause this tab to
+    // be selected if the user navigates away and then returns using the back
+    // or forward buttons.
+    if (e.prevVal && localStorage) {
+        localStorage.setItem('tab_' + pjax.getPath(), tabId);
+    }
+
+    pjax.checkVisibility(tab);
+};
+
+// -- Init ---------------------------------------------------------------------
+
+pjax.on('navigate', pjax.onNavigate);
+
+pjax.initRoot();
+pjax.upgrade();
+pjax.initClassTabView();
+pjax.initLineNumbers();
+pjax.updateVisibility();
+
+Y.APIList.rootPath = pjax.get('root');
+
+Y.one('#api-options').delegate('click', pjax.onOptionClick, 'input');
+
+Y.on('hashchange', function (e) {
+    pjax.updateTabState('hashchange');
+}, win);
+
+});

package/docs/assets/js/yui-prettify.js

@@ -0,0 +1,17 @@
+YUI().use('node', function(Y) {
+    var code = Y.all('.prettyprint.linenums');
+    if (code.size()) {
+        code.each(function(c) {
+            var lis = c.all('ol li'),
+                l = 1;
+            lis.each(function(n) {
+                n.prepend('<a name="LINENUM_' + l + '"></a>');
+                l++;
+            });
+        });
+        var h = location.hash;
+        location.hash = '';
+        h = h.replace('LINE_', 'LINENUM_');
+        location.hash = h;
+    }
+});

package/docs/assets/js/yuidoc-bootstrap.js

@@ -0,0 +1,274 @@
+/* global $:true */
+$(function() {
+    'use strict';
+
+    // ************************************************************************* //
+    //  HTML templates
+    // ************************************************************************* //
+
+    // (None)
+
+
+    // ************************************************************************* //
+    //  Functions
+    // ************************************************************************* //
+
+    function setUpOptionsCheckboxes() {
+        if(localStorage.getItem('options')){
+            var optionsArr = JSON.parse(localStorage.options),
+                optionsForm = $('#options-form');
+
+            if(!optionsForm.length) {
+                return;
+            }
+
+            for(var i=0;i<optionsArr.length;i++){
+                var box = optionsForm.find('input:checkbox').eq(i);
+                box.prop('checked', optionsArr[i]);
+                setOptionDisplayState(box);
+            }
+        }
+    }
+
+    function setupActiveSidebarLink() {
+        var pathname = window.location.pathname;
+
+        if(pathname) {
+            var pathArr = pathname.split('/');
+            var path = decodeURIComponent(pathArr.slice(pathArr.length - 2, pathArr.length).join('/')); // modules/My Module.html
+
+            $('#sidebar li > a').each(function(i) {
+                var a = $(this);
+
+                if(a.attr('href').indexOf(path) > -1) {
+                    a.parent('li').addClass('active');
+                }
+            });
+        }
+    }
+
+    function setUpWidgets() {
+        var source = [];
+        var sidebarSearch;
+
+        $('#sidebar .panel-body ol > li > a').each(function(index, elem) {
+            source.push($(elem).text().trim());
+        });
+
+        sidebarSearch = $('#sidebar input[type="search"]');
+        sidebarSearch.autocomplete({
+            source: source,
+            position: { my : "left top", at: "right top" },
+            select : function(event, ui) {
+                $('#sidebar > li a:contains(' + ui.item.label + ')')[0].click();
+            }
+        });
+    }
+
+    function setupHeaderAnchors() {
+        var slugger = new GithubSlugger();
+
+        $('h1, h2, h3, h4, h5, h6', '.module-description, .class-description').each(function() {
+            var $element = $(this);
+            var id = slugger.slug($element.text());
+
+            $element.attr('id', id);
+            $element.addClass('anchorable-toc');
+            $element.prepend('<a class="fa fa-link toc-anchor" href="#' + id + '"></a>');
+        });
+    }
+
+    function setOptionDisplayState(box) {
+        var cssName = $.trim(box.parent('label').text()).toLowerCase();
+        if(box.is(':checked')){
+            $('div.'+cssName).css('display', 'block');
+            $('li.'+cssName).css('display', 'block');
+            $('span.'+cssName).css('display', 'inline');
+        }else{
+            $('.'+cssName).css('display', 'none');
+        }
+    }
+
+    function scrollToAnchor($anchor) {
+        var navbarHeight = $('.navbar-fixed-top').outerHeight(true);
+        $(document).scrollTop( $anchor.offset().top - navbarHeight);
+    }
+
+    $('[data-toggle=tab]').on('click', function (event, extraArgs) {
+        // Why?  If responding to the click of a link or hashchange already, we really
+        //  don't want to change window hash
+        if (extraArgs && extraArgs.ignore === true) {
+            return;
+        }
+        window.location.hash = $(this).attr('href');
+    });
+
+    $('[data-tabid]').on('click', function(event) {
+        var tabToActivate = $(this).attr('data-tabid'),
+        anchor = $(this).attr('data-anchor');
+        event.preventDefault();
+
+        $('[data-toggle=tab][href="'+ tabToActivate + '"]').click();
+        // ...huh?  http://stackoverflow.com/a/9930611
+        // otherwise, can't select an element by ID if the ID has a '.' in it
+        var scrollAnchor = anchor.replace(/\./g, '\\.');
+        scrollToAnchor($(scrollAnchor));
+        window.location.hash = anchor;
+    });
+
+    function moveToWindowHash() {
+        var hash = window.location.hash,
+            tabToActivate = hash,
+            $tabToActivate = false,
+            $scroll = $(hash);
+
+        if (!hash) {
+            return;
+        }
+
+        if (hash.match(/^#method_/)) {
+            tabToActivate = '#tab_methods';
+        }
+        else if (hash.match(/^#property_/)) {
+            tabToActivate = '#tab_properties';
+        }
+        else if (hash.match(/^#event_/)) {
+            tabToActivate = '#tab_events';
+        }
+        else if (hash.match(/^#attr_/)) {
+            tabToActivate = '#tab_attrs';
+        }
+        else if (hash.match(/#l\d+/)) {
+            var lineNumber = /#l(\d+)/.exec(hash)[1];
+            var whichLi = parseInt(lineNumber, 10) - 1; //e.g. line 1 is 0th element
+            $scroll = $('ol.linenums > li').eq(whichLi);
+        }
+
+        $tabToActivate = $('[data-toggle=tab][href="'+ tabToActivate + '"]');
+        if ($tabToActivate.length) {
+            $tabToActivate.trigger('click', { ignore: true });
+        }
+
+        if ($scroll.length && !hash.match(/^#tab_/)) {
+            scrollToAnchor($scroll);
+        }
+    }
+
+    // ************************************************************************* //
+    //  Initializations + Event listeners
+    // ************************************************************************* //
+
+    //
+    // Store last clicked tab in local storage
+    //
+    $('#main-nav li').on('click', function(e) {
+        e.preventDefault();
+        localStorage['main-nav'] = $(this).find('a').attr('href');
+    });
+
+    //
+    // Refresh typeahead source arrays when user changes tabs
+    //
+    $('#main-nav li').on('shown', function(e) {
+        e.preventDefault();
+        setUpWidgets();
+    });
+
+    //
+    // Bind change events for options form checkboxes
+    //
+    $('#options-form input:checkbox').on('change', function(){
+        setOptionDisplayState($(this));
+
+        // Update localstorage
+        var optionsArr = [];
+        $('#options-form input:checkbox').each(function(i,el) {
+            optionsArr.push($(el).is(':checked'));
+        });
+        localStorage.options = JSON.stringify(optionsArr);
+    });
+
+    //
+    // Keyboard shortcut - 's' key
+    // This brings the api search input into focus.
+    //
+    $(window).keyup(function(e) {
+        // Listen for 's' key and focus search input if pressed
+        if(e.keyCode === 83){ // 's'
+            $('#api-tabview-filter input').focus();
+        }
+    });
+
+    //
+    // Keyboard shortcut - 'ctrl+left', 'ctrl+right', 'up', 'down'
+    // These shortcuts offer sidebar navigation via keyboard,
+    // *only* when sidebar or any element within has focus.
+    //
+    var nextIndex;
+    $('#sidebar').keydown(function(e) {
+        var $this = $(this);
+
+        // Determine if the control/command key was pressed
+        if(e.ctrlKey){
+            if(e.keyCode === 37){ // left arrow
+                $('#main-nav li a:first').tab('show');
+            } else if(e.keyCode === 39){ // right arrow
+                $('#main-nav li a:last').tab('show');
+            }
+        } else {
+            if(e.keyCode === 40){ // down arrow
+                if ($('#api-tabview-filter input').is(':focus')) {
+                    // Scenario 1: We're focused on the search input; move down to the first li
+                    $this.find('.tab-content .tab-pane.active li:first a').focus();
+                } else if ($this.find('.tab-content .tab-pane.active li:last a').is(':focus')) {
+                    // Scenario 2: We're focused on the last li; move up to search input
+                    $('#api-tabview-filter input').focus();
+                } else {
+                    // Scenario 3: We're in the list but not on the last element, simply move down
+                    nextIndex = $this
+                    .find('.tab-content .tab-pane.active li')
+                    .find('a:focus')
+                    .parent('li').index() + 1;
+                    $this.find('.tab-content .tab-pane.active li:eq('+nextIndex+') a').focus();
+                }
+                e.preventDefault(); // Stop page from scrolling
+            } else if (e.keyCode === 38){ // up arrow
+                if($('#api-tabview-filter input').is(':focus')) {
+                    // Scenario 1: We're focused on the search input; move down to the last li
+                    $this.find('.tab-content .tab-pane.active li:last a').focus();
+                }else if($this.find('.tab-content .tab-pane.active li:first a').is(':focus')){
+                    // Scenario 2: We're focused on the first li; move up to search input
+                    $('#api-tabview-filter input').focus();
+                }else{
+                    // Scenario 3: We're in the list but not on the first element, simply move up
+                    nextIndex = $this
+                    .find('.tab-content .tab-pane.active li')
+                    .find('a:focus')
+                    .parent('li').index() - 1;
+                    $this.find('.tab-content .tab-pane.active li:eq('+nextIndex+') a').focus();
+                }
+                e.preventDefault(); // Stop page from scrolling
+            }
+        }
+    });
+
+    function setUpHashChange() {
+        $(window).on('hashchange', moveToWindowHash);
+    }
+
+
+    // ************************************************************************* //
+    //  Immediate function calls
+    // ************************************************************************* //
+
+    setupHeaderAnchors();
+    setUpOptionsCheckboxes();
+    setupActiveSidebarLink();
+    setUpWidgets();
+    setUpHashChange();
+
+    if (window.location.hash) {
+        moveToWindowHash();
+    }
+
+});