Spike/add interaction

[TintoSoft]

🎩 What?

Added full support and generic typing for centralized interactions in Wrapito (e.g., @testing-library/user-event), including:

New/updated generic types:

• InteractionOptions<UserLib, UserInstance, UserSetupOptions>
• WrapOptions<UserSetupOptions>
• Config<UserLib, UserInstance, UserSetupOptions>
• Wrap<UserLib, UserInstance, UserSetupOptions>

API:

• withInteraction(config) now accepts typed options (SetupOptions) per test.
• mount() now also returns user?: Instance, the typed instance of the interaction library.

Implementation:

• withInteraction is typed and updated to store interactionConfig in options.
• getMount retrieves the interaction from getConfig() and generates user using interaction.setup(lib, config) if defined; otherwise, it exposes the lib directly.

Consumer typing:

• Example and recommendation for global.d.ts (or project types) to declare a specialized Wrap with UserEvent or any other interaction library, so that user has proper typing and autocompletion in tests.

🤔 Why?

Before:

With userEvent v14, each test required manually executing userEvent.setup(). This implied:

• Importing the library in each test.
• Running setup() for each test.
• Not being able to provide global configuration options (e.g., advanceTimers in tests with fake timers).

Now:

• The setup can be centrally configured in Wrapito's configure().
• Tests that need specific configuration can pass it via withInteraction().
• This centralizes and simplifies userEvent setup.
• It also allows using other interaction libraries, such as fireEvent, with the same API and safe typing.

🧪 How to use it

Setup

Test example

Declare global