v0.20.0

Notable changes

This release brings many changes — some of which can cause breakages in your code. Some APIs have been deprecated, or renamed, or removed. We've attempted to keep things as compatible as possible with previous versions, but it wasn't always possible.

Note

As a reminder, Jewel does not make guarantees about API compatibility between different releases yet. That will come with v1.0.0.

This version introduces support for the IntelliJ Platform 2024.2 (currently in beta), and brings in Compose 1.7. We're in the process of migrating some aspects to new Compose APIs, and the first such example to land is the usage of LinkAnnotations in Markdown.

We also have a new key-based icon loading API that allows you to more easily load platform icons in a cross-target way. Now, to load an icon, you can do:

// Equivalent to the old path-based API
Icon(PathIconKey("icons/myIcon.svg"), contentDescription = "...")

// For platform icons found in AllIcons
PlatformIcon(AllIconsKeys.Nodes.ConfigFolder, "taskGroup")

Note that the icons loaded by PlatformIcon need to be present on the classpath as resources. In the bridge, that's always the case as they come from the platform; in standalone, you want to add this to your build script:

dependencies {
  implementation("com.jetbrains.intellij.platform:icons:[ijpVersion]")
  // ...
}

repositories {
  // Choose either of these two, depending on whether you're using a stable IJP or not
  maven("https://www.jetbrains.com/intellij-repository/releases")
  maven("https://www.jetbrains.com/intellij-repository/snapshots")
}

Note

The repository readme has not been updated yet.

What's Changed

• Switch to IJP 242 EAP by @rock3r in #391
• Fix 242 icon loading by providing new key-based API by @rock3r in #430
• Use IJ distributions for compilation of sample by @rock3r in #434
• Fix MD code font in dark standalone theme by @rock3r in #436
• Fix publication issues by @rock3r in #435
• Replace icon paths with keys by @rock3r in #439
• Refresh Jewel Markdown README by @hamen in #438
• Migrate to the new LinkAnnotation API by @hamen in #425
• Fix snapshot publishing version by @rock3r in #440
• Cleanup icons in samples by @rock3r in #441
• Allow customizing the CommonMark Parser by @rock3r in #444
• Add JewelLogger by @hamen in #443
• Update 242 IJ Platform to beta 1 by @rock3r in #446
• Improve icon buttons by making them optionally focusable by @rock3r in #447
• Minor updates to the build files by @rock3r in #442
• Fix colour keys in bridge by @rock3r in #448
• Add Icon action button by @rock3r in #449
• Add ActionButton component by @rock3r in #450
• Add segmented controls by @RivanParmar in #387
• Remove ktlint IJ plugin from required plugins by @rock3r in #451
• Fix menu border width in bridge by @rock3r in #452

Full Changelog: v0.19.7...v0.20.0