jewel

Notable changes

• We've reworked completely how the SplitLayout works. It now supports nesting and works as expected. This is a breaking change.
• We've deprecated a number of old APIs which will be removed in future releases

What's Changed

• Fixed Null Pointer in IDE sample on non INTUI themes by @francisconoriega in https://github.com/JetBrains/jewel/pull/568
• Fix global border colors by @hamen in https://github.com/JetBrains/jewel/pull/569
• Use ktfmt for formatting by @rock3r in https://github.com/JetBrains/jewel/pull/571
• Bump IJP version to 242.21829.142 (242.1) by @rock3r in https://github.com/JetBrains/jewel/pull/575
• Use icon keys everywhere by @rock3r in https://github.com/JetBrains/jewel/pull/576
• Simplify Node.readInlineContent() implementation by @rock3r in https://github.com/JetBrains/jewel/pull/577
• Remove one more usage of resource-based Icon APIs by @rock3r in https://github.com/JetBrains/jewel/pull/578
• Upgrade Compose to 1.7.0-beta01 by @rock3r in https://github.com/JetBrains/jewel/pull/580
• Improve readme and deprecate PlatformIcon by @rock3r in https://github.com/JetBrains/jewel/pull/579
• Remove Jewel usages of deprecated PlatformIcon API by @rock3r in https://github.com/JetBrains/jewel/pull/581
• New SplitLayout by @hamen in https://github.com/JetBrains/jewel/pull/570

Full Changelog: https://github.com/JetBrains/jewel/compare/v0.23.1...v0.24.0

Notable changes:

• Fixed an issue where the placeholder text in TextField could extend beyond the boundaries of the TextField itself.  

What's Changed

• Fix TextField placeholder going outside the bounds of the TextField by @rock3r in https://github.com/JetBrains/jewel/pull/567

Full Changelog: https://github.com/JetBrains/jewel/compare/v0.23.0...v0.23.1

Notable changes

• Scrollbars have been completely re-created from the ground up
  • Windows/Linux and macOS styles
  • macOS scrollbars can be AlwaysVisible or only visible WhenScrolling
  • In IJP 242, on macOS, Jewel can automatically pick the right style (not available in 233/241 due to missing IJP APIs)
• ScrollingContainer API makes it easier to implement a scrolling container with the looks and behaviour that match Swing
  • Layout adapts automatically to AlwaysVisible vs WhenScrolling
  • You can adapt by applying an end padding to "important" content (e.g., text) provided by scrollbarContentSafePadding()
  • You should not apply it to the scrollable container or the items' roots, because "unimportant" stuff (e.g., selection bg, dividers, etc) should extend all the way
• TextArea has a new BTF2-based overload, which can show vertical scrollbars
  • String- and TextFieldValue-based text components have been deprecated and will be removed before Jewel 1.0
  • You should migrate to the new TextFieldState-backed overloads as soon as possible!
  • Why moving to the new API? Find out here
• There is a new preliminary API to provide data to the IJP Actions system: Modifier.provideData()
  • It is key-value based, modeled after the UiDataProvider API in the IJP
  • It's not fully tested nor fleshed out yet, so use at your own risk
  • Not available in IJP 233/241 (should be a no-op, may cause issues — please report them)

Breaking changes

• The IntUiScrollbarStyling's API has been significantly modified, affecting how scrollbar styles are defined.
  • Migration: Adapt your scrollbar styling code to use the new API, which includes changes to function names, parameters, and the introduction of new functions for different operating systems and themes.
• The TabStyle constructor now requires an additional parameter: scrollbarStyle.
  • Migration: When creating a TabStyle, provide a value for the new scrollbarStyle parameter.

Deprecated

• The TextArea and TextField overloads that accept value and onValueChange parameters have been deprecated in favor of the respective overloads that use TextFieldState.
  • If you need to observe text changes with the new overloads, use snapshotFlow { state.text }.

What's Changed

