{#
Tables
#}
{% macro code_table(headings, rows, title=None) - %}
{% if title %}
    <h2>{{ title }}</h2>
{% endif %}
<table class="table table-striped table-bordered reference-table">
    <thead>
    <tr>
        {% for heading in headings %}
            <td>{{ heading|markdown|safe }}</td>
        {% endfor %}
    </tr>
    </thead>

    <tbody>
    {% for row in rows %}
        <tr>
            {% for col in row %}
                <td>{{ col|markdown|safe }}</td>
            {% endfor %}
        </tr>
    {% endfor %}
    </tbody>
</table>
{% - endmacro %}

{% macro options_table(rows, title=None) - %}
{{ code_table(("Option Name", "Type", "Default", "Description"), rows, title) }}
{% - endmacro %}
{% macro events_table(rows, title=None) - %}
{{ code_table(("Event", "Parameters", "Description"), rows, title) }}
{% - endmacro %}
{% macro methods_table(rows, title=None) - %}
{{ code_table(("Name", "Parameters", "Return", "Description"), rows, title) }}
{% - endmacro %}
{#
{% macro classes_table(rows, title=None) - %}
{{ code_table(("Property Name", "Default CSS", "Description"), rows, title) }}
{% - endmacro %}
#}

{#
Labels
#}
{% macro code_label(type, val=None) %}
    {% set type_label_mapping = {
    "object": {
    "link": "",
    },
    "array": {
    "link": "",
    },
    "function": {
    "link": ""
    },
    "integer": {
    "link": ""
    },
    "string": {
    "link": ""
    },
    "boolean": {
    "link": ""
    },
    "htmlelement": {
    "link": ""
    },
    "qq.promise": {
    "link": ""
    },
    "xmlhttprequest": {
    "link": ""
    },
    "undefined": {
    "link": ""
    },
    "null": {
    "link": ""
    },
    "other": {
    "link": ""
    }
    } %}
    {% if "," in type %}
        {% set label_types = type.split(",") %}
        {% if val == None %}
            {% for label_type in label_types %}
                {% if loop.first %}
                    {{ code_label(label_type.strip(" "), val)}}
                    or
                {% else %}
                    {{ code_label(label_type)}}
                {% endif %}
            {% endfor %}
        {% else %}
            {{ code_label(label_types[0], val)}}
        {% endif %}
    {% elif " or " in type %}
        {% set label_types = type.split(" or ") %}
        {% if val == None %}
            {% for label_type in label_types %}
                {% if loop.first %}
                    {{ code_label(label_type.strip(" "), val)}}
                    or
                {% else %}
                    {{ code_label(label_type)}}
                {% endif %}
            {% endfor %}
        {% else %}
            {{ code_label(label_types[0], val)}}
        {% endif %}
    {% else %}
        {% set label_type = type_label_mapping.get(type.lower(), 'other') %}
        {% set text = type if val == None else val %}
        <span class="label label-{{ type.lower()}}">{{ text|safe }}</span>
    {% endif %}
{% endmacro %}

{#
api_param

This macro will generate the correct HTML structure to document an API
method as found on api/methods.jmd and api/methods-ui.jmd
#}
{#
api_param

This macro will generate the correct HTML structure for a parameter in
the api_methods documentation.
#}
{% macro api_param(name, type, description) - %}
<span class="method-param row-fluid">
    <dd class="method-param-type span2">{{ code_label(type)}}</dd>
    <dt class="method-param-name span2"><em>{{ name }}</em></dt>
    <dd class="method-param-description span8">{% markdown %}{{ description }}{% endmarkdown %}</dd>
</span>
<hr/>
{% - endmacro %}

{#
api_return

This macro will generate the correct HTML structure for a return in
the api_methods documentation.
#}
{% macro api_return(type, description) - %}
<span class="method-return row-fluid">
    <dt class="span2"><b>Returns:</b></dt>
    <dd class="method-return-type span2">{{ code_label(type)}}</dd>
    <dd class="method-return-description span8">{{ description }}</dd>
</span>
<hr/>
{% - endmacro %}

{% macro api_method_or_event(type, header, title, description, params=None, returns=None) - %}
<span class="{{ type }} row-fluid">
    <h4 id="{{ header }}"><a style="color: #f87436;" href="#{{ header }}">{{ title }}</a></h4>
    <span class="{{ type }}-description">
        {% markdown %}{{ description }}{% endmarkdown %}
    </span>
    {% if params %}
        <h5>Parameters: </h5>
        <dl class="{{ type }}-params row-fluid">
        {% for param in params %}
            {% if param is mapping %}
                {{ api_param(param.name, param.type, param.description) }}
            {% else %}
                {% for sub_params in param %}
                    {{ api_param(sub_params.name, sub_params.type, sub_params.description) }}
                    {% if not loop.last %}
                        <p> or ... </p>
                    {% endif %}
                {% endfor %}
            {% endif %}
        {% endfor %}
    {% endif %}
    </dl>
    {% if returns %}
        <dl class="{{ type }}-return row-fluid">
            {% for return in returns %}
                {{ api_return(return.type, return.description)}}
            {% endfor %}
        </dl>
    {% endif %}
    {% if returns is undefined and params is undefined %}
        <hr/>
    {% endif %}
</span>
{% - endmacro %}

{% macro api_option(header, title, description, type, default_value) - %}
<div class="option row-fluid">
    <h4 id="{{ header }}"><a style="color: #f87436" href="#{{ header }}">{{ title }}</a></h4>
    <span class="option-description row-fluid">
        {% markdown %}{{ description|safe }}{% endmarkdown %}
    </span>
    <dl>
        <div class="row-fluid">
            <dt class="span2"><b>Type:</b></dt>
            <dd class="span10 option-type">{{ code_label(type)}}</dd>
        </div>

        <div class="row-fluid">
            <dt class="span2"><b>Default Value:</b></dt>
            <dd class="span10 option-default-value">{{ code_label(type, default_value)}}</dd>
        </div>
    </dl>
    <hr>
</div>
{% - endmacro %}

{% macro api_parent_option(header, title, description, sub_options) - %}
    <div class="option-parent row-fluid">
        <h3 id="{{ header }}"><a style="color: #00ABC7;" href="#{{ header }}">{{ title }}</a></h3>
    <span class="option-description row-fluid">
        {% markdown %}{{ description|safe }}{% endmarkdown %}
    </span>
        {% for sub_option in sub_options %}
            {{ api_option(*sub_option) }}
        {% endfor %}
    </div>
{% endmacro - %}

{% macro api_event(header, title, description, params, returns) %}
    {{ api_method_or_event('event', header, title, description, params, returns) }}
{% endmacro %}

{% macro api_method(header, title, description, params, returns) %}
    {{ api_method_or_event('method', header, title, description, params, returns) }}
{% endmacro %}

{% macro api_links(options=None, methods=None, events=None) - %}
    {% if options is not none or methods is not none or events is not none %}
        <div class="sidebar">
            {% if options is iterable and options is not none %}
                <div class="accordion-group">
                    <div class="accordion-heading">
                        <a href="../api/options.html"><b>Options</b></a>
                    </div>
                    <div class="accordion-body">
                        <div class="accordon-inner">
                            <ul class="nav nav-list">
                                {% for option in options %}
                                    {% if "-" in option %}
                                        {% set option_type = option.split("-")[1] %}
                                        {% set option = option.split("-")[0] %}
                                        {% if option_type == "ui" %}
                                            <li><a href="../api/options-ui.html#{{ option }}">{{ option }} (UI)</a></li>
                                        {% elif option_type == "s3" %}
                                            <li><a href="../api/options-s3.html#{{ option }}">{{ option }} (S3)</a></li>
                                        {% endif %}
                                    {% else %}
                                        <li><a href="../api/options.html#{{ option }}">{{ option }}</a></li>
                                    {% endif %}
                                {% endfor %}
                            </ul>
                        </div>
                    </div>
                </div>
            {% endif %}

            {% if methods is iterable and methods is not none %}
                <div class="accordion-group">
                    <div class="accordion-heading">
                        <a href="../api/methods.html"><b>Methods</b></a>
                    </div>
                    <div class="accordion-body">
                        <div class="accordon-inner">
                            <ul class="nav nav-list">
                                {% for method in methods %}
                                    {% if "-" in method %}
                                        {% set method_type = method.split("-")[1] %}
                                        {% set method = method.split("-")[0] %}
                                        {% if method_type == "ui" %}
                                            <li><a href="../api/methods.html#{{ method }}">{{ method }} (UI)</a></li>
                                        {% elif method_type == "s3" %}
                                            <li><a href="../api/methods-s3.html#{{ method }}">{{ method }} (S3)</a></li>
                                        {% endif %}
                                    {% else %}
                                        <li><a href="../api/methods.html#{{ method }}">{{ method }}</a></li>
                                    {% endif %}
                                {% endfor %}
                            </ul>
                        </div>
                    </div>
                </div>
            {% endif %}

            {% if events is iterable and events is not none %}
                <div class="accordion-group">
                    <div class="accordion-heading">
                        <a href="../api/events.html"><b>Events</b></a>
                    </div>
                    <div class="accordion-body">
                        <div class="accordon-inner">
                            <ul class="nav nav-list">
                                {% for event in events %}
                                    {% if "-" in event %}
                                        {% set event_type = event.split("-")[1] %}
                                        {% set event = event.split("-")[0] %}
                                        {% if event_type == "ui" %}
                                            <li><a href="../api/events-ui.html#{{ event }}">{{ event }} (UI)</a></li>
                                        {% elif event_type == "s3" %}
                                            <li><a href="../api/events-s3.html#{{ event }}">{{ event }} (S3)</a></li>
                                        {% endif %}
                                    {% else %}
                                        <li><a href="../api/events.html#{{ event }}">{{ event }}</a></li>
                                    {% endif %}
                                {% endfor %}
                            </ul>
                        </div>
                    </div>
                </div>
            {% endif %}

        </div>
    {% endif %}
{% endmacro - %}