{% extends "base.html" %}
{# Where a row's declaration is in the schemas: an icon at the row's right, linking to the source,
   with the file and line in a popup. #}
{% macro source_icon(path, line) -%}
{% if path %}{% set location = path ~ (':' ~ line if line else '') %}<a class="source-icon" href="{{ path|source_page_href(line) }}" aria-label="Defined in {{ location }}" data-location="{{ location }}"><svg viewBox="0 0 16 16" width="15" height="15" aria-hidden="true" focusable="false"><path d="M5.5 4 1.5 8l4 4M10.5 4l4 4-4 4" fill="none" stroke="currentColor" stroke-width="1.6" stroke-linecap="round" stroke-linejoin="round"/></svg></a>{% endif %}
{%- endmacro %}
{% macro render_tree(nodes) -%}
<ul class="detail-tree">
  {% for node in nodes %}
  {% if node.kind == 'inherited' %}
  <li class="tree-inherited">
    <details class="inherited-block">
      <summary class="detail-tree-row"><span class="tree-kind-badge kind-inherited" title="Content this type takes from a base type">inherited</span> <span class="inherited-from">from {% if node.type_href %}<a href="{{ node.type_href }}"><code>{{ node.qualified_name }}</code></a>{% else %}<code>{{ node.qualified_name }}</code>{% endif %}</span> <span class="inherited-count">{{ node.children|tree_size }} item{{ 's' if node.children|tree_size != 1 }}</span></summary>
      {{ render_tree(node.children) }}
    </details>
  </li>
  {% else %}
  {% if loop.previtem is defined and loop.previtem.kind == 'inherited' %}
  <li class="tree-own-heading"><span>Defined here</span></li>
  {% endif %}
  {% 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 %}{% if node.anchor %} id="{{ node.anchor }}"{% 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 %}
      <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 %}
      {{ source_icon(node.source_path, node.source_line) }}
    </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>
  {% endif %}
  {% 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>
  {% if item.qualified_name != item.name %}<p class="qualified-name"><code>{{ item.qualified_name }}</code></p>{% endif %}
  {% 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></p>
  {% endif %}
  {% if item.transmodel_href %}
  <p class="transmodel-concept">Transmodel concept {% if item.transmodel_href.startswith('http') %}<a href="{{ item.transmodel_href }}" target="_blank" rel="noopener noreferrer" title="Open {{ item.transmodel_concept }} in the Transmodel 6.2 model">{% else %}<a href="{{ item.transmodel_href }}" title="{{ item.transmodel_concept }} in the Transmodel 6.2 model">{% endif %}{{ item.transmodel_concept }}</a></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>
        {{ source_icon(item.enumeration_source_paths[loop.index0], item.enumeration_source_lines[loop.index0]) }}
        {% 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 example_usages %}
  <section id="examples" class="section-block compact-section">
    <h2>Examples</h2>
    <details class="example-usages"{% if example_usages|length <= 10 %} open{% endif %}>
      <summary>Used in {{ example_usages|length }} example{{ 's' if example_usages|length != 1 }}; each link goes to the first occurrence</summary>
      <ul>
        {% for usage in example_usages %}
        <li><a href="{{ usage.href }}" title="Line {{ usage.line }}"><code>{{ usage.example.path }}</code></a>{% if usage.count > 1 %} <span class="muted">{{ usage.count }} occurrences</span>{% endif %}</li>
        {% endfor %}
      </ul>
    </details>
  </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><th class="source-cell"><span class="visually-hidden">Source</span></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.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>
        <td class="source-cell">{{ source_icon(constraint.source_path, constraint.source_line) }}</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>{% if item.structure|selectattr('kind', 'equalto', 'inherited')|list %}<button type="button" class="inherited-toggle" aria-pressed="false">Expand inherited</button>{% else %}<span class="count-pill">{{ item.structure|length }} top-level</span>{% endif %}</div>
    <div class="schema-tree detail-schema-tree">{{ render_tree(item.structure) }}</div>
  </section>
  {% endif %}


  {% macro attribute_rows(attributes, show_origin) %}
    <div class="table-wrap"><table><thead><tr><th>Attribute</th><th>Type</th><th>Use</th><th>Documentation</th>{% if show_origin %}<th>Inherited from</th>{% endif %}<th class="source-cell"><span class="visually-hidden">Source</span></th></tr></thead><tbody>
      {% for attribute in attributes %}
      <tr><td><code>{{ attribute.name }}</code>{% if attribute.qualified_name != attribute.name %}<div class="sub-label">{{ attribute.qualified_name }}</div>{% endif %}</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>
        {% if show_origin %}<td>{% if attribute.inherited_from_href %}<a href="{{ attribute.inherited_from_href }}"><code>{{ attribute.inherited_from }}</code></a>{% else %}<code>{{ attribute.inherited_from }}</code>{% endif %}</td>{% endif %}
        <td class="source-cell">{{ source_icon(attribute.source_path, attribute.source_line) }}</td></tr>
      {% endfor %}
    </tbody></table></div>
  {% endmacro %}
  {% if item.attributes %}
  {% set own_attributes = item.attributes|rejectattr('inherited_from')|list %}
  {% set inherited_attributes = item.attributes|selectattr('inherited_from')|list %}
  <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>
    {% if own_attributes %}{{ attribute_rows(own_attributes, false) }}{% endif %}
    {% if inherited_attributes %}
    <details class="inherited-block inherited-attributes">
      <summary><span class="tree-kind-badge kind-inherited">inherited</span> <span class="inherited-count">{{ inherited_attributes|length }} attribute{{ 's' if inherited_attributes|length != 1 }} from base types</span></summary>
      {{ attribute_rows(inherited_attributes, true) }}
    </details>
    {% endif %}
  </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 %}