Feat: add bounds with offset support

[Arecsu]

Summary

Adds DragBoundsWithOffset type that allows specifying an element as bounds container with optional offset values
applied to its boundaries. This was only achievable on the viewport using bounds. Now it can work with any arbitrary element.

Changes

• Add DragBoundsWithOffset type to core package
• Update compute_bound_rect function to handle element bounds with offsets
• Export new type in all framework packages (React, Svelte, Solid, Vanilla, Vue)
• Add documentation and interactive examples
• Update JSDoc comments with usage examples
• Backwards compatible

Usage

// Allow draggable to overflow parent by 30px on all sides
bounds: { element: 'parent', offsets: { top: -30, left: -30, bottom: -30, right: -30 } }

// Constrain within element with 20px padding
bounds: { element: '.container', offsets: { top: 20, left: 20, bottom: 20, right: 20 } }

[changeset-bot]

⚠️ No Changeset found

Latest commit: fcef9ea

Merging this PR will not cause a version bump for any packages. If these changes should not result in a new version, you're good to go. If these changes should result in a version bump, you need to add a changeset.

This PR includes no changesets

When changesets are added to this PR, you'll see the packages that this PR includes changesets for and the associated semver types

Click here to learn what changesets are, and how to add one.

Click here if you're a maintainer who wants to add a changeset to this PR

[vercel]

@Arecsu is attempting to deploy a commit to the Purus Projects Team on Vercel.

A member of the Team first needs to authorize it.