feat(ecl-auto): ECL improvements and better custom drawing

[g0dkar]

feat(ecl-auto): ECL improvements and better custom drawing

---

4.4.0

I'm trying to keep a better CHANGELOG from now on ^^

Changed

• Changed default ECL from VERY_HIGH to LOW as to stay closer to what other tools seems to use as a default
• Computing the informationDensity value now always goes for the least possible value (down from a minimum of 6 set by QRCodeBuilder)
• Better documentation of methods - this is an ongoing initiative!

New

• New InsufficientInformationDensityException: instead of an IllegalArgumentException, this new exception is thrown with a more helpful message
• Added useCustom<Canvas/BufferedImage>() methods to the QRCodeProcessor platform-specific classes: This allows users to manually set their own "painting instrument instance".
  • Easiest way to take advantage of this feature is to use the new AndroidQRCodeGraphicsFactory and JvmQRCodeGraphicsFactory classes. For example: QRCode.ofSquares().withGraphicsFactory(AndroidQRCodeGraphicsFactory(myCustomCanvas, 0, 0))
  • Idea/request from Issue QR Code images are large, unnecessarily complex, and not well detected #141 by @dgmltn (Thanks!)
• Added examples demonstrating what the ECL does (same data, different ECLs)
• Added examples demonstrating what a Mask Pattern does (same data, different masks)

Removed

• forceInformationDensity was removed. Now the QRCodeBuilder class uses infoDensity = 0 (default value) as a trigger to compute it automatically since it needs to be >= 1
  • Default value calling QRCode() directly is still 6 as to keep a bit of backwards compatibility 😅

Internal

• Renamed "typeNum" to "informationDensity"
• Updated dokka and KMP
• Fixed dokka always triggering building the whole docs/dokka/ folder (that is only for GH Pages)