• New iteration on scrollbars by @hamen in https://github.com/JetBrains/jewel/pull/515
• Remove obsolete expui icons folder by @hamen in https://github.com/JetBrains/jewel/pull/519
• Switch reflection-based system in standalone demo to simpler mechanism by @hamen in https://github.com/JetBrains/jewel/pull/520
• Clean up work on scrollbars by @hamen in https://github.com/JetBrains/jewel/pull/521
• Make Studio releases task triggered on demand by @rock3r in https://github.com/JetBrains/jewel/pull/523
• Fix glitch in selected menu item background by @hamen in https://github.com/JetBrains/jewel/pull/524
• Update IJP and IJP Gradle plugin by @rock3r in https://github.com/JetBrains/jewel/pull/526
• Expose PopupProperties in PopupMenu by @francisconoriega in https://github.com/JetBrains/jewel/pull/531
• Add scrollbar style and behavior reactive update for Mac OS by @hamen in https://github.com/JetBrains/jewel/pull/535
• Fix Markdown loading in standalone sample by @rock3r in https://github.com/JetBrains/jewel/pull/539
• Fix button border alignement by @hamen in https://github.com/JetBrains/jewel/pull/543
• Exclude generated files from formatKotlinMain by @hamen in https://github.com/JetBrains/jewel/pull/548
• Improve OverrideDarkMode kdocs by @rock3r in https://github.com/JetBrains/jewel/pull/552
• Iterate on keyboard shortcuts by @hamen in https://github.com/JetBrains/jewel/pull/549
• Migrate TitleBarView to new Icon API by @hamen in https://github.com/JetBrains/jewel/pull/546
• Migrated ActionSystem to Compose Traversal API & UiDataProvider API by @jakub-senohrabek-jb in https://github.com/JetBrains/jewel/pull/532
• Improve string-based Icon deprecation by @rock3r in https://github.com/JetBrains/jewel/pull/555
• Bump and clean by @rock3r in https://github.com/JetBrains/jewel/pull/557
• Reimplement/fix/complete implementation of scrollbars by @rock3r in https://github.com/JetBrains/jewel/pull/554
• Iterate on TextField and TextArea focused state UI by @hamen in https://github.com/JetBrains/jewel/pull/540

Full Changelog: https://github.com/JetBrains/jewel/compare/v0.22.2...v0.23.0

Notable changes:

