Manual Testing Checklist

Comprehensive manual test scenarios organized by functional area. Each test targets either a feature not covered by automated tests, a cross-component interaction that is hard to isolate, or a visual/rendering concern requiring human inspection.

1. Block Management (Multi-Block Editor)

1.1 Block creation — Type in an empty block; verify new paragraph block appears
1.2 Insertion zones — Click between blocks; verify zone activates, typing creates a new block
1.3 Insertion zone keyboard — ArrowUp/Down into zone, Enter to create block, character key to create block with typed text
1.4 Paste into insertion zone — Paste multi-line content into an insertion zone; verify one block per line is created
1.5 Block split (Enter) — Press Enter mid-paragraph; verify block splits with cursor in new block
1.6 Block split with Shift+Enter — Press Shift+Enter; verify soft line break within same paragraph (not a block split)
1.7 Block split (multi-paragraph) — Type two paragraphs in one block, press Enter; verify only current paragraph splits
1.8 Merge with Backspace — Press Backspace at start of block; verify merges into previous block
1.9 Delete-if-empty — Press Backspace in an empty block; verify block is deleted
1.10 Delete last remaining block — Verify last block cannot be deleted (stays as empty paragraph)
1.11 ArrowUp from first block — Press ArrowUp at block start; verify no crash (emits boundary event)
1.12 ArrowDown from last block — Press ArrowDown at block end; verify no crash (emits boundary event)
1.13 Drag bullet visible — Verify each block has a visible bullet dot (always shown, not hidden)
1.14 Bullet hover feedback — Hover over a bullet; verify color changes from muted to primary
1.15 Bullet drag feedback — Start dragging a bullet; verify it turns primary color and grows slightly (size-6 → size-7)
1.16 Drag-to-reorder — Grab the bullet dot, drag to a zone line between two other blocks; verify block order changes
1.17 Drop zone indicator — During a drag, hover over an insertion zone; verify the zone shows a primary-colored bar
1.18 Drop zone between blocks — Drop a block into a zone between two blocks; verify it lands in between
1.19 Drop zone at top/bottom — Drop a block into the zone before the first block or after the last block; verify it lands at the edge
1.20 Drag reorder undo — Drag reorder, then undo; verify block order restores
1.21 Indent (Tab) — Press Tab; verify block indents (depth++)
1.22 Outdent (Shift+Tab) — Press Shift+Tab; verify block outdents (depth--)
1.23 Indent cascade — Indent a parent block; verify all child blocks also indent
1.24 Outdent cascade — Outdent; verify children follow
1.25 Indent max depth — Indent repeatedly to depth 10; verify clamped
1.26 Outdent min depth — Outdent at depth 0; verify stays at depth 0

2. Inline Formatting (Markdown Decorations)

