Feature Request: Add ES Module import

[bogdancondorachi]

Hi! 👋

It would be great if USAL could be imported as an ES module, for example in Vite projects.
Right now, importing it like this doesn’t work:

import usal from "usal";

usal();

It throws:

Uncaught SyntaxError: The requested module 'usal' does not provide an export named 'default'

It would be awesome to have proper ESM support, so it can be used with modern bundlers instead of only via CDN or framework-specific builds.

Additionally, a cleaner configuration API would be great — something like this would feel more natural:

import usal from "usal"

usal({
  once: true,
  defaults: {
    duration: 900,
    delay: 200,
    easing: "ease"
  }
})

Thanks for your work — it’s a great library! 🙌

[italoalmeida0]

Hi! 👋

Try this and see if you have any other problems:

import "usal";

globalThis.USAL.config({
  once: true,
  defaults: {
    duration: 900,
    delay: 200,
    easing: "ease",
  },
})

cdn:

 import "https://esm.sh/usal"

globalThis.USAL.config({
  once: true,
  defaults: {
    duration: 900,
    delay: 200,
    easing: "ease",
  },
})

or

<script type="module" src="https://esm.sh/usal"></script>

globalThis.USAL.config({
  once: true,
  defaults: {
    duration: 900,
    delay: 200,
    easing: "ease",
  },
})

[bogdancondorachi]

Indeed, the following does the work for me, even though it's not the cleanest solution.

import "https://esm.sh/usal"

globalThis.USAL.config({
  once: true,
  defaults: {
    duration: 900,
    delay: 200,
    easing: "ease",
  },
})

If possible, it would be great to have native ESM support in the future — it would make the library much easier to use and integrate in modern setups.

Also, being able to call the config directly through a usal.config({}) instance would feel much more modern and intuitive than setting it globally through window or globalThis.

[italoalmeida0]

@bogdancondorachi Yes, I intend to improve the integration and configuration API soon. Thanks for the suggestion, I agree with you.