<?js
    var params = obj;

    /* sort subparams under their parent params (like opts.classname) */
    var parentParam = null;
    params.forEach(function(param, i) {
        var paramRegExp;

        if (!param) {
            return;
        }

        if (parentParam && parentParam.name && param.name) {
            try {
                paramRegExp = new RegExp('^(?:' + parentParam.name + '(?:\\[\\])*)\\.(.+)$');
            }
            catch (e) {
                // there's probably a typo in the JSDoc comment that resulted in a weird
                // parameter name
                return;
            }

            if ( paramRegExp.test(param.name) ) {
                param.name = RegExp.$1;
                parentParam.subparams = parentParam.subparams || [];
                parentParam.subparams.push(param);
                params[i] = null;
            }
            else {
                parentParam = param;
            }
        }
        else {
            parentParam = param;
        }
    });

    /* determine if we need extra columns, "attributes" and "default" */
    params.hasAttributes = false;
    params.hasDefault = false;
    params.hasName = false;

    params.forEach(function(param) {
        if (!param) { return; }

        if (param.optional || param.nullable || param.variable) {
            params.hasAttributes = true;
        }

        if (param.name) {
            params.hasName = true;
        }

        if (typeof param.defaultvalue !== 'undefined') {
            params.hasDefault = true;
        }

        if (param.subparams) {
            param.subparams.forEach(function(subparam) {
                if (!subparam) { return; }

                if (subparam.optional || subparam.nullable || subparam.variable) {
                    params.hasAttributes = true;
                }
        
                if (subparam.name) {
                    params.hasName = true;
                }
        
                if (typeof subparam.defaultvalue !== 'undefined') {
                    params.hasDefault = true;
                }
            })
        }
    });
?>
<div class="table-container">
    <table class="params table">
        <thead>
        <tr>
            <?js if (params.hasName) {?>
            <th>Name</th>
            <?js } ?>

            <th>Type</th>

            <?js if (params.hasAttributes) {?>
            <th>Attributes</th>
            <?js } ?>

            <?js if (params.hasDefault) {?>
            <th>Default</th>
            <?js } ?>

            <th class="last">Description</th>
        </tr>
        </thead>

        <tbody>
        <?js
            var self = this;
            var level = 0;
            params.forEach(function(param) {
                if (!param) { return; }
                var paramData = {
                    params: params,
                    param: param,
                    level: level
                }
        ?>

            <?js= self.partial('param.tmpl', paramData) ?>

        <?js }); ?>
        </tbody>
    </table>
</div>