docsforadobe / Types-for-Adobe

TypeScript types for Adobe: AfterEffects, Animate, Audition, Illustrator, InDesign, Photoshop, Premiere, ScriptUI.
517 stars 124 forks source link

types for illustrator 2019 ? #117

Open joisun opened 8 months ago

joisun commented 8 months ago

thanks for this repo, I was wondering why there's have types for illustrator 2022 and 2015.3, what about other versions ? which one should i use then ?

zlovatt commented 8 months ago

Hey! A few things;

Why are there different versions of docs per version of each host app?

The idea is that, as new features are added or removed or changed, that we want to maintain a history of the types for each given version. This way, if you're developing a tool aimed at AI 2015.3, you can have your tool specifically use those typedefs, and know that you're not using features that were introduced in AI 2022.

For public, commercial tools– with some hostapps, it's generally accepted that the userbase will be spread out among multiple versions of the software, and so targeting a slightly older one ensures wider adoption.

For internal, proprietary tools– some companies mandate that all artists use a specific (older) version; using just the typedefs for that version ensures compatibility in the same way.

Which should I use?

This really depends on your needs; if you're hoping to release a tool and assume that all users are using 2022 or newer, use that! If you want to support back to 2015.3, go for that version instead.

Why are some release versions missing?

Two possible answers! Either

  1. there haven't been any API changes in a given version, or
  2. nobody's taken the time to create a new version of the typedefs for that version of the hostapp

Note: an updated version of this response has been added to the main repo readme's 'faq' section