[JEWEL] IJPL-176416 Compose icon infrastructure

build/bazel-generated-file-list.txt

@@ -477,6 +477,7 @@ platform/jbr
 platform/jewel/decorated-window
 platform/jewel/detekt-plugin
 platform/jewel/foundation
+platform/jewel/icons
 platform/jewel/ide-laf-bridge
 platform/jewel/int-ui/int-ui-decorated-window
 platform/jewel/int-ui/int-ui-standalone

platform/build-scripts/src/org/jetbrains/intellij/build/impl/PlatformModules.kt

@@ -219,6 +219,7 @@ internal suspend fun createPlatformLayout(projectLibrariesUsedByPlugins: SortedS
     "intellij.platform.util.classLoader",
     "intellij.platform.util.zip",
     "intellij.platform.boot",
+    "intellij.platform.icons.api",
     "intellij.platform.runtime.repository",
     "intellij.platform.runtime.loader",
   ), productLayout = productLayout, layout = layout)

platform/core-ui/BUILD.bazel

@@ -10,8 +10,9 @@ jvm_library(
     "//platform/util",
     "//platform/core-api:core",
     "//platform/util:util-ui",
-    "@lib//:kotlin-stdlib",
     "@lib//:hash4j",
+    "@lib//:kotlin-stdlib",
+    "//platform/jewel/icons",
   ]
 )
 ### auto-generated section `build intellij.platform.core.ui` end

platform/core-ui/intellij.platform.core.ui.iml

@@ -10,7 +10,8 @@
     <orderEntry type="module" module-name="intellij.platform.util" />
     <orderEntry type="module" module-name="intellij.platform.core" />
     <orderEntry type="module" module-name="intellij.platform.util.ui" />
-    <orderEntry type="library" name="kotlin-stdlib" level="project" />
     <orderEntry type="library" name="hash4j" level="project" />
+    <orderEntry type="library" name="kotlin-stdlib" level="project" />
+    <orderEntry type="module" module-name="intellij.platform.icons.api" />
   </component>
 </module>

platform/core-ui/src/ui/DeferredIcon.java

@@ -1,12 +1,13 @@
 // Copyright 2000-2020 JetBrains s.r.o. Use of this source code is governed by the Apache 2.0 license that can be found in the LICENSE file.
 package com.intellij.ui;
 
+import org.jetbrains.icons.api.DynamicIcon;
 import com.intellij.ui.icons.UpdatableIcon;
 import org.jetbrains.annotations.NotNull;
 
 import javax.swing.*;
 