2.1 Bold **text** — Type **bold**; verify bold text rendered with hidden markers
2.2 Italic *text* — Type *italic*; verify italic rendered
2.3 Strikethrough ~~text~~ — Type ~~strike~~; verify strikethrough rendered
2.4 Highlight ^^text^^ — Type ^^highlight^^; verify highlight rendered
2.5 Inline Code `code` — Type `code`; verify inline code rendered
2.6 Nested formatting — Type ***italicbold***, **boldcode**; verify both formats apply
2.7 Link [text](url) — Type [link](https://example.com); verify link rendered, URL hidden
2.8 Unmatched delimiters — Type **unmatched; verify renders as literal text
2.9 Combined bold+link — Type **[text](url)**; verify bold linked text

3. References & Tags

3.1 Page ref [[Name]] — Type [[Page Name]]; verify rendered as page reference
3.2 Page ref with alias [[Real|Display]] — Type [[Real Page|Display Name]]; verify alias rendered
3.3 Block ref ((block-id)) — Type ((block-id-1234)); verify block reference rendered
3.4 Tag #tag at word boundary — Type #tag after space; verify tag rendered
3.5 Tag NOT in middle of word — Type some#tag; verify NOT rendered as tag

4. Suggestion Menu (Pattern Plugin)

4.1 Slash / menu opens — Type /; verify suggestion menu appears at cursor position
4.2 Slash menu filters by query — Type /he; verify menu filters to heading options
4.3 Slash menu keyboard nav — ArrowDown/ArrowUp through items; verify highlight moves and wraps at ends
4.4 Slash menu Enter selects — Select "Heading 1"; verify # inserted
4.5 Slash menu Escape cancels — Press Escape; verify menu closes with no text change
4.6 [[ menu opens — Type [[; verify page reference menu appears
4.7 [[ menu Enter selects — Select a page; verify [[Page Name]] inserted
4.8 (( menu opens — Type ((; verify block embed menu appears
4.9 (( menu completion — Select a block; verify ((block-id)) inserted
4.10 # tag menu — Type #; verify tag completion menu appears
4.11 Menu position on scroll — Scroll the page; verify menu repositions to follow cursor
4.12 Menu closes on completion — After selecting an item; verify menu closes

5. Toolbar

5.1 Toolbar disabled without focus — No block focused; verify toolbar buttons disabled
5.2 Bold button — Select text, click Bold; verify **text** wraps selection
5.3 Italic button — Select text, click Italic; verify *text* wraps
5.4 Code button — Select text, click Code; verify `text` wraps
5.5 Strikethrough button — Select text, click Strike; verify ~~text~~ wraps
5.6 Highlight button — Select text, click Highlight; verify ^^text^^ wraps
5.7 Heading dropdown — Select heading level; verify # prefix inserted
5.8 Link button — Click link, modal opens, enter URL, Enter; verify [selected](url)
5.9 Page ref button — Click, modal, enter name, Enter; verify [[name]]
5.10 Block ref button — Click, modal, enter ID, Enter; verify ((id))
5.11 Tag button — Click, modal, enter tag, Enter; verify #tag
5.12 Inline math button — Click; verify $ $ inserted with cursor inside
5.13 Block math button — Click; verify $$\n\n$$ inserted with cursor between
5.14 Escape closes toolbar modal — Open any modal, press Escape; verify modal closes

6. Auto-Close Plugin

6.1 Parentheses — Type (; verify () with cursor between
6.2 Square brackets — Type [; verify [] with cursor between
6.3 Curly braces — Type {; verify {} with cursor between
6.4 Double quotes — Type " after space; verify "" with cursor between
6.5 Double quotes mid-word — Type " in middle of word; verify NOT auto-closed
6.6 Single quotes — Type ' after space; verify ''
6.7 Wrap selection in parens — Select text, type (; verify (selected)
6.8 Skip-over close — Cursor between (), type ); verify cursor moves past )
6.9 Delete pair (Backspace) — Cursor between (), press Backspace; verify both parens removed
6.10 Bold auto-close ** — Type * then * after word; verify **** with cursor between
6.11 Strike auto-close ~~ — Type ~~; verify ~~~~ with cursor between
6.12 Highlight auto-close ^^ — Type ^^; verify ^^^^ with cursor between
6.13 Inline math auto-close $ — Type $ at word boundary; verify $$ with cursor between
6.14 Block math $$ conversion — Type $$ at line start; verify converts to math_block
**6.15 Code fence ** — Type at line start; verify converts to code_block
6.16 Underscore italic _ — Type _ at word boundary; verify __ with cursor between; NOT mid-word

7. Headings

7.1 H1 through H6 — Type # through ######; verify heading rendered with correct level
7.2 Leading whitespace before # — Type # heading; verify heading still recognized
7.3 Heading in middle of paragraph — Type text # not heading; verify NOT rendered as heading
7.4 Heading live preview — Focus on a heading; verify hash marks hidden/faded; blur, verify hash marks visible

8. Tasks

8.1 Task state TODO — Type TODO task text; verify task rendered with TODO indicator
8.2 Task state DOING — Type DOING task; verify DOING indicator
8.3 Task state DONE — Type DONE task; verify DONE indicator
8.4 Task state LATER — Type LATER task; verify LATER indicator
8.5 Task state NOW — Type NOW task; verify NOW indicator
8.6 Task state WAITING — Type WAITING task; verify WAITING indicator
8.7 Task state CANCELLED — Type CANCELLED task; verify CANCELLED indicator
8.8 Task toggle via toolbar — Click task toggle button; verify state cycles through TODO → DOING → DONE

9. Blockquotes & Callouts

9.1 Blockquote > text — Type > quote; verify blockquote rendered
9.2 Callout > [!NOTE] — Type > [!NOTE] Description; verify callout with NOTE style
9.3 Callout > [!WARNING] — Verify WARNING style
9.4 Callout > [!TIP] — Verify TIP style
9.5 Callout > [!DANGER] — Verify DANGER style
9.6 Callout > [!INFO] — Verify INFO style
9.7 Callout continuation lines — Type two lines: > [!NOTE] header then > continuation; verify both styled as callout
9.8 Blockquote continuation — Multiple > lines; verify they merge into one blockquote

10. Tables

10.1 Simple table rendering — Type | A | B |\n|---|---|\n| 1 | 2 |; verify rendered as table when blurred
10.2 Click to focus and edit — Click rendered table; verify block focuses, pipe syntax becomes editable
10.3 Table in live preview — Verify pipes hidden/faded when focused, fully visible when blurred
10.4 Table header row — Verify header row recognized and styled differently

11. Horizontal Rules

11.1 HR --- — Type --- on its own line; verify horizontal rule rendered
11.2 HR *** — Type ***; verify horizontal rule rendered (odd-length ***)
11.3 HR ---- — Type ----; verify HR (even-length also valid)
11.4 NOT HR ***** — Type *****; verify NOT HR (recognized as bold)

12. Properties

12.1 Property at line start — Type key:: value; verify key styled as property, value visible
12.2 Property NOT mid-line — Type not a key:: value; verify NOT rendered as property
12.3 Multiple properties — Multiple key:: value lines; verify each styled correctly

13. Code Blocks

13.1 Create via triple backtick — Type ` at line start; verify code block created
13.2 Language detection — Type typescript`; verify language detected with correct syntax highlighting
13.3 Language switching — Click language dropdown, change from JS to Python; verify highlighting updates
13.4 Typing inside code block — Type code; verify CM6 editor handles keystrokes, PM sees fence-wrapped content
13.5 ArrowUp at code block start — Cursor at first line, press ArrowUp; verify exits to previous block
13.6 ArrowDown at code block end — Cursor at last line, press ArrowDown; verify exits to next block
13.7 Backspace empty code block — Delete all content, press Backspace; verify block removed
13.8 Shift+Enter in code block — Press Shift+Enter; verify new paragraph inserted after code block
13.9 Code block with no language — Type ` alone; verify code block with no syntax highlighting
13.10 Tilde fences ~~~ — Type ~~~js; verify code block created with tilde fences

14. Math Blocks

14.1 Create via $$ — Type $$ at line start; verify math_block created
14.2 KaTeX rendering — Type $$\nE=mc^2\n$$; verify rendered LaTeX preview
14.3 Inline math $x^2$ — Type $x^2+1$ ; verify inline KaTeX rendered when blurred
14.4 Inline math editing — Focus on inline math; verify raw $math$ visible and editable
14.5 Math block empty — Create empty math block; verify no render errors
14.6 Navigation at math block boundaries — ArrowUp/Down at math block edges; verify focus moves correctly

15. Undo / Redo

15.1 Typing undo — Type text, press Ctrl+Z (or ⌘Z); verify text reverted
15.2 Typing redo — After undo, press Ctrl+Shift+Z; verify text restored
15.3 Block split undo — Split a block with Enter, then undo; verify blocks merge back
15.4 Block merge undo — Merge with backspace, then undo; verify split restored
15.5 Block indent undo — Indent with Tab, then undo; verify depth restored
15.6 Block delete undo — Delete an empty block, undo; verify block reappears
15.7 History coalescing — Type rapidly; verify single undo step reverts all, not character-by-character
15.8 History separate for pause — Type, pause >500ms, type more; verify two separate undo steps
15.9 Toolbar undo/redo buttons — Click undo/redo buttons; verify same behavior as keyboard

16. Live Preview & Marker Visibility

16.1 Markers hidden when blurred — Click outside editor; verify **, *, `, ~~, ^^ markers are hidden
16.2 Markers visible near cursor — Click inside formatted text; verify markers fade or show near cursor
16.3 always-visible mode — Set markerMode="always-visible"; verify markers never hide
16.4 live-preview mode default — Default mode; verify markers hide on blur
16.5 Table source hidden on blur — Blur a table block; verify raw pipe syntax hidden, rendered table shown
16.6 Inline math KaTeX on blur — Blur inline math; verify rendered math shown, $ hidden

17. Paste Handling

17.1 Single-line paste — Paste one line of text; verify it stays in current block
17.2 Multi-line paste (same type) — Paste multiple paragraphs; verify they stay in current block
17.3 Multi-line paste (mixed types) — Paste para\npara\n> blockquote; verify block splits with each type in own block
17.4 Paste with code fences — Paste text containing `; verify code block created correctly

18. Focus Management

18.1 Focus one block at a time — Click different blocks; verify only one block has focus
18.2 Focus registry tracking — Check focusedId updates as different blocks are clicked
18.3 Column-preserving navigation — ArrowUp/Down between blocks; verify cursor aligns to same X coordinate
18.4 Programmatic focus — Set cursorPosition prop; verify block focuses at correct position

19. Extensibility & Plugins

19.1 Custom pattern triggers — Add extraPatterns prop; verify custom trigger opens suggestion menu
19.2 Custom inline rules — Register extraInlineRules; verify new syntax is decorated
19.3 Custom NodeViews — Register custom nodeView; verify it renders correctly

20. Theme System

20.1 Default theme — Verify default CSS variables applied
20.2 Kanagawa theme — Apply kanagawa preset; verify colors change
20.3 Custom theme — Provide custom ThemeInput; verify CSS variables override
20.4 Theme switching at runtime — Switch themes; verify all components update instantly

21. Debug Logging

21.1 Global debug * — Set localStorage.setItem("editor:debug", "*"); verify all namespaces logged
21.2 Filtered namespaces — Set "Block,ParseEngine"; verify only those namespaces logged
21.3 Per-component debug — Set debug prop on EditorBlock; verify scoped filtering

22. Error Recovery

22.1 EditorBlock mount failure — Deliberately break state; verify block falls back to textarea
22.2 Invalid markdown — Type extremely malformed markdown; verify no crash
22.3 Empty document — Start with empty markdown; verify editor renders one empty paragraph block

23. Edge Cases & Cross-Cutting

23.1 Unicode/emoji in content — Type emoji and CJK characters; verify roundtrip through parse/serialize
23.2 Very long content in a block — Type >1000 characters in one block; verify no performance regression
23.3 Rapid typing — Type very fast; verify coalescing works with no duplicate blocks
23.4 Keyboard shortcut collision — Verify Mod+b (bold) does not conflict with browser behavior
23.5 Vim keybindings — Switch to vim bindings; verify h/j/k/l navigation within block

TESTING.md 17 KB Histórico Raw