{% extends "base.html" %}

{#
================================================================================
Generic Page Template (Kida-Native)
================================================================================

Default template for standalone pages.

KIDA FEATURES USED:
- {% let %} for template-scoped variables
- Optional chaining (?.) for null-safe access
- Null coalescing (??) for smart defaults
- {% def %} for reusable components

USAGE:
Auto-selected for pages without a specific type
================================================================================
#}

{% from 'partials/navigation-components.html' import breadcrumbs, page_navigation %}
{% from 'partials/components/tags.html' import tag_list %}
{% from 'partials/components/widgets.html' import random_posts %}
{% from 'partials/components/related-posts-simple.html' import related_posts_simple %}

{# =============================================================================
   MAIN TEMPLATE
   ============================================================================= #}

{% block content %}
{# Template-scoped variables #}
{% let page_title = page?.title ?? 'Page' %}
{% let page_tags = page?.tags ?? [] %}
{% let page_href = page?.href ?? '' %}
{% let css_class = params?.css_class ?? '' %}

<div class="container">
  <div class="{{ ['page-layout', 'page-with-toc' if toc] | classes }}">
    <article class="page prose {{ css_class }}">
      <header class="page-header">
        <h1>{{ page_title }}</h1>
      </header>

      <div class="page-content">
        {{ content | safe }}
      </div>

      {% if page_tags | length > 0 %}
      <footer class="page-footer">
        <div class="tags">
          <strong>Tags:</strong>
          {{ tag_list(page_tags) }}
        </div>
      </footer>
      {% end %}
    </article>

    {% if toc %}
    <aside class="page-sidebar">
      {# Contextual Graph Minimap - starts hidden, JS expands when data available #}
      {% set show_graph = theme.features is not defined or 'graph.contextual' in theme.features %}
      {% if show_graph %}
      <div class="graph-contextual" data-page-url="{{ page_href }}">
        <div class="graph-contextual-container graph-loading"></div>
      </div>
      {% end %}

      <nav class="toc" aria-label="Table of contents">
        <h2 class="toc-title">On This Page</h2>
        <div class="toc-content">
          {{ toc | safe }}
        </div>
      </nav>

      {# Random posts #}
      {{ random_posts(count=3) }}
    </aside>
    {% end %}
  </div>

  {# Page Navigation (prev/next) #}
  {{ page_navigation(page) }}

  {{ related_posts_simple(page?.related_posts ?? [], 'Related Posts') }}
</div>
{% end %}