Broken TypeScript types in 1.9.10

[nwalters512]

There are two issues with the TypeScript types that prevent tsc from typechecking a project that uses HTMX:

• The syntax at the following line is invalid (the ? should come before the ::

  htmx/src/htmx.d.ts

  Line 432 in 145627a

  ignoreTitle:? boolean;

• The type referenced on the following line (HtmxTriggerSpecification) does not exist:

  htmx/src/htmx.d.ts

  Line 438 in 145627a

  triggerSpecsCache?: {[trigger: string]: HtmxTriggerSpecification[]};

The first is trivial to fix, but I'm not sure what the type for HtmxTriggerSpecification is supposed to be. If someone can point me in the right direction, I can open a PR.

It'd be great to have CI check these types to prevent future regressions!

[scrhartley]

Looking at this recent PR: #2107

Hey all, we're about to do a pretty significant refactor and unfortunately now isn't the right time to introduce this. The htmx typing story is at the moment incomplete—if you want to update the API types you're more than welcome to.

and

Haha the guidance is, for the moment, please hold off on TS changes.

EDIT: unless they're to the type declarations in the API interface.

Given that's the current stance, I question whether the triggerSpecsCache property should have been added (which was done as part of #2094).

[nwalters512]

I imagine they shouldn't have been added. What's the best course of action here: remove triggerSpecsCache and fix the syntax error in ignoreTitle?

[nwalters512]

I opened #2261 to fix this.

[Telroshan]

Hey @nwalters512 , would you be willing to give a shot to htmx 2 on the v2.0v2.0 branch, on which we made some work on types?
Precisely, we added JSDoc everywhere in the lib + now generate the typescript type declarations file instead of manually maintaining it.
I would be very happy to have some feedback of actually-typescript-users on this, as I have myself no real idea how this is supposed to be used 😆
⚠️ please note htmx 2 is in alpha at this moment!