{% extends "pydata_sphinx_theme/layout.html" %}

{# ==========================================================
   模块 1：动态控制侧边栏折叠按钮
   ========================================================== #}
{% block extrahead %}
    {{ super() }}

    {# 强制变量类型转换，完美兼容 Python 的 False 布尔值 #}
    {% if theme_enable_collapse_sidebar | string | lower == 'false' %}
        <style>
            .sidebar-primary-item.pst-sidebar-collapse,
            #pst-collapse-sidebar-button {
                display: none !important;
                visibility: hidden !important;
                height: 0 !important;
                padding: 0 !important;
                margin: 0 !important;
                pointer-events: none !important;
            }
        </style>
    {% endif %}
{% endblock extrahead %}

{# ==========================================================
   模块 2：绝对覆盖 Footer 与零跳动滚动引擎
   ========================================================== #}
{% block footer %}
    {{ super() }}

    <script>
        document.addEventListener("DOMContentLoaded", function() {

            const footer = document.querySelector(".bd-footer");

            // 【核心优化】DOM 级联兜底：确保在搜索页、404 等非常规页面依然能找到挂载点
            const targetContainer = document.querySelector(".bd-article-container") ||
                                    document.querySelector(".bd-content") ||
                                    document.querySelector(".bd-main") ||
                                    document.body;

            if (!footer) return;

            // 降维转移：将 Footer 提升到 body 级，脱离 Grid 束缚
            document.body.appendChild(footer);

            // 注入幽灵占位符：稳定主容器高度，打通侧边栏滑动轨道
            const spacer = document.createElement("div");
            spacer.style.width = "100%";
            spacer.style.display = "block";
            spacer.style.clear = "both";
            targetContainer.appendChild(spacer);

            let ticking = false;

            // 渲染同步引擎
            function updateLayout() {
                // Read Phase (批量读 DOM，防止布局抖动)
                const footerHeight = footer.offsetHeight;
                const footerTop = footer.getBoundingClientRect().top;
                const viewportHeight = window.innerHeight;

                let overlap = viewportHeight - footerTop;
                overlap = overlap > 0 ? Math.ceil(overlap) : 0;

                // Write Phase (批量写 DOM，利用 GPU 加速)
                if (spacer.style.height !== `${footerHeight}px`) {
                    spacer.style.height = `${footerHeight}px`;
                }
                document.documentElement.style.setProperty('--zcnote-footer-overlap', `${overlap}px`);

                ticking = false;
            }

            function requestTick() {
                if (!ticking) {
                    window.requestAnimationFrame(updateLayout);
                    ticking = true;
                }
            }

            // 绑定无源侦听器 (Passive Listeners) 提升滚动流畅度
            window.addEventListener("scroll", requestTick, { passive: true });
            window.addEventListener("resize", requestTick, { passive: true });

            // 监控 Footer 自身响应式高度的变化
            const ro = new ResizeObserver(() => requestTick());
            ro.observe(footer);
        });
    </script>
{% endblock %}