Releases: jan-nikolov/astro-annotate
Releases · jan-nikolov/astro-annotate
v0.5.0
What's New
Features
- Pin clustering: Annotations on the same element are grouped into a single pin with a count badge
- Thread popups: Clustered pins open a thread view showing all annotations
- Escape stack: Last-opened UI element closes first on Escape (form → detail → panel → mode)
- Panel drag & resize: Free-drag via header, resize via corner handle, snap-to-side docking with animated transitions
- FAB side-switching: FABs move to opposite side when panel is docked
- Off-viewport indicators: Shows annotation count above/below the visible area
Bug Fixes
- Fix event listener accumulation in annotation form (prevented duplicate submissions on repeated open/close)
- Fix z-index stacking: clear internal layering instead of all elements at max value
- Fix thread popup scroll with correct flex layout
- Fix viewport overflow for thread popups
Code Quality
- Consolidate duplicated FAB CSS into shared base selector
- Remove unused
.aa-pin-detail-selectorCSS rule - Extract magic numbers into named constants (form layout, FAB dimensions, snap threshold)
- New
DragResizehelper class for panel drag & resize
v0.4.0 — Annotations Panel
What's New
- Annotations Panel (Alt+L): Sidebar with filterable list of all annotations — inline edit, status toggle, bulk resolve, left/right docking
- Panel state persistence: Panel visibility, filter, and side survive page navigations (View Transitions) and full reloads (sessionStorage)
- FAB-pin overlap fix: Pins that collide with the floating action button shift left automatically
- Playground View Transitions: Both playground pages now use
<ClientRouter />for SPA navigation - Shared utilities: Extracted
escapeHtmltoutils.ts - Dark mode: Full dark mode support for panel styles
v0.3.0 — Astro Dev Toolbar Integration
What's new
Native integration into the Astro Dev Toolbar via addDevToolbarApp() API (closes #6).
Changes
- New: "Annotate" icon in the Astro Dev Toolbar (replaces custom floating pill)
- New: Notification dot on toolbar icon when open annotations exist
- Sync: Keyboard shortcuts (Alt+C, Escape) sync toolbar icon state via CustomEvents
- Removed: Custom toolbar component and associated CSS (~130 lines removed)
Architecture
Two independent runtimes (toolbar app + overlay) communicate via CustomEvent:
aa:toggle— toolbar icon clicked → overlay activates/deactivatesaa:state-changed— keyboard shortcut → toolbar icon syncsaa:count— annotation count → notification dot
v0.2.1
Add dev-toolbar and devtools keywords so astro-annotate appears in the Astro Integrations directory under the Dev Toolbar category.
v0.2.0 — Faster Dev Annotation Workflow
What's New
Faster Annotation Workflow (closes #1)
- No author name field in dev mode — author defaults to "Developer"
- Persistent annotation mode — stays active after submit, annotate multiple elements without re-activating
- Keyboard shortcuts:
Alt+C(Option+Con Mac) — toggle annotation mode (Figma-inspired)Escape— close form (mode stays) → press again to exit modeCtrl+Enter/Cmd+Enter— submit (unchanged)
Fixes
- Fix View Transitions cleanup leak (stale event listeners)
- Fix pre-existing TypeScript errors (
@types/node,selector.tstyping) - Guard against clicking new element while form is open