Skip to content

Add annotate wide mode#578

Merged
backnotprop merged 4 commits intobacknotprop:mainfrom
dgrissen2:feat/annotate-wide-mode
Apr 19, 2026
Merged

Add annotate wide mode#578
backnotprop merged 4 commits intobacknotprop:mainfrom
dgrissen2:feat/annotate-wide-mode

Conversation

@dgrissen2
Copy link
Copy Markdown
Contributor

Summary

Adds an annotate-only wide mode so wide tables can be reviewed and annotated without the left TOC or right annotations panel consuming horizontal space.

Why

Plannotator's annotate view is hard to use on wide markdown tables because the reader stays capped while both side panels remain available. This change adds a focused reading mode for annotate sessions that expands the document area and keeps annotation flows working without reopening the right panel.

What changed

  • add a wide-mode toggle beside the lightning-bolt action in the annotate toolstrip and sticky header lane
  • gate the feature to annotate mode only so plan review, diff, archive, linked-doc non-annotate flows, and review-editor do not gain new UI
  • collapse the left sidebar, hide left collapsed tab flags, hide the right annotations panel and resize handle, and remove the annotate reader width cap while wide mode is active
  • restore the exact pre-wide sidebar/panel layout when wide mode is turned off
  • exit wide mode before any explicit sidebar or annotations-panel reopen action
  • add focused helper/test coverage for annotate-wide-mode gating and layout restore rules
  • add the missing @plannotator/shared Vite alias in the hook/review apps so local builds stay green from this checkout
  • add an adversarial rubric file required for red-team auditing of this milestone

Verification

  • bun test packages/editor/wideMode.test.ts
  • bun x tsc --noEmit -p packages/shared/tsconfig.json && bun x tsc --noEmit -p packages/ai/tsconfig.json && bun x tsc --noEmit -p packages/server/tsconfig.json
  • bun run --cwd apps/review build
  • bun run build:hook
  • manual local plugin swap and roundtrip validation between installed production plugin and local apps/hook

Local test notes

After swapping Claude's installed Plannotator plugin to this branch locally, annotate mode now exposes the wide-mode toggle next to the lightning bolt. Toggling it should hide both side panels, widen the reader, keep the right panel hidden while creating annotations, and restore the previous layout when toggled off.

@backnotprop
Copy link
Copy Markdown
Owner

Could this be considered a "focus mode" -- Ive been wanting to annotate without the right side drawer opening...

Will evaluate your PR shortly.

@dgrissen2
Copy link
Copy Markdown
Contributor Author

Focus mode works for me -- but I find i need both TOC collapsed and sidebar collapsed to get the width I need (see screenshot of it running locally)

image

@backnotprop
Copy link
Copy Markdown
Owner

Thanks, I see what you mean. Im going to add on to this and make an additional focus more.

I can give you better ergonomics around the table too. Copy table, maybe a pop-out view in a future doc.

@backnotprop
Copy link
Copy Markdown
Owner

Also, I like the button you created. I just don't want that toolbar to get too crowded. Are you cool with this?

image

I'll be pushing to this branch shortly. I plan to merge tonight.

…controls

- Drop annotate-only gate in canUseAnnotateWideMode; available in plan review, annotate, and linked-doc flows (archive/diff still excluded)
- Add Focus mode alongside Wide: both collapse sidebars and suppress annotation panel auto-open; only Wide removes the reader width cap
- Move controls out of AnnotationToolstrip/StickyHeaderLane; render as absolute-positioned "Wide | Focus" text buttons floating above the plan card's top-right edge (no vertical space cost)
- Add Radix-based Tooltip primitive (packages/ui/components/Tooltip.tsx) and TooltipProvider; replaces the ad-hoc CSS tooltip with portaled, accessible, animated content
- Polish: tracking-wide for 11px labels, focus-visible ring, active press state, aria-pressed, weight-stable toggle (color-only), 60px right offset under tater mode

For provenance purposes, this commit was AI assisted.
The annotateMode gate was removed — update the test matrix to assert
wide mode is enabled in annotate AND plan review, and disabled for
archive/diff across both mode values.

For provenance purposes, this commit was AI assisted.
The parameter was ignored after the annotate-only gate was removed.
Prune it from the signature, the App.tsx call site and deps, and the
test matrix to match the actual behavior (disabled only for archive
and diff).

For provenance purposes, this commit was AI assisted.
@backnotprop backnotprop merged commit 8a4ef65 into backnotprop:main Apr 19, 2026
7 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants