feat: implement viewport clamping for menu positioning

[caio-pizzol]

This commit adds a new utility function, clampToViewport, to ensure that the menu is positioned within the visible area of the viewport. The function adjusts the menu's coordinates based on predefined padding and approximate dimensions, enhancing the user experience by preventing overflow.

[linear]

SD-546 Fix menu positioning near viewport edges

Summary

Clamp menu position to viewport bounds so menu doesn't appear off-screen when trigger is near window edges

Tasks

• Create simple viewport boundary checking function
• Apply clamping to menu position before setting state
• Test trigger near all four viewport edges
• Verify menu stays visible and properly positioned

Notes

Problem: When user types trigger near right/bottom edge of viewport, menu appears partially or fully off-screen

Current code (src/index.tsx):

const coords = e.view.coordsAtPos(from);
const bounds = new DOMRect(coords.left, coords.top, 0, 0);
setMenuPosition(bounds); // No boundary checking

Simple fix (don't over-engineer):

const clampToViewport = (rect: DOMRect): DOMRect => {
  const menuWidth = 250; // Approximate menu width
  const menuHeight = 300; // Approximate menu height
  
  const left = Math.min(
    rect.left,
    window.innerWidth - menuWidth - 10 // 10px padding
  );
  
  const top = Math.min(
    rect.top,
    window.innerHeight - menuHeight - 10
  );
  
  return new DOMRect(Math.max(left, 10), Math.max(top, 10), 0, 0);
};

// Usage
const coords = e.view.coordsAtPos(from);
const bounds = clampToViewport(new DOMRect(coords.left, coords.top, 0, 0));
setMenuPosition(bounds);

Don't:

• Calculate actual menu dimensions (expensive)
• Add complex positioning logic (top/left/right/bottom)
• Use portal/overlay libraries

Do: Simple hard-coded approximations work fine for 99% of cases

[superdoc-bot]

🎉 This PR is included in version 0.2.0-next.1 🎉

The release is available on:

• npm package (@next dist-tag)
• GitHub release

Your semantic-release bot 📦🚀

[superdoc-bot]

🎉 This PR is included in version 0.2.0 🎉

The release is available on:

• npm package (@latest dist-tag)
• GitHub release

Your semantic-release bot 📦🚀