{% extends "base.html" %}
{% macro render_tree(nodes) -%}
<ul class="detail-tree">
  {% for node in nodes %}
  {% set kind_title = {'group': 'Named model group', 'choice': 'Exactly one of the following', 'sequence': 'The following, in order', 'all': 'The following, in any order'}.get(node.kind) %}
  <li{% if node.kind != 'element' %} class="tree-structural"{% endif %}>
    <div class="detail-tree-row{% if node.kind != 'element' %} detail-tree-structural-row{% endif %}">
      {% if node.kind != 'element' %}<span class="tree-kind-badge kind-{{ node.kind }}" title="{{ kind_title }}">{{ node.kind }}</span>{% endif %}
      {% if node.name %}{% if node.href %}<a class="tree-name" href="{{ node.href }}"><code>{{ node.qualified_name }}</code></a>{% else %}<code class="tree-name">{{ node.qualified_name }}</code>{% endif %}{% endif %}
      {% if node.source_path %}<a class="source-path" href="{{ node.source_path|source_page_href(node.source_line) }}" title="{{ node.source_path }}{% if node.source_line %}:{{ node.source_line }}{% endif %}">{{ node.source_path.split('/')[-1] }}{% if node.source_line %}:{{ node.source_line }}{% endif %}</a>{% endif %}
      {% if node.source_href %}<a class="source-link" href="{{ node.source_href }}" target="_blank" rel="noopener noreferrer" title="View this declaration in GitHub">Source</a>{% endif %}
      <span class="tree-occurs">{{ node.min_occurs }}..{{ node.max_occurs }}</span>
      {% if node.type_name %}<span class="detail-tree-type">{% if node.type_href %}<a href="{{ node.type_href }}"><code>{{ node.type_name }}</code></a>{% else %}<code>{{ node.type_name }}</code>{% endif %}</span>{% endif %}
      {% if node.abstract %}<span class="abstract-badge" title="Abstract: cannot appear directly in an instance document; a substitution member must be used instead.">abstract</span>{% endif %}
      {% if node.default %}<span class="tree-default" title="Default value">default {{ node.default }}</span>{% endif %}
      {% if node.fixed %}<span class="tree-default" title="Fixed value">fixed {{ node.fixed }}</span>{% endif %}
    </div>
    {% if node.documentation %}<div class="documentation compact-doc detail-tree-doc">{{ node.documentation }}</div>{% endif %}
    {% if node.children %}{{ render_tree(node.children) }}{% endif %}
  </li>
  {% endfor %}