-public interface DeferredIcon extends UpdatableIcon {
+public interface DeferredIcon extends UpdatableIcon, DynamicIcon {
   @NotNull Icon evaluate();
 
   @NotNull Icon getBaseIcon();

platform/core-ui/src/ui/icons/IconWithOverlay.java

@@ -9,6 +9,7 @@
 import org.jetbrains.annotations.NotNull;
 import org.jetbrains.annotations.Nullable;
 
+import javax.swing.Icon;
 import javax.swing.*;
 import java.awt.*;
 import java.awt.image.BufferedImage;
@@ -17,7 +18,7 @@
  * @author Konstantin Bulenkov
  */
 public abstract class IconWithOverlay extends LayeredIcon {
-  public IconWithOverlay(@NotNull Icon main, @NotNull Icon overlay) {
+  public IconWithOverlay(@NotNull javax.swing.Icon main, @NotNull javax.swing.Icon overlay) {
     super(main, overlay);
   }
 

platform/core-ui/src/ui/icons/IconWrapperWithToolTipComposite.java

@@ -6,6 +6,7 @@
 import org.jetbrains.annotations.NotNull;
 import org.jetbrains.annotations.Nullable;
 
+import javax.swing.Icon;
 import javax.swing.*;
 import java.awt.*;
 import java.util.Objects;

platform/core-ui/src/util/IconUtil.kt

@@ -42,6 +42,7 @@ import java.util.*
 import java.util.concurrent.ConcurrentHashMap
 import java.util.function.Supplier
 import java.util.function.ToIntFunction
+import javax.swing.Icon
 import javax.swing.*
 import kotlin.math.abs
 import kotlin.math.max

platform/icons-api/build.gradle.kts

@@ -0,0 +1,18 @@
+// Copyright 2000-2025 JetBrains s.r.o. and contributors. Use of this source code is governed by the Apache 2.0 license.
+import org.jetbrains.compose.ComposeBuildConfig
+
+plugins {
+    jewel
+    `jewel-check-public-api`
+    alias(libs.plugins.composeDesktop)
+    alias(libs.plugins.compose.compiler)
+}
+
+private val composeVersion
+    get() = ComposeBuildConfig.composeVersion
+
+dependencies {
+    api("org.jetbrains.compose.foundation:foundation-desktop:$composeVersion")
+
+    testImplementation(compose.desktop.currentOs) { exclude(group = "org.jetbrains.compose.material") }
+}

platform/icons-api/intellij.platform.icons.api.iml

@@ -0,0 +1,30 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<module type="JAVA_MODULE" version="4">
+  <component name="FacetManager">
+    <facet type="kotlin-language" name="Kotlin">
+      <configuration version="5" platform="JVM 17" allPlatforms="JVM [17]" useProjectSettings="false">
+        <compilerSettings>
+          <option name="additionalArguments" value="-Xjvm-default=all" />
+        </compilerSettings>
+        <compilerArguments>
+          <stringArguments>
+            <stringArg name="jvmTarget" arg="17" />
+            <stringArg name="apiVersion" arg="2.2" />
+            <stringArg name="languageVersion" arg="2.2" />
+          </stringArguments>
+        </compilerArguments>
+      </configuration>
+    </facet>
+  </component>
+  <component name="NewModuleRootManager" inherit-compiler-output="true">
+    <exclude-output />
+    <content url="file://$MODULE_DIR$">
+      <sourceFolder url="file://$MODULE_DIR$/src/main/resources" type="java-resource" />
+      <sourceFolder url="file://$MODULE_DIR$/src/main/kotlin" isTestSource="false" />
+    </content>
+    <orderEntry type="library" name="kotlin-stdlib" level="project" />
+    <orderEntry type="library" name="kotlinx-coroutines-core" level="project" />
+    <orderEntry type="sourceFolder" forTests="false" />
+    <orderEntry type="inheritedJdk" />
+  </component>
+</module>

platform/icons-api/src/main/kotlin/org/jetbrains/icons/api/DynamicIcon.kt

@@ -0,0 +1,8 @@
+// Copyright 2000-2025 JetBrains s.r.o. and contributors. Use of this source code is governed by the Apache 2.0 license.
+package org.jetbrains.icons.api
+
+import kotlinx.coroutines.flow.StateFlow
+
+interface DynamicIcon : Icon {
+  val onUpdate: StateFlow<IconState>
+}

platform/icons-api/src/main/kotlin/org/jetbrains/icons/api/Icon.kt

@@ -0,0 +1,9 @@
+// Copyright 2000-2025 JetBrains s.r.o. and contributors. Use of this source code is governed by the Apache 2.0 license.
+package org.jetbrains.icons.api
+
+interface Icon {
+  val identifier: IconIdentifier
+  val state: IconState
+
+  fun render(api: PaintingApi)
+}

platform/icons-api/src/main/kotlin/org/jetbrains/icons/api/IconManager.kt

@@ -0,0 +1,9 @@
+// Copyright 2000-2025 JetBrains s.r.o. and contributors. Use of this source code is governed by the Apache 2.0 license.
+package org.jetbrains.icons.api
+
+interface IconManager {
+  fun loadIcon(id: IconIdentifier, path: String, aClass: Class<*>): Icon?
+  fun registerIcon(id: IconIdentifier, icon: Icon)
+}
+
+interface IconIdentifier

platform/icons-api/src/main/kotlin/org/jetbrains/icons/api/IconState.kt

@@ -0,0 +1,6 @@
+// Copyright 2000-2025 JetBrains s.r.o. and contributors. Use of this source code is governed by the Apache 2.0 license.
+package org.jetbrains.icons.api
+
+interface IconState
+
+object DefaultIconState : IconState

platform/icons-api/src/main/kotlin/org/jetbrains/icons/api/ImageResource.kt

@@ -0,0 +1,103 @@
+// Copyright 2000-2025 JetBrains s.r.o. and contributors. Use of this source code is governed by the Apache 2.0 license.
+package org.jetbrains.icons.api
+
+import kotlin.reflect.KClass
+
+interface ImageResourceProvider {
+  companion object {
+    @Volatile
+    private var instance: ImageResourceProvider? = null
+
+    @JvmStatic
+    fun getInstance(): ImageResourceProvider = instance ?: DummyImageResourceProvider
+
+    fun activate(provider: ImageResourceProvider) {
+      instance = provider
+    }
+  }
+}
+
+object DummyImageResourceProvider : ImageResourceProvider
+
+interface ImageResource {
+  companion object
+}
+
+interface ImageResourceWithCrossApiCache {
+  val crossApiCache: CrossApiImageBitmapCache
+}
+
+inline fun <reified TBitmap : Any> CrossApiImageBitmapCache.cachedBitmap(noinline generator: () -> TBitmap): TBitmap =
+  cachedBitmap(TBitmap::class, generator)
+
+interface CrossApiImageBitmapCache {
+  fun <TBitmap : Any> cachedBitmap(bitmapClass: KClass<TBitmap>, generator: () -> TBitmap): TBitmap
+}
+
+interface BitmapImageResource : ImageResource {
+  fun getRGB(x: Int, y: Int): Int
+  fun getRGBOrNull(x: Int, y: Int): Int?
+  val width: Int
+  val height: Int
+}
+
+object EmptyBitmapImageResource : BitmapImageResource {
+  override fun getRGB(x: Int, y: Int): Int = 0
+  override fun getRGBOrNull(x: Int, y: Int): Int? = 0
+  override val width: Int = 0
+  override val height: Int = 0
+}
+
+interface RescalableImageResource : ImageResource {
+  fun scale(scale: ImageScale): BitmapImageResource
+  fun calculateExpectedDimensions(scale: ImageScale): Bounds
+}
+
+sealed interface ImageScale {
+  fun calculateScalingFactorByOriginalDimensions(width: Int, height: Int? = null): Float
+}
+
+class FixedScale(val scale: Float) : ImageScale {
+  override fun calculateScalingFactorByOriginalDimensions(width: Int, height: Int?): Float = scale
+
+  override fun equals(other: Any?): Boolean {
+    if (this === other) return true
+    if (javaClass != other?.javaClass) return false
+
+    other as FixedScale
+
+    return scale == other.scale
+  }
+
+  override fun hashCode(): Int {
+    return scale.hashCode()
+  }
+}
+
+class FitAreaScale(val width: Int, val height: Int) : ImageScale {
+  override fun calculateScalingFactorByOriginalDimensions(width: Int, height: Int?): Float {
+    val scale = this.width / width.toFloat()
+    if (height != null) {
+      return minOf(scale, this.height / height.toFloat())
+    }
+    return scale
+  }
+
+  override fun equals(other: Any?): Boolean {
+    if (this === other) return true
+    if (javaClass != other?.javaClass) return false
+
+    other as FitAreaScale
+
+    if (width != other.width) return false
+    if (height != other.height) return false
+
+    return true
+  }
+
+  override fun hashCode(): Int {
+    var result = width
+    result = 31 * result + height
+    return result
+  }
+}

platform/icons-api/src/main/kotlin/org/jetbrains/icons/api/PaintingApi.kt

@@ -0,0 +1,37 @@
+// Copyright 2000-2025 JetBrains s.r.o. and contributors. Use of this source code is governed by the Apache 2.0 license.
+package org.jetbrains.icons.api
+
+interface PaintingApi {
+  val bounds: Bounds
+  fun drawImage(image: BitmapImageResource, x: Int, y: Int, width: Int? = null, height: Int? = null)
+  fun drawImage(image: RescalableImageResource, x: Int, y: Int, width: Int? = null, height: Int? = null)
+}
+
+class Bounds(
+  val width: Int,
+  val height: Int
+) {
+  override fun equals(other: Any?): Boolean {
+    if (this === other) return true
+    if (javaClass != other?.javaClass) return false
+
+    other as Bounds
+
+    if (width != other.width) return false
+    if (height != other.height) return false
+
+    return true
+  }
+
+  override fun hashCode(): Int {
+    var result = width
+    result = 31 * result + height
+    return result
+  }
+
+  override fun toString(): String {
+    return "Bounds(width=$width, height=$height)"
+  }
+
+  fun canFit(other: Bounds): Boolean = other.width <= width && other.height <= height
+}