feat: Configurable Globals

[huntabyte]

This pull request introduces a significant update, but no breaking changes to the library, focusing on making global objects like window, document, and navigator configurable. This allows for better flexibility and testing capabilities.

Configurable Globals:

• New Types and Defaults:
  • Added new types ConfigurableWindow, ConfigurableDocument, ConfigurableDocumentOrShadowRoot, ConfigurableNavigator, and ConfigurableLocation to allow custom global objects.
  • Defined default global objects based on the environment (BROWSER).

Utility Functions and Classes:

• AnimationFrames:

  • Updated the AnimationFrames class to accept a configurable window object and use it for requestAnimationFrame and cancelAnimationFrame.

• ElementRect:

  • Modified the ElementRect class to accept a configurable window object and use it in useResizeObserver and useMutationObserver.
  • Modified the state to be deeply reactive, rather than reassigning the entire object each update.

• ElementSize:

  • Updated the ElementSize class to accept a configurable window object and use it for ResizeObserver.

• IsFocusWithin:

  • Enhanced the IsFocusWithin class to accept configurable document and window objects and use a new useActiveElement utility.

• IsIdle:

  • Updated the IsIdle class to accept configurable document and window objects and use them for event listeners and visibility change detection.

Testing:

• IsFocusWithin Tests:
  • Replaced the Svelte component-based tests with direct class tests, adding more comprehensive test cases including shadow DOM scenarios.

These changes improve the flexibility and testability of Runed by allowing custom global objects to be used in various utilities and classes.

Closes #167

[changeset-bot]

🦋 Changeset detected

Latest commit: e2d4637

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 1 package

Name	Type
runed	Minor

Not sure what this means? Click here to learn what changesets are.

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

[github-actions]

built with Refined Cloudflare Pages Action

⚡ Cloudflare Pages Deployment

Name	Status	Preview	Last Commit
runed	✅ Ready (View Log)	Visit Preview	e2d4637