• The optimizeEdits parameter in the MarkdownProcessor class has been renamed to editorMode (#485).
• The IconActionButton and IconButton components now have two new variants: Selectable and Toggleable (#501).
• The Standalone sample application now supports basic keyboard shortcuts for navigating between its main screens (#502).
• The IconKey API now includes an iconClass, used to load icons in release IDE builds (#507).
• The JewelToolWindowComposePanel component has been added to address compatibility issues with Compose 1.7 and IntelliJ toolwindows, ensuring proper layout and sizing behavior (#509, #516).

Breaking changes:

• The ToggleableComponentState interface no longer extends the SelectableComponentState interface (#501).
• The IconButtonState class no longer implements the SelectableComponentState interface (#501).
• The Debug mode has been removed, and selective logging should now be configured through the logger settings (#505).
• Several deprecated APIs related to icon keys and styling have been removed (#507).

Deprecated:

• The string-based resource APIs for the Icon component have been deprecated in favor of the IconKey-based APIs (#507).

What's Changed

• Rename optimizeEdits to editorMode in MarkdownProcessor by @rock3r in https://github.com/JetBrains/jewel/pull/485
• Improve and update Markdown readme by @rock3r in https://github.com/JetBrains/jewel/pull/482
• Add script and instructions to generate better release notes by @rock3r in https://github.com/JetBrains/jewel/pull/499
• Add basic shortcuts to Standalone L1 navigation screens by @hamen in https://github.com/JetBrains/jewel/pull/502
• Add selectable and toggleable Icon(Action)Button by @rock3r in https://github.com/JetBrains/jewel/pull/501
• Improve IconKey API to include a classloader by @rock3r in https://github.com/JetBrains/jewel/pull/507
• Remove Debug mode by @rock3r in https://github.com/JetBrains/jewel/pull/505
• Upgrade IJP to 242.20224.159 (RC) by @rock3r in https://github.com/JetBrains/jewel/pull/508
• Compose 1.7 FillMaxSize+Jpanels Workaround by @francisconoriega in https://github.com/JetBrains/jewel/pull/509
• Only apply workaround to CMP-5856 in toolwindows by @rock3r in https://github.com/JetBrains/jewel/pull/516

New Contributors

• @francisconoriega made their first contribution in https://github.com/JetBrains/jewel/pull/509

Full Changelog: https://github.com/JetBrains/jewel/compare/v0.22.1...v0.22.2

What's Changed

• Lower target JDK for 242 by @rock3r in https://github.com/JetBrains/jewel/pull/498

Full Changelog: https://github.com/JetBrains/jewel/compare/v0.22.0...v0.22.1

Notable change

This release updates Compose to 1.7.0-dev1743, which fixes a hang when using links in Markdown (or any other LinkAnnotation). It's recommended that all users on 0.20-0.21 upgrade as soon as possible.

What's Changed

• Improve borders sample page by @rock3r in https://github.com/JetBrains/jewel/pull/461
• Update README for 0.20.0 by @hamen in https://github.com/JetBrains/jewel/pull/460
• Move (Icon)ActionButton to the right package by @rock3r in https://github.com/JetBrains/jewel/pull/488
• Update target IJP to 242.20224.91 by @rock3r in https://github.com/JetBrains/jewel/pull/487
• Rename palette entry grey -> gray by @rock3r in https://github.com/JetBrains/jewel/pull/486
• Remove TextStyles from stylings by @rock3r in https://github.com/JetBrains/jewel/pull/490
• Use namedColorOrNull instead of marker for color retrieval (#142) by @jakub-senohrabek-jb in https://github.com/JetBrains/jewel/pull/493
• Upgrade IJP Gradle plugin to 2.0.0-rc1 by @rock3r in https://github.com/JetBrains/jewel/pull/468
• Add underline style to links by @rock3r in https://github.com/JetBrains/jewel/pull/492
• Update Compose to 1.7.0-dev1743 by @rock3r in https://github.com/JetBrains/jewel/pull/496

New Contributors

• @jakub-senohrabek-jb made their first contribution in https://github.com/JetBrains/jewel/pull/493

Full Changelog: https://github.com/JetBrains/jewel/compare/v0.21.0...v0.22.0

What's Changed

• Implement proper Markdown link styling by @rock3r in https://github.com/JetBrains/jewel/pull/455
• Be more specific in IDE sample run config by @rock3r in https://github.com/JetBrains/jewel/pull/456
• Fix Markdown rendering issues by @rock3r in https://github.com/JetBrains/jewel/pull/458
  • We will not optimise for edits ("editor mode") by default anymore
  • Models implement equals and hashCode
  • Inline Markdown is processed in the main processor phase, not in the rendering phase anymore
  • Inline extensions are now (tentatively) supported

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

Full Changelog: https://github.com/JetBrains/jewel/compare/v0.19.7...v0.20.0

What's Changed

• Update target IJP to 241.17890.1 by @rock3r in https://github.com/JetBrains/jewel/pull/400
• Remove erroneous imports and update resourcesDirs convention by @lamba92 in https://github.com/JetBrains/jewel/pull/402
• Add PGP signing to publications by @lamba92 in https://github.com/JetBrains/jewel/pull/403
• Fix for Snapshot publication is broken after adding PGP signing #405 by @lamba92 in https://github.com/JetBrains/jewel/pull/407
• Fix TextArea layout by @rock3r in https://github.com/JetBrains/jewel/pull/409
• Add simple FocusOutline API by @rock3r in https://github.com/JetBrains/jewel/pull/410
• Add default values to retrieve* functions by @rock3r in https://github.com/JetBrains/jewel/pull/408
• Fix default button focus outline & chip colors by @rock3r in https://github.com/JetBrains/jewel/pull/420
• Upgrade to Compose 1.7.0-dev1703 by @hamen in https://github.com/JetBrains/jewel/pull/421
• Fix soft line breaks treated as hard line breaks by @rock3r in https://github.com/JetBrains/jewel/pull/423

New Contributors

• @hamen made their first contribution in https://github.com/JetBrains/jewel/pull/421

Full Changelog: https://github.com/JetBrains/jewel/compare/v0.19.6...v0.19.7

What's Changed

• Fix Markdown styling usage, and add semantics support by @rock3r in https://github.com/JetBrains/jewel/pull/397
• Update Kotlin for 241, update all dependencies by @rock3r in https://github.com/JetBrains/jewel/pull/398

Full Changelog: https://github.com/JetBrains/jewel/compare/v0.19.5...v0.19.6

What's Changed

• Add editor & console text styles, use them in Markdown by @rock3r in https://github.com/JetBrains/jewel/pull/393

Full Changelog: https://github.com/JetBrains/jewel/compare/v0.19.4...v0.19.5

What's Changed

• Update IJP to 241.17011.79 by @rock3r in https://github.com/JetBrains/jewel/pull/390
• Improve Markdown styling by @rock3r in https://github.com/JetBrains/jewel/pull/392
• Update error text for missing tab styles

Full Changelog: https://github.com/JetBrains/jewel/compare/v0.19.3...v0.19.4

What's Changed

• Add Swing comparison tab to IDE sample by @rock3r in https://github.com/JetBrains/jewel/pull/383
• Fix scaling in the IDE once again by @rock3r in https://github.com/JetBrains/jewel/pull/384

Full Changelog: https://github.com/JetBrains/jewel/compare/v0.19.2...v0.19.3

What's Changed

• Fix scaling issues in IJP 241 a64ab518be8016a44d4815eafaf0efc958794cf1

Full Changelog: https://github.com/JetBrains/jewel/compare/v0.19.1...v0.19.2

What's Changed

• Move Markdown actual styling to bridge/standalone packages by @rock3r in https://github.com/JetBrains/jewel/pull/379
• Add text colours to GlobalColors by @rock3r in https://github.com/JetBrains/jewel/pull/381
• Allow rendering Markdown content as disabled by @rock3r in https://github.com/JetBrains/jewel/pull/382

Full Changelog: https://github.com/JetBrains/jewel/compare/v0.19.0...v0.19.1

What's Changed

• Bump IJP version to 241.1 by @rock3r in https://github.com/JetBrains/jewel/pull/374
• Fix tooltips: metrics and positioning by @rock3r in https://github.com/JetBrains/jewel/pull/377
• Use produceState instead of launched effect in indicators by @rock3r in https://github.com/JetBrains/jewel/pull/376

Full Changelog: https://github.com/JetBrains/jewel/compare/v0.18.1...v0.19.0

What's Changed

• Update onFocusChanged in SelectableLazyColumn by @fscarponi in https://github.com/JetBrains/jewel/pull/372

Full Changelog: https://github.com/JetBrains/jewel/compare/v0.18.0...v0.18.1

What's Changed

• Add icons to component sections in standalone demo by @rock3r in https://github.com/JetBrains/jewel/pull/363
• Fix crash in CircularProgressIndicator when switching themes by @rock3r in https://github.com/JetBrains/jewel/pull/360
• Fix menu dividers in bridge by @rock3r in https://github.com/JetBrains/jewel/pull/361
• Fix dividers not showing up in old UI themes by @rock3r in https://github.com/JetBrains/jewel/pull/362
• Use connect() instead of simpleConnect() by @rock3r in https://github.com/JetBrains/jewel/pull/364
• Fix text colour in Markdown (bridge) by @rock3r in https://github.com/JetBrains/jewel/pull/365
• Add onTextClick to MarkdownBlockRenderer by @rock3r in https://github.com/JetBrains/jewel/pull/366
• Add Markdown styling to theme by @rock3r in https://github.com/JetBrains/jewel/pull/367

Full Changelog: https://github.com/JetBrains/jewel/compare/v0.17.3...v0.18.0

What's Changed

• Add theme name to ThemeDefinition and JewelTheme by @rock3r in https://github.com/JetBrains/jewel/pull/353
• Update CfD to 1.6.10-dev1584 to fix Skiko crash on Windows

Full Changelog: https://github.com/JetBrains/jewel/compare/v0.17.2...v0.17.3

What's Changed

• Improve CircularProgressIndicator code by @rock3r in https://github.com/JetBrains/jewel/pull/352

Full Changelog: https://github.com/JetBrains/jewel/compare/v0.17.1...v0.17.2