⚠️ IMPORTANT PREREQUISITE: To use this plugin, you must enable ID attributes in your app settings:
1. Go to Settings > General > Advanced Options.
2. Check the box: "Expose the option to add an ID attribute to HTML elements".

----------------------------------------

📚 HOW TO USE (PRO ELEMENTS)

VELOCITA HORIZONTAL SCROLLING
The ultimate lateral experience.

  - Set up a Container Group (ID: horizontal-section) and a Track Group (ID: horizontal-track) inside it.

  - Place the Velocita Horizontal Scrolling element on the page.

  - Set the IDs in the properties. The vertical "scroll depth" is calculated automatically based on your track's content width.


VELOCITA PINNING
Lock elements in view.

  - Target any group by ID.

  - Define how long it should stay pinned (Duration %) and whether the content below should wait (Pin Spacing).


VELOCITA MAGIC CURSOR
A high-end follower that feels like "liquid."

  - Place the Velocita Cursor element anywhere (1x1 px).

  - Set your desired Color and Size.

  - Enable Blend Mode for a premium "inverted" look over text.

  - Check Hide Default to kill the system cursor with our proprietary anti-reset logic.


VELOCITA TEXT REVEAL
Sophisticated entrance for headlines.

  - Give your Text element an ID (e.g., hero-text).

  - Place the Velocita Text Reveal element.

  - Set Target ID to hero-text and choose Split Type (Chars/Words).

  - Choose a preset like "Blur Entrance" or "Fly Up."


VELOCITA PARALLAX
Add depth to your sections.

  - Give an Image or Group an ID (e.g., bg-layer).

  - Add the Velocita Parallax element.

  - Set Speed Factor: 0.5 for slower movement, -0.5 to move in the opposite direction.

----------------------------------------

DEBUGGING:
- If nothing animates, press F12 (Console) and look for "Velocita" messages.
- Ensure your Element ID matches exactly (case sensitive).
- For Repeating Groups, ensure the ID is on the RG element itself, not the group inside the cell.