feat: toggle syntax, UI fixes, demos, screenshots & CI

[nsheaps]

Summary

Comprehensive set of fixes and improvements to toggles, editor UI, demo content, documentation, spaces, and CI:

Space Persistence (Bug Fix)

• Creating a new space no longer destroys the demo space — Current space state is saved to per-space workspace files before switching
• Per-space storage — Each space gets its own workspace-state.json and pages/ directory under .cept/spaces/{id}/
• Space switching loads saved state — Switching back to a space restores its pages, favorites, recent pages, and selected page
• Spaces manifest in settings — All spaces from the manifest are shown (not just a hardcoded "default")
• Demo space registered in manifest — On first init, the demo space name is written to the manifest

Toggle Fixes

• > creates a toggle, not a blockquote — Input rule with priority 110 (higher than blockquote's 100)
• Toggles are now clickable — ProseMirror plugin handles click events on summary elements
• Markdown serialization — Toggles serialize to > summary / indented content via addStorage() markdown config
• Nested toggle support — Both in parser preprocessing and editor rendering

Editor UI Fixes

• Cursor underline removed — Added text-decoration-line: none and disabled browser writing suggestions
• Links now look like links — Proper underline, color, thickness, and hover transitions
• 6-dot drag handle — Replaced vertical dots character with a 2×3 radial-gradient dot grid

Demo Content

• Working toggle demos — Features page includes nested toggles, heading toggles, list-in-toggle examples
• Working callout demos — Using HTML <div data-type="callout"> syntax
• All block types demoed — Tables, code blocks, task lists, blockquotes, text formatting
• Reset button recreates demo — handleClearAllData resets spaces manifest, recreates demo space

Documentation with Screenshots

• Screenshots embedded in docs — Features and Introduction pages include screenshots of the editor, toggles, code blocks, blockquotes, slash menu, inline toolbar, command palette, and drag handle
• {{base}} placeholder system — Asset URLs in docs content use {{base}} placeholders resolved at read time via resolveDocsContent() using document.baseURI
• Screenshots served via Vite — packages/web/public/screenshots symlinks to docs/screenshots so Vite includes them in builds
• Toggle Syntax guide — Full reference with editor shortcuts, standalone/nested examples
• Markdown Extensions guide — Standard markdown vs Cept extensions reference

Screenshots & CI

• Playwright screenshot tests — 15 features covered: landing page, editor, sidebar, toggles, callouts, code blocks, tables, task lists, blockquotes, text formatting, drag handle, slash menu, inline toolbar, command palette, settings
• Screenshot CI workflow — Captures and auto-commits screenshots on push/PR
• Cascade prevention — Skip-check stops infinite screenshot-commit loops
• Detached HEAD and non-fast-forward fixes — Workflow creates a local branch and rebases before pushing

Test Plan

• All unit tests pass (1592/1592)
• Toggle, parser, and space manager tests pass
• Typecheck passes across all packages
• Playwright screenshot tests pass
• CI: Build, Lint, Typecheck, Unit, Integration, E2E, Screenshots, Deploy all green
• Screenshot cascade prevention verified (skip-check works)

https://claude.ai/code/session_012XssQPvVcyAQwMJbQHyMkj

[github-actions]

Preview Deployment

The web app for this PR has been deployed:

Open Preview

Use this to verify the app works correctly, especially for dependency updates.

[github-actions]

Release Version Check

🟡 MINOR version bump

	Version
Current	0.1.0
Next	0.2.0

This version will be released automatically when this PR is merged to main.

Changelog preview

0.2.0 (2026-03-07)

Features

• add toggle syntax using blockquote-like > prefix with indented content (14aa841)
• comprehensive demo content with working toggles, callouts, links (5d507b4)
• comprehensive screenshot tests and CI workflow (0936789)
• docs improvements, GitHub icon, icons/toggle/extensions pages (af37570)

Bug Fixes

• ci: handle non-fast-forward push in screenshot workflow (759746c)
• ci: prevent screenshot workflow cascade (452cdc3)
• ci: push from detached HEAD in screenshot workflow (4cd616b)
• cursor underline, link styling, 6-dot drag handle (a7e6939)
• make > always create a toggle, support nested toggles (b91b663)
• make screenshot tests resilient to missing sidebar pages (d7f6654)
• make toggles clickable and serialize to markdown properly (bd8b9b7)
• pass changelog via env var to avoid template literal breakage in CI (87468e8)
• persist spaces properly so creating a new space preserves demo (7917e8a)
• retry element screenshots on DOM detachment (827e021)
• screenshot tests use .first() and waitFor to avoid strict/detach errors (9df3776)
• screenshot workflow on drafts, add markdown-extensions doc, fix paths (128e56d)
• screenshot workflow working directory for playwright (699b42e)

Documentation

• screenshots: update feature screenshots (3d102c6)
• screenshots: update feature screenshots (dea43d2)
• screenshots: update feature screenshots (0a803db)
• screenshots: update feature screenshots (3b2a06f)
• screenshots: update feature screenshots [skip ci] (41227a1)

CI/CD

• use automation bot for screenshot commits, run CI on them (64d5323)