Summary
When a document starts with a query block as its first block, there is no reliable way to enter edit context for the document.
Problem
If the first block in a document is a query block, the user cannot place the cursor into the document body to begin editing. This effectively traps the document outside the edit context unless another editable block precedes it.
Steps to Reproduce
Create or open a document.
Make the first block a query block.
Exit edit context or open the document in read/view context.
Try to re-enter edit context by clicking into the document content area.
Actual Result
The document does not enter edit context. The user cannot place the cursor before or into the first block.
Expected Result
The user should be able to enter edit context even when the first block is a query block, and place the cursor at the start of the document.
Impact
This blocks editing of documents whose first block is a query block, creating a confusing dead end in the editor UX.
Notes
This seems related to the editor not having a place to put the cursor when the first block is a query block.
A possible fix would be to ensure there is always a valid editable insertion point before the first block, or to let the query block container hand off focus into edit context. We want the same thing at the bottom.
Card should have the same problem, but they don't because they can be selected compared with the query blocks. Once selected, pressing arrow+up will create an empty block above.
Plan
We’re >95% confident now.
Implementation plan I’d use:
frontend/packages/shared/src/models/editor-handlers-context.ts
extend EditorHandlers with one edge-entry hook
purpose: let wrapper-level invisible hit areas trigger “start” / “end” insertion behavior without coupling to desktop-only code
frontend/packages/editor/src/document-editor.tsx
refactor read-only entry handling from mousedown + click to pointer/tap-aware handling
keep current guards:
drag != activate
touch scroll != activate
existing selection click/tap clears selection first
links / interactive content keep current behavior
keep current text-block click-to-edit behavior for normal body clicks
add pending edge-action state/ref:
start
end
plus “explicit edge activation” marker
consume that pending action during edit entry, after initial content is loaded:
if first/last block is text: place cursor at start/end, no insertion
if first/last block is non-text: insert plain top-level empty paragraph before/after, then focus it
do not change Enter-key fallback in this pass
frontend/packages/ui/src/resource-page-common.tsx
add shared invisible edge-zone wiring around DocumentContentComponent
top zone:
includes the visible gap below title/summary/header and above first body block
does not hijack clicks on title/summary/header controls themselves
bottom zone:
defined by the last real document block
excludes inlineInsert / inlineCards
keep zero visible/layout change
tests
likely add a new frontend/packages/editor/src/document-editor.test.tsx
cover:
first block query/embed/media -> top zone inserts paragraph before
last block query/embed/media -> bottom zone inserts paragraph after
first/last block text -> cursor moves, no insertion
existing read-only selection -> first tap/click only clears selection
touch tap activates, touch scroll does not
links / interactive block UI still not hijacked
Order:
extend shared handler contract
implement pending edge-action logic in document-editor.tsx
wire top/bottom shared hit areas in resource-page-common.tsx
add regression tests
Recap
Final plan: implement a shared, zero-visual-change fix for edit-entry dead ends by adding invisible top/bottom edge activation zones. Top includes the header/body gap; bottom is relative to the last real content block only. Explicit tap/click on those zones should place the cursor at the start/end when the edge block is text, or insert a plain top-level paragraph before/after when the edge block is non-text.
No query-specific special case; rule is generic for all non-text edge blocks.
No header-field behavior changes; title/summary keep their current semantics.
No keyboard-scope expansion in this pass; Enter fallback stays as-is.
Expected files to modify: frontend/packages/shared/src/models/editor-handlers-context.ts, frontend/packages/editor/src/document-editor.tsx, frontend/packages/ui/src/resource-page-common.tsx, plus new/updated editor tests.
Do you like what you are reading? Subscribe to receive updates.
Unsubscribe anytime