opencd/BUGFIX_PLAN.md

BUGFIX_PLAN.md — OpenCD CSS Overhaul

Author: Colonel John Hannibal Smith (A-Team command)
Status: Approved — execute per work breakdown
Context: Bug analysis of opencd.css + 3 templates against Ludo's 8 critical bugs
Date: 2026-05-25

---

Table of Contents

1. Bug-by-Bug Analysis
2. CSS to Cut — Line-Level Audit
3. CD Dimension Recalculation
4. Reset Strategy
5. Work Breakdown

---

1. Bug-by-Bug Analysis

Bug #1 — Inline <style> blocks in all 3 templates

Current state: Each template has an inline <style> block containing demo page chrome:

Template	Lines	What's in the block
jewel-case.html	8–55	body flex layout, .demo-controls, .demo-footnote
back-tray.html	8–60	Same body + .demo-tray-container wrapper
leaflet.html	8–86	Same body + .leaflet-content--multi, .leaflet-pages

Verdict: These are demo scaffolding, not framework component CSS. Removing <style> entirely without moving this chrome somewhere breaks the demos. There are two clean approaches:

Option A (recommended): Create templates/demo.css — a shared demo chrome file imported by all 3 templates. This gets