tractatus/public/js
TheFlow 8cc2c0c289 feat(phase3): add code snippet copy buttons and collapsible TOC
SUMMARY:
Implemented Phase 3 Tasks 3.6.1 and 3.6.2: Enhanced documentation
with interactive code copy buttons and collapsible table of contents.

CHANGES:

1. Created code-copy-button.js (new):
   - Auto-detects all <pre> code blocks
   - Adds "Copy" button to top-right of each block
   - Clipboard API with fallback for older browsers
   - Visual feedback: "✓ Copied!" on success
   - Styled to work on dark code backgrounds
   - Listens for 'documentLoaded' event for dynamic content
   - Accessible with aria-label

2. Created toc.js (new):
   - Automatically builds TOC from h1, h2, h3 headings
   - Sticky sidebar on desktop (lg:block)
   - Collapsible on mobile with toggle button
   - Scroll spy with Intersection Observer
   - Highlights current section
   - Smooth scroll to sections
   - Updates URL hash on navigation
   - Auto-collapses on mobile after clicking link

3. Updated docs-viewer.html:
   - Added TOC sidebar (sticky, desktop-only)
   - Improved layout with flex containers
   - Added both components to script imports
   - Maintained existing document viewer functionality

FEATURES:

Code Copy Buttons:
- Button text: "Copy" → "✓ Copied!" → "Copy"
- 2-second success/error feedback
- Works on all <pre><code> blocks
- Respects code indentation

Table of Contents:
- Auto-generated from headings with IDs
- 3-level hierarchy (h1, h2, h3)
- Visual active indicator (blue border + bold)
- Mobile toggle with chevron icon
- Sticky positioning on desktop
- Smooth scroll behavior

ACCESSIBILITY:
✓ Zero CSP violations maintained
✓ Keyboard navigation supported
✓ ARIA labels on interactive elements
✓ Semantic HTML (nav, aside)
✓ Focus indicators

PERFORMANCE:
- Intersection Observer for scroll spy (better than scroll listeners)
- Minimal DOM manipulation
- CSS transitions for smooth UX
- Lazy initialization

UI_TRANSFORMATION_PROJECT_PLAN.md:
✓ Phase 3 Task 3.6.1: Code snippet copy buttons
✓ Phase 3 Task 3.6.2: Collapsible table of contents

NEXT STEPS:
- Deploy to production for testing
- Phase 3 Task 3.2: Interactive architecture diagram (complex, deferred)

🤖 Generated with Claude Code (https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-10-19 15:27:33 +13:00
..
admin feat(admin): add publish/unpublish workflow UI to dashboard 2025-10-19 13:42:47 +13:00
components feat(phase3): add code snippet copy buttons and collapsible TOC 2025-10-19 15:27:33 +13:00
demos feat: comprehensive accessibility improvements (WCAG 2.1 AA) 2025-10-12 07:08:40 +13:00
utils feat: add multi-currency support and privacy policy to Koha system 2025-10-08 15:17:23 +13:00
blog-post.js feat: newsletter modal and deployment script enhancements 2025-10-14 13:11:46 +13:00
blog.js feat: newsletter modal and deployment script enhancements 2025-10-14 13:11:46 +13:00
case-submission.js fix(csp): clean all public-facing pages - 75 violations fixed (66%) 2025-10-19 13:17:50 +13:00
check-version.js fix(csp): clean all public-facing pages - 75 violations fixed (66%) 2025-10-19 13:17:50 +13:00
docs-app.js fix(mobile): implement navigation toggle for document viewer 2025-10-19 12:41:48 +13:00
docs-search-enhanced.js feat: enhance FAQ for Leader audience and improve navigation 2025-10-14 10:53:47 +13:00
docs-viewer-app.js feat: fix CSP violations & implement three audience paths 2025-10-07 12:21:00 +13:00
faq.js refactor: rewrite Copilot Q&A in measured, evidence-based tone 2025-10-14 14:19:46 +13:00
i18n-simple.js feat(i18n): enhance browser language detection with clear priority logging 2025-10-19 15:01:14 +13:00
koha-donation.js feat(koha): implement Stripe Customer Portal integration 2025-10-18 22:19:08 +13:00
koha-success.js fix(csp): clean all public-facing pages - 75 violations fixed (66%) 2025-10-19 13:17:50 +13:00
koha-transparency.js feat: complete Priority 2 - Enhanced Koha Transparency Dashboard 2025-10-11 17:14:34 +13:00
leader-page.js feat: add case submission portal admin interface and i18n support 2025-10-16 14:50:47 +13:00
media-inquiry.js fix(csp): clean all public-facing pages - 75 violations fixed (66%) 2025-10-19 13:17:50 +13:00
media-triage-transparency.js feat: comprehensive accessibility improvements (WCAG 2.1 AA) 2025-10-12 07:08:40 +13:00
researcher-page.js feat: add case submission portal admin interface and i18n support 2025-10-16 14:50:47 +13:00
scroll-animations.js feat(phase3): implement scroll animations with Intersection Observer 2025-10-19 15:09:59 +13:00
version-manager.js fix: PWA install button UX improvements and CSP compliance 2025-10-15 08:39:47 +13:00