fix: type definitions for HtmxExtension

[cngJo]

The @see tag prevented tsc to properly generate types for HtmxExtension. Moving the @see above @typedef fixes this and adds types for HtmxExtension back to the package ;-)

Description

#2336 updated type generation but as a side effect the type definition of HtmxExtension got dropped / changed to any.

This is fixed now ;)

Note: I did not create an issue to prevent spam, if it's important, I'm more than happy to create one after the fact 😉

Testing

Please explain how you tested this change manually, and, if applicable, what new tests you added. If
you're making a change to just the website, you can omit this section.

Checklist

• I have read the contribution guidelines
• I have targeted this PR against the correct branch (master for website changes, dev for
  source changes)
• This is either a bugfix, a documentation update, or a new feature that has been explicitly
  approved via an issue
• I ran the test suite locally (npm run test) and verified that it succeeded

[MichaelWest22]

I found a missing new extension field

• @Property {() => string[]} getSelectors

when i was working on #2711 so this may need to be added in. This was added a few months ago for the SSE extension but it may not have been updated fully in the extension repo as well i'm thinking

[cngJo]

The two errors in the test are related to handleSwap on HtmxExtension being expected to return an array of elements instead of boolean what the type suggests.

I took a look at the implementations at htmx-extensions for handleSwap and saw both usages:

• multi-swap returns a boolean
• alpine-swap returns an array of nodes.
• morphdom-swap returns an array of nodes

What would the expected behavior be? I'd offer to update htmx-extensions with that info as well.

[cngJo]

@MichaelWest22 thanks for noticing! I found it when checking the failing tests and just force-pushed a fix, adding it to the HtmxExtension type.

Edit: forgot to update src/htmx.d.ts from dist/htmx.d.ts that's fixed now as well.

[MichaelWest22]

Also the see web link is now linking to 404 after htmx 2 upgrade and the split from to a new extension. maybe this see link needs to link to https://github.com/bigskysoftware/htmx-extensions/blob/main/README.md instead maybe since I can't see any other place this info is now. the info here also probably needs updating...

[cngJo]

There is https://htmx.org/docs/#extensions, but itself just points to the README you linked. I've updated the link accordingly and going to file a PR against https://github.com/bigskysoftware/htmx-extensions to update the type information in the README as well.

[cngJo]

@Telroshan I updated the return type of getSelectors to also allow null, as per bigskysoftware/htmx-extensions#49 (comment)

[Telroshan]

Perfect thanks! Last request; could you remove the changes to dist as per the contributing guidelines ? We generate those files when cutting a new release

[cngJo]

Oh, sorry ... but sure - I removed the changes from the dist/ directory :-)

[Telroshan]

Thanks!