jsduck 2.0.pre4 → 3.0.pre

data/template/app/controller/Classes.js

@@ -1,301 +0,0 @@
-/**
- * Listeners should be defined here instead of in the view classes
- */
-Ext.define('Docs.controller.Classes', {
-    extend: 'Ext.app.Controller',
-
-    requires: [
-        'Docs.History',
-        'Docs.Syntax',
-        'Docs.view.cls.Overview'
-    ],
-
-    stores: [
-        'Favorites',
-        'Settings'
-    ],
-
-    models: [
-        'Favorite',
-        'Setting'
-    ],
-
-    refs: [
-        {
-            ref: 'viewport',
-            selector: '#viewport'
-        },
-        {
-            ref: 'header',
-            selector: 'classheader'
-        },
-        {
-            ref: 'overview',
-            selector: 'classoverview'
-        },
-        {
-            ref: 'tree',
-            selector: 'classtree'
-        },
-        {
-            ref: 'favoritesGrid',
-            selector: '#favorites-grid'
-        }
-    ],
-
-    activeUrl: null,
-
-    init: function() {
-        this.addEvents(
-            /**
-             * @event showClass
-             * Fired after class shown. Used for analytics event tracking.
-             * @param {String} cls  name of the class.
-             */
-            "showClass",
-            /**
-             * @event showMember
-             * Fired after class member scrolled to view. Used for analytics event tracking.
-             * @param {String} cls  name of the class.
-             * @param {String} anchor  name of the member in form type-name like "method-bind".
-             */
-            "showMember",
-            /**
-             * @event showGuide
-             * Fired after guide shown. Used for analytics event tracking.
-             * @param {String} guide  name of the guide.
-             */
-            "showGuide"
-        );
-
-        Ext.getBody().addListener('click', function(event, el) {
-            this.handleUrlClick(el.href, event);
-        }, this, {
-            preventDefault: true,
-            delegate: '.docClass'
-        });
-
-        this.control({
-            'classtree': {
-                urlclick: function(url, event) {
-                    this.handleUrlClick(url, event, this.getTree());
-                }
-            },
-            'classgrid': {
-                urlclick: function(url, event) {
-                    this.handleUrlClick(url, event, this.getFavoritesGrid());
-                }
-            },
-
-            'indexcontainer': {
-                afterrender: function(cmp) {
-                    cmp.el.addListener('click', function(event, el) {
-                        this.handleUrlClick(el.href, event);
-                    }, this, {
-                        preventDefault: true,
-                        delegate: '.guide'
-                    });
-                }
-            },
-
-            'toolbar': {
-                toggleExpanded: function(expanded) {
-                    Ext.Array.forEach(Ext.query('.side.expandable'), function(el) {
-                        Ext.get(el).parent()[expanded ? "addCls" : "removeCls"]('open');
-                    });
-                }
-            },
-
-            'classoverview': {
-                afterrender: function(cmp) {
-                    // Expand member when clicked
-                    cmp.el.addListener('click', function(cmp, el) {
-                        Ext.get(Ext.get(el).up('.member')).toggleCls('open');
-                    }, this, {
-                        preventDefault: true,
-                        delegate: '.expandable'
-                    });
-
-                    // Do nothing when clicking on not-expandable items
-                    cmp.el.addListener('click', Ext.emptyFn, this, {
-                        preventDefault: true,
-                        delegate: '.not-expandable'
-                    });
-                }
-            }
-        });
-    },
-
-    // We don't want to select the class that was opened in another window,
-    // so restore the previous selection.
-    handleUrlClick: function(url, event, view) {
-        // Remove everything up to #
-        url = url.replace(/.*#/, "");
-
-        if (this.opensNewWindow(event)) {
-            window.open("#"+url);
-            view && view.selectUrl(this.activeUrl ? this.activeUrl : "");
-        }
-        else {
-            if (/^\/api\//.test(url)) {
-                this.loadClass(url);
-            }
-            else {
-                this.loadGuide(url);
-            }
-        }
-    },
-
-    // Code for the middle mouse button
-    MIDDLE: 1,
-
-    // True when middle mouse button pressed or shift/ctrl key pressed
-    // together with mouse button (for Mac)
-    opensNewWindow: function(event) {
-        return event.button === this.MIDDLE || event.shiftKey || event.ctrlKey;
-    },
-
-    /**
-     * Loads main page.
-     *
-     * @param {Boolean} noHistory  true to disable adding entry to browser history
-     */
-    loadIndex: function(noHistory) {
-        this.activeUrl = "";
-        if (!noHistory) {
-            Docs.History.push("");
-        }
-        this.getViewport().setPageTitle("");
-        Ext.getCmp('card-panel').layout.setActiveItem(0);
-    },
-
-    cache: {},
-
-    /**
-     * Loads class.
-     *
-     * @param {String} url  name of the class + optionally name of the method, separated with dash.
-     * @param {Boolean} noHistory  true to disable adding entry to browser history
-     */
-    loadClass: function(url, noHistory) {
-        if (this.activeUrl === url) return;
-        this.activeUrl = url;
-
-        if (!noHistory) {
-            Docs.History.push(url);
-        }
-
-        Ext.getCmp('card-panel').layout.setActiveItem(1);
-
-        // separate class and member name
-        var matches = url.match(/^\/api\/(.*?)(?:-(.*))?$/);
-        var cls = matches[1];
-        var member = matches[2];
-
-        if (this.cache[cls]) {
-            this.showClass(this.cache[cls], member);
-        }
-        else {
-            if (this.getOverview()) {
-                this.getOverview().setLoading(true);
-            }
-
-            Ext.data.JsonP.request({
-                url: this.getBaseUrl() + '/output/' + cls + '.js',
-                callbackName: cls.replace(/\./g, '_'),
-                success: function(json, opts) {
-                    this.cache[cls] = json;
-                    this.showClass(json, member);
-                },
-                failure: function(response, opts) {
-                    this.showFailure("Class <b>"+cls+"</b> was not found.");
-                },
-                scope: this
-            });
-        }
-    },
-
-    showClass: function(cls, anchor) {
-        if (this.currentCls !== cls) {
-            this.getViewport().setPageTitle(cls.name);
-            this.getHeader().load(cls);
-            this.getOverview().load(cls);
-
-            this.getOverview().setLoading(false);
-
-            this.getTree().selectUrl("/api/"+cls.name);
-            this.fireEvent('showClass', cls.name);
-        }
-
-        if (anchor) {
-            this.getOverview().scrollToEl("#" + anchor);
-            this.fireEvent('showMember', cls.name, anchor);
-        } else {
-            this.getOverview().getEl().down('.x-panel-body').scrollTo('top', 0);
-        }
-
-        this.currentCls = cls;
-
-        this.getFavoritesGrid().selectUrl("/api/"+cls.name);
-    },
-
-    /**
-     * Loads guide.
-     *
-     * @param {String} url  URL of the guide
-     * @param {Boolean} noHistory  true to disable adding entry to browser history
-     */
-    loadGuide: function(url, noHistory) {
-        if (this.activeUrl === url) return;
-        this.activeUrl = url;
-
-        noHistory || Docs.History.push(url);
-
-        var name = url.match(/^\/guide\/(.*)$/)[1];
-        Ext.data.JsonP.request({
-            url: this.getBaseUrl() + "/guides/" + name + "/README.js",
-            callbackName: name,
-            success: function(json) {
-                this.getViewport().setPageTitle(json.guide.match(/<h1>(.*)<\/h1>/)[1]);
-                Ext.getCmp("guide").update(json.guide);
-                Ext.getCmp('card-panel').layout.setActiveItem(2);
-                Docs.Syntax.highlight(Ext.get("guide"));
-                this.fireEvent('showGuide', name);
-                this.getTree().selectUrl(url);
-                this.getFavoritesGrid().selectUrl(url);
-            },
-            failure: function(response, opts) {
-                this.showFailure("Guide <b>"+name+"</b> was not found.");
-            },
-            scope: this
-        });
-    },
-
-    /**
-     * Displays page with 404 error message.
-     * @param {String} msg
-     * @private
-     */
-    showFailure: function(msg) {
-        this.getOverview().setLoading(false);
-        var tpl = new Ext.XTemplate(
-            "<h1>Oops...</h1>",
-            "<p>{msg}</p>",
-            "<p>Maybe it was renamed to something else? Or maybe it has passed away permanently to the 404 land? ",
-            "This would be sad. Hopefully it's just a bug in our side. ",
-            "Report it to <a href='http://www.sencha.com/forum/showthread.php?135036'>Sencha Forum</a> if you feel so.</p>",
-            "<p>Sorry for all this :(</p>"
-        );
-        Ext.getCmp("failure").update(tpl.apply({msg: msg}));
-        Ext.getCmp('card-panel').layout.setActiveItem("failure");
-    },
-
-    /**
-     * Returns base URL used for making AJAX requests.
-     * @return {String} URL
-     */
-    getBaseUrl: function() {
-        return document.location.href.replace(/#.*/, "").replace(/index.html/, "");
-    }
-
-});

data/template/app/controller/Search.js

@@ -1,189 +0,0 @@
-/**
- * Controller for search.
- */
-Ext.define('Docs.controller.Search', {
-    extend: 'Ext.app.Controller',
-
-    views: [
-        'search.Dropdown'
-    ],
-
-    stores: ['Search'],
-
-    refs: [
-        {
-            ref: 'field',
-            selector: '#search-field'
-        }
-    ],
-
-    // Currentl page in search results and nr of items on one page
-    pageIndex: 0,
-    pageSize: 10,
-
-    init: function() {
-        this.control({
-            '#search-dropdown': {
-                itemclick: function(dropdown, record) {
-                    this.loadRecord(record);
-                },
-                changePage: function(dropdown, delta) {
-                    // don't hide dropdown
-                    clearTimeout(this.hideTimeout);
-                    this.getField().focus();
-
-                    // increment page number and update search results display
-                    this.pageIndex += delta;
-                    this.search(this.getField().getValue());
-                }
-            },
-            '#search-field': {
-                keyup: function(el, ev) {
-                    var dropdown = this.getDropdown();
-
-                    el.setHideTrigger(el.getValue().length === 0);
-
-                    if (ev.keyCode === Ext.EventObject.ESC || !el.value) {
-                        dropdown.hide();
-                        el.setValue("");
-                        return;
-                    }
-                    else {
-                        dropdown.show();
-                    }
-
-                    var selModel = dropdown.getSelectionModel();
-                    var record = selModel.getLastSelected();
-                    var curIndex = dropdown.store.indexOf(record);
-                    var lastIndex = dropdown.store.getCount() - 1;
-
-                    if (ev.keyCode === Ext.EventObject.UP) {
-                        if (curIndex === undefined) {
-                            selModel.select(0);
-                        } else {
-                            selModel.select(curIndex === 0 ? lastIndex : (curIndex - 1));
-                        }
-                    }
-                    else if (ev.keyCode === Ext.EventObject.DOWN) {
-                        if (curIndex === undefined) {
-                            selModel.select(0);
-                        } else {
-                            selModel.select(curIndex === lastIndex ? 0 : curIndex + 1);
-                        }
-                    }
-                    else if (ev.keyCode === Ext.EventObject.ENTER) {
-                        ev.preventDefault();
-                        record && this.loadRecord(record);
-                    }
-                    else {
-                        // A new search - reset paging back to first page
-                        this.pageIndex = 0;
-                        // Wait a bit before actually performing the search.
-                        // When user is typing fast, the value of el.value
-                        // might not right away be the final value.  For example
-                        // user might type "tre" but we will get three keyup events
-                        // where el.value === "t".
-                        clearTimeout(this.searchTimeout);
-                        this.searchTimeout = Ext.Function.defer(function() {
-                            this.search(el.value);
-                        }, 50, this);
-                    }
-                },
-                focus: function(el) {
-                    if (el.value && this.getDropdown().store.getCount() > 0) {
-                        this.getDropdown().show();
-                    }
-                },
-                blur: function() {
-                    // Don't hide the dropdown right away, otherwise
-                    // we don't receive the itemclick event when focus
-                    // was lost because we clicked on dropdown item.
-                    // Not really a good solution, but I can't
-                    // currently think of anything better.  Behaves
-                    // badly when you make a long mouse press on
-                    // dropdown item.
-                    var dropdown = this.getDropdown();
-                    this.hideTimeout = Ext.Function.defer(dropdown.hide, 500, dropdown);
-                }
-            }
-        });
-    },
-
-    getDropdown: function() {
-        return this.dropdown || (this.dropdown = Ext.getCmp('search-dropdown'));
-    },
-
-    // loads class/method corrseponding to the record
-    loadRecord: function(record) {
-        var name = record.get("cls");
-        if (record.get("type") !== 'cls') {
-            name += '-' + record.get("type") + '-' + record.get("member");
-        }
-        Docs.App.getController('Classes').loadClass("/api/"+name);
-        this.getDropdown().hide();
-    },
-
-    search: function(term) {
-        // perform search and load results to store
-        var results = this.filterMembers(term);
-
-        // Don't allow paging before first or after the last page.
-        if (this.pageIndex < 0) {
-            this.pageIndex = 0;
-        }
-        else if (this.pageIndex > Math.floor(results.length / this.pageSize)) {
-            this.pageIndex = Math.floor(results.length / this.pageSize);
-        }
-        var start = this.pageIndex * this.pageSize;
-        var end = start + this.pageSize;
-
-        this.getDropdown().setTotal(results.length);
-        this.getDropdown().setStart(start);
-        this.getDropdown().getStore().loadData(results.slice(start, end));
-        // position dropdown below search box
-        this.getDropdown().alignTo('search-field', 'bl', [-23, 2]);
-        // hide dropdown when nothing found
-        if (results.length === 0) {
-            this.getDropdown().hide();
-        }
-        else {
-            // auto-select first result
-            this.getDropdown().getSelectionModel().select(0);
-        }
-    },
-
-    filterMembers: function(text) {
-        var results = [[], [], [], [], [], [], [], []];
-        var xFull=0, clsFull=1, mFull=2, xBeg=3, clsBeg=4, mBeg=5, clsMid=6, mMid=7;
-        var hasDot = /\./.test(text);
-        var safeText = Ext.escapeRe(text);
-        var reFull = new RegExp("^" + safeText + "$", "i");
-        var reBeg = new RegExp("^" + safeText, "i");
-        var reMid = new RegExp(safeText, "i");
-
-        Ext.Array.forEach(Docs.searchData.data, function(r) {
-            // when search text has "." in it, search from the full name (e.g. "Ext.Component.focus")
-            // Otherwise search from just the member name (e.g. "focus" or "Component")
-            var name = hasDot ? r.cls + (r.type === "cls" ? "" : "." + r.member) : r.member;
-
-            if (r.xtypes && Ext.Array.some(r.xtypes, function(x) {return reFull.test(x);})) {
-                results[xFull].push(r);
-            }
-            else if (reFull.test(name)) {
-                results[r.type === "cls" ? clsFull : mFull].push(r);
-            }
-            else if (r.xtypes && Ext.Array.some(r.xtypes, function(x) {return reBeg.test(x);})) {
-                results[xBeg].push(r);
-            }
-            else if (reBeg.test(name)) {
-                results[r.type === "cls" ? clsBeg : mBeg].push(r);
-            }
-            else if (reMid.test(name)) {
-                results[r.type === "cls" ? clsMid : mMid].push(r);
-            }
-        });
-
-        return Ext.Array.flatten(results);
-    }
-
-});

data/template/app/model/Favorite.js

@@ -1,11 +0,0 @@
-/**
- * Favorite classes
- */
-Ext.define('Docs.model.Favorite', {
-    fields: ['id', 'url', 'title', 'cls'],
-    extend: 'Ext.data.Model',
-    proxy: {
-        type: ('localStorage' in window && window['localStorage'] !== null) ? 'localstorage' : 'memory',
-        id: Docs.localStorageDb + '-favorites'
-    }
-});

data/template/app/model/Setting.js

@@ -1,11 +0,0 @@
-/**
- * Key-value pairs of Docs app settings.
- */
-Ext.define('Docs.model.Setting', {
-    fields: ['id', 'key', 'value'],
-    extend: 'Ext.data.Model',
-    proxy: {
-        type: ('localStorage' in window && window['localStorage'] !== null) ? 'localstorage' : 'memory',
-        id: Docs.localStorageDb + '-settings'
-    }
-});

data/template/app/store/Favorites.js

@@ -1,7 +0,0 @@
-/**
- * Favorites Store
- */
-Ext.define('Docs.store.Favorites', {
-    extend: 'Ext.data.Store',
-    model: 'Docs.model.Favorite'
-});

data/template/app/store/Search.js

@@ -1,14 +0,0 @@
-/**
- * Store for keeping search results.
- */
-Ext.define('Docs.store.Search', {
-    extend: 'Ext.data.Store',
-
-    fields: ['cls', 'member', 'type', 'xtypes'],
-    proxy: {
-        type: 'memory',
-        reader: {
-            type: 'json'
-        }
-    }
-});

data/template/app/store/Settings.js

@@ -1,7 +0,0 @@
-/**
- * Store for keeping Docs app settings
- */
-Ext.define('Docs.store.Settings', {
-    extend: 'Ext.data.Store',
-    model: 'Docs.model.Setting'
-});

data/template/app/view/ClassGrid.js

@@ -1,114 +0,0 @@
-/**
- * Gridpanel for showing list of classes.
- */
-Ext.define('Docs.view.ClassGrid', {
-    extend: 'Ext.grid.Panel',
-    alias: 'widget.classgrid',
-    hideHeaders: true,
-    border: false,
-    bodyBorder: false,
-
-    /**
-     * @cfg {Object} icons
-     * Mapping of class names to icon class names.
-     */
-    icons: {},
-
-    /**
-     * @cfg {Boolean} enableClose
-     * Show or hide the close column
-     */
-    enableClose: true,
-
-    initComponent: function() {
-        this.addEvents(
-            /**
-             * @event
-             * Fired when class in grid clicked.
-             * @param {String} url  URL of the page that was selected. For example "/api/Ext.Ajax".
-             * @param {Ext.EventObject} e
-             */
-            "urlclick",
-            /**
-             * @event
-             * Fired when close button in grid clicked.
-             * @param {String} url  URL of the page that was closed. For example "/api/Ext.Ajax".
-             */
-            "closeclick"
-        );
-
-        this.columns = [
-            {
-                width: 18,
-                dataIndex: 'url',
-                renderer: function(url, data) {
-                    data.tdCls = this.icons[url];
-                },
-                scope: this
-            },
-            {
-                dataIndex: 'title',
-                flex: true,
-                renderer: function(title, data, r) {
-                    return Ext.String.format('<a href="#{0}" rel="{0}" class="docClass">{1}</a>', r.get("url"), title);
-                }
-            }
-        ];
-
-        if (this.enableClose) {
-            this.columns = this.columns.concat([
-                {
-                    xtype: 'actioncolumn',
-                    width: 18,
-                    icon: 'resources/images/x12.png',
-                    tooltip: 'Delete',
-                    handler: function(view, rowIndex) {
-                        this.fireEvent("closeclick", this.getStore().getAt(rowIndex).get("url"));
-                    },
-                    scope: this
-                }
-            ]);
-        }
-
-        this.callParent(arguments);
-
-        this.on("itemclick", function(view, record, item, index, event) {
-            // Only fire urlclick when the row background is clicked
-            // (that doesn't contain neither the link nor the close
-            // button).
-            if (!event.getTarget("img") && !event.getTarget("a")) {
-                this.fireEvent("urlclick", record.get("url"), event);
-            }
-        }, this);
-
-        // Initialize selection after rendering
-        this.on("afterrender", function() {
-            this.selectUrl(this.selectedUrl);
-        }, this);
-    },
-
-    /**
-     * Selects page if grid contains such.
-     * Fires no events while selecting.
-     * @param {String} url  page URL.
-     */
-    selectUrl: function(url) {
-        this.selectedUrl = url;
-        // when grid hasn't been rendered yet, trying to select will give us error.
-        if (this.rendered) {
-            var index = this.getStore().findExact('url', url);
-            this.selectIndex(index);
-        }
-    },
-
-    selectIndex: function(index) {
-        if (index > -1) {
-            this.view.focusRow(index);
-            this.getSelectionModel().select(index, false, true);
-        }
-        else {
-            this.getSelectionModel().deselectAll(true);
-        }
-    }
-
-});