</ul>
{%- endmacro %}
{% block content %}
<article>
  <p class="eyebrow">{{ 'Global element' if item_kind == 'element' else ('Complex type' if item.kind == 'complexType' else 'Simple type') }}{% if item.abstract %} <span class="abstract-badge" title="Abstract: cannot be used directly in an instance document.">abstract</span>{% endif %}</p>
  <h1>{{ item.name }}</h1>
  <p class="qualified-name"><code>{{ item.qualified_name }}</code></p>
  {% if item.source_path %}
  <p class="source-location">Defined in <a href="{{ item.source_path|source_page_href(item.source_line) }}"><code title="{{ item.source_path }}{% if item.source_line %}:{{ item.source_line }}{% endif %}">{{ item.source_path }}{% if item.source_line %}:{{ item.source_line }}{% endif %}</code></a>{% if item.source_href %}<a class="source-link" href="{{ item.source_href }}" target="_blank" rel="noopener noreferrer" title="View this declaration in GitHub">View on GitHub</a>{% endif %}</p>
  {% endif %}
  {% if item.documentation %}<div class="documentation">{{ item.documentation }}</div>{% else %}<p class="muted">No documentation provided.</p>{% endif %}

  {% if item_kind == 'element' and item.type_name %}
  <section class="section-block compact-section">
    <h2>Type</h2>
    <p class="type-reference">{% if item.type_href %}<a href="{{ item.type_href }}"><code>{{ item.type_name }}</code></a>{% else %}<code>{{ item.type_name }}</code>{% endif %}</p>
  </section>
  {% elif item_kind == 'type' and item.base_type_name %}
  <section class="section-block compact-section">
    <h2>Base type</h2>
    <p>{% if item.base_type_href %}<a href="{{ item.base_type_href }}"><code>{{ item.base_type_name }}</code></a>{% else %}<code>{{ item.base_type_name }}</code>{% endif %}</p>
  </section>
  {% endif %}

  {% if item_kind == 'type' and item.restrictions %}
  <section class="section-block compact-section">
    <h2>Restrictions</h2>
    <ul class="restriction-list">
      {% for label, value in item.restrictions %}
      <li><span class="restriction-label">{{ label }}</span><code>{{ value }}</code></li>
      {% endfor %}
    </ul>
  </section>
  {% endif %}

  {% if item_kind == 'type' and item.item_type_name %}
  <section class="section-block compact-section">
    <h2>Item type</h2>
    <p>This is a list type; each value is a whitespace-separated sequence of items of type {% if item.item_type_href %}<a href="{{ item.item_type_href }}"><code>{{ item.item_type_name }}</code></a>{% else %}<code>{{ item.item_type_name }}</code>{% endif %}.</p>
  </section>
  {% endif %}

  {% if item_kind == 'type' and item.member_types %}
  <section class="section-block compact-section">
    <h2>Member types</h2>
    <p class="muted">This is a union type; a value must match one of the following types.</p>
    <ul class="restriction-list">
      {% for member_name, member_href in item.member_types %}
      <li>{% if member_href %}<a href="{{ member_href }}"><code>{{ member_name }}</code></a>{% else %}<code>{{ member_name }}</code>{% endif %}</li>
      {% endfor %}
    </ul>
  </section>
  {% endif %}

  {% if item_kind == 'element' and (item.substitution_group_name or item.referenced_by_elements) %}
  <section class="section-block compact-section related-links">
    <h2>Related elements</h2>
    {% if item.substitution_ancestors %}
    <p>Substitution group chain: {% for ancestor in item.substitution_ancestors %}<a href="{{ ancestor.href }}"><code>{{ ancestor.name }}</code></a>{% if ancestor.abstract %} <span class="abstract-badge" title="Abstract: cannot be used directly in an instance document.">abstract</span>{% endif %}{% if not loop.last %} → {% endif %}{% endfor %}</p>
    {% elif item.substitution_group_name %}
    <p>Substitution group: {% if item.substitution_group_href %}<a href="{{ item.substitution_group_href }}"><code>{{ item.substitution_group_name }}</code></a>{% else %}<code>{{ item.substitution_group_name }}</code>{% endif %}</p>
    {% endif %}
    {% if item.referenced_by_elements %}<p>Referenced by: {% for related in item.referenced_by_elements %}<a href="{{ related.href }}"><code>{{ related.name }}</code></a>{% if not loop.last %}, {% endif %}{% endfor %}</p>{% endif %}
  </section>
  {% endif %}

  {% if item_kind == 'element' and item.substitution_members %}
  <section class="section-block compact-section allowed-values used-by-elements">
    <h2>Direct substitution members</h2>
    <div class="enumeration-values">
      {% for related in item.substitution_members %}
      <div class="enumeration-value used-element"><a href="{{ related.href }}"><code>{{ related.name }}</code></a>{% if related.abstract %} <span class="abstract-badge" title="Abstract: cannot be used directly in an instance document.">abstract</span>{% endif %}</div>
      {% endfor %}
    </div>
  </section>
  {% endif %}

  {% if item_kind == 'element' and item.concrete_substitution_members %}
  <section class="section-block compact-section allowed-values used-by-elements">
    <h2>Concrete substitution alternatives</h2>
    <p class="muted">Elements that can actually appear in an instance document wherever this element's substitution group is accepted, gathered from the full substitution-group chain below it.</p>
    <div class="enumeration-values">
      {% for related in item.concrete_substitution_members %}
      <div class="enumeration-value used-element"><a href="{{ related.href }}"><code>{{ related.name }}</code></a></div>
      {% endfor %}
    </div>
  </section>
  {% endif %}

  {% if item_kind == 'type' and item.enumeration_values %}
  <section class="section-block compact-section allowed-values">
    <h2>Allowed values</h2>
    <div class="enumeration-values">
      {% for value in item.enumeration_values %}
      <div class="enumeration-value">
        <code>{{ value }}</code>
        {% if item.enumeration_source_paths[loop.index0] %}<a class="source-path" href="{{ item.enumeration_source_paths[loop.index0]|source_page_href(item.enumeration_source_lines[loop.index0]) }}" title="{{ item.enumeration_source_paths[loop.index0] }}{% if item.enumeration_source_lines[loop.index0] %}:{{ item.enumeration_source_lines[loop.index0] }}{% endif %}">{{ item.enumeration_source_paths[loop.index0].split('/')[-1] }}{% if item.enumeration_source_lines[loop.index0] %}:{{ item.enumeration_source_lines[loop.index0] }}{% endif %}</a>{% endif %}
        {% if item.enumeration_source_hrefs[loop.index0] %}<a class="source-link" href="{{ item.enumeration_source_hrefs[loop.index0] }}" target="_blank" rel="noopener noreferrer" title="View this value in GitHub">Source</a>{% endif %}
        {% if item.enumeration_docs[loop.index0] %}
        <div class="documentation compact-doc">{{ item.enumeration_docs[loop.index0] }}</div>
        {% endif %}
      </div>
      {% endfor %}
    </div>
  </section>
  {% endif %}

  {% if item_kind == 'type' and item.used_by_elements %}
  <section class="section-block compact-section allowed-values used-by-elements">
    <h2>Used by elements</h2>
    <div class="enumeration-values">
      {% for related in item.used_by_elements %}
      <div class="enumeration-value used-element"><a href="{{ related.href }}"><code>{{ related.name }}</code></a>{% if related.abstract %} <span class="abstract-badge" title="Abstract: cannot be used directly in an instance document.">abstract</span>{% endif %}</div>
      {% endfor %}
    </div>
  </section>
  {% endif %}

  {% if item_kind == 'type' and item.derived_types %}
  <section class="section-block compact-section allowed-values used-by-elements">
    <h2>Derived types</h2>
    <div class="enumeration-values">
      {% for related in item.derived_types %}
      <div class="enumeration-value used-element"><a href="{{ related.href }}"><code>{{ related.name }}</code></a>{% if related.abstract %} <span class="abstract-badge" title="Abstract: cannot be used directly in an instance document.">abstract</span>{% endif %}</div>
      {% endfor %}
    </div>
  </section>
  {% endif %}

  {% if item_kind == 'element' and item.identity_constraints %}
  <section class="section-block">
    <div class="section-heading"><div><p class="eyebrow">Referential integrity</p><h2>Identity constraints</h2></div><span class="count-pill">{{ item.identity_constraints|length }}</span></div>
    <div class="table-wrap"><table><thead><tr><th>Constraint</th><th>Selector</th><th>Fields</th><th>Refers to</th></tr></thead><tbody>
      {% set kind_titles = {'key': 'Key: the selected field(s) must be unique and present for every node matched by the selector.', 'keyref': 'Key reference: the selected field(s) must match a key or unique value declared elsewhere.', 'unique': 'Uniqueness: the selected field(s) must be unique (may be absent) for every node matched by the selector.'} %}
      {% for constraint in item.identity_constraints %}
      <tr id="{{ constraint.anchor }}" class="identity-constraint-row">
        <td>
          <div class="identity-constraint-name">
            <span class="tree-kind-badge kind-{{ constraint.kind }}" title="{{ kind_titles[constraint.kind] }}">{{ constraint.kind }}</span>
            <code>{{ constraint.name }}</code>
          </div>
          {% if constraint.source_path %}<a class="source-path" href="{{ constraint.source_path|source_page_href(constraint.source_line) }}" title="{{ constraint.source_path }}{% if constraint.source_line %}:{{ constraint.source_line }}{% endif %}">{{ constraint.source_path.split('/')[-1] }}{% if constraint.source_line %}:{{ constraint.source_line }}{% endif %}</a>{% endif %}
          {% if constraint.source_href %} <a class="source-link" href="{{ constraint.source_href }}" target="_blank" rel="noopener noreferrer" title="View this constraint in GitHub">Source</a>{% endif %}
          {% if constraint.documentation %}<div class="documentation compact-doc">{{ constraint.documentation }}</div>{% endif %}
        </td>
        <td><code>{{ constraint.selector }}</code></td>
        <td class="identity-constraint-fields">{% for field_path in constraint.fields %}<code>{{ field_path }}</code>{% if not loop.last %}<br>{% endif %}{% endfor %}</td>
        <td>{% if constraint.refer_name %}{% if constraint.refer_href %}<a href="{{ constraint.refer_href }}"><code>{{ constraint.refer_name }}</code></a>{% else %}<code>{{ constraint.refer_name }}</code>{% endif %}{% else %}<span class="muted">—</span>{% endif %}</td>
      </tr>
      {% endfor %}
    </tbody></table></div>
  </section>
  {% endif %}

  {% if item.structure %}
  <section class="section-block">
    <div class="section-heading"><div><p class="eyebrow">Content model</p><h2>{{ 'Element structure' if item_kind == 'element' else 'Type structure' }}</h2></div><span class="count-pill">{{ item.structure|length }} top-level</span></div>
    <div class="schema-tree detail-schema-tree">{{ render_tree(item.structure) }}</div>
  </section>
  {% endif %}


  {% if item.attributes %}
  <section class="section-block">
    <div class="section-heading"><div><p class="eyebrow">Properties</p><h2>Attributes</h2></div><span class="count-pill">{{ item.attributes|length }}</span></div>
    <div class="table-wrap"><table><thead><tr><th>Attribute</th><th>Type</th><th>Use</th><th>Documentation</th></tr></thead><tbody>
      {% for attribute in item.attributes %}
      <tr><td><code>{{ attribute.name }}</code>{% if attribute.source_path %} <a class="source-path" href="{{ attribute.source_path|source_page_href(attribute.source_line) }}" title="{{ attribute.source_path }}{% if attribute.source_line %}:{{ attribute.source_line }}{% endif %}">{{ attribute.source_path.split('/')[-1] }}{% if attribute.source_line %}:{{ attribute.source_line }}{% endif %}</a>{% endif %}{% if attribute.source_href %} <a class="source-link" href="{{ attribute.source_href }}" target="_blank" rel="noopener noreferrer" title="View this attribute in GitHub">Source</a>{% endif %}<div class="sub-label">{{ attribute.qualified_name }}</div></td>
        <td>{% if attribute.type_href %}<a href="{{ attribute.type_href }}"><code>{{ attribute.type_name }}</code></a>{% elif attribute.type_name %}<code>{{ attribute.type_name }}</code>{% else %}<span class="muted">—</span>{% endif %}</td>
        <td><span class="use-badge {{ 'required' if attribute.use == 'required' else '' }}">{{ attribute.use }}</span>{% if attribute.default %}<div class="sub-label">default: <code>{{ attribute.default }}</code></div>{% endif %}{% if attribute.fixed %}<div class="sub-label">fixed: <code>{{ attribute.fixed }}</code></div>{% endif %}</td>
        <td>{% if attribute.documentation %}<div class="documentation compact-doc">{{ attribute.documentation }}</div>{% else %}<span class="muted">—</span>{% endif %}</td></tr>
      {% endfor %}
    </tbody></table></div>
  </section>
  {% endif %}

  {% if not item.structure and not item.children and not item.attributes and not item.enumeration_values and not item.restrictions and not item.item_type_name and not item.member_types and not item.identity_constraints %}
  <section class="empty-state detail-empty">No child elements or attributes are defined for this {{ item_kind }}.</section>
  {% endif %}
</article>
{% endblock %}