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.