Merge branch 'main' into task-get-test-of-consistency-check-running-again

Author: Jenish-1235

.jbang/JabSrvLauncher.java

@@ -65,7 +65,7 @@
 //DEPS info.picocli:picocli:4.7.7
 //DEPS org.postgresql:postgresql:42.7.7
 //DEPS org.bouncycastle:bcprov-jdk18on:1.81
-//DEPS com.konghq:unirest-modules-gson:4.5.0
+//DEPS com.konghq:unirest-modules-gson:4.5.1
 //DEPS jakarta.ws.rs:jakarta.ws.rs-api:4.0.0
 //DEPS org.glassfish.jersey.core:jersey-server:3.1.11
 //DEPS org.glassfish.jersey.inject:jersey-hk2:3.1.11
@@ -77,7 +77,7 @@
 //DEPS org.glassfish.grizzly:grizzly-framework:4.0.2
 //DEPS jakarta.validation:jakarta.validation-api:3.1.1
 //DEPS org.hibernate.validator:hibernate-validator:9.0.1.Final
-//DEPS com.konghq:unirest-modules-gson:4.5.0
+//DEPS com.konghq:unirest-modules-gson:4.5.1
 //DEPS com.google.guava:guava:33.4.8-jre
 //DEPS org.jabref:afterburner.fx:2.0.0
 //DEPS net.harawata:appdirs:1.4.0

CHANGELOG.md

@@ -120,6 +120,7 @@ Note that this project **does not** adhere to [Semantic Versioning](https://semv
 - We fixed an issue where "Copy to" was enabled even if no other library was opened. [#13280](https://github.com/JabRef/jabref/pull/13280)
 - We fixed an issue where the groups were still displayed after closing all libraries. [#13382](https://github.com/JabRef/jabref/issues/13382)
 - Enhanced field selection logic in the Merge Entries dialog when fetching from DOI to prefer valid years and entry types. [#12549](https://github.com/JabRef/jabref/issues/12549)
+- We improved consistency in the Add Buttons. [#13791](https://github.com/JabRef/jabref/pull/13791)
 - We fixed an issue where theme or font size are not respected for all dialogs [#13558](https://github.com/JabRef/jabref/issues/13558)
 - We removed unnecessary spacing and margin in the AutomaticFieldEditor. [#13792](https://github.com/JabRef/jabref/pull/13792)
 

build-logic/build.gradle.kts

@@ -10,7 +10,7 @@ repositories {
 
 dependencies {
     implementation("com.adarshr:gradle-test-logger-plugin:4.0.0")
-    implementation("com.autonomousapps:dependency-analysis-gradle-plugin:3.0.0")
+    implementation("com.autonomousapps:dependency-analysis-gradle-plugin:3.0.1")
     implementation("com.github.andygoossens:gradle-modernizer-plugin:1.11.0")
     implementation("org.gradlex:extra-java-module-info:1.13")
     implementation("org.gradlex:java-module-dependencies:1.9.2")

build.gradle.kts

@@ -1,15 +1,15 @@
 plugins {
     id("org.jabref.gradle.base.repositories")
     id("org.jabref.gradle.feature.compile") // for openrewrite
-    id("org.openrewrite.rewrite") version "7.14.1"
+    id("org.openrewrite.rewrite") version "7.15.0"
     id("org.itsallcode.openfasttrace") version "3.1.0"
 }
 
 // OpenRewrite should rewrite all sources
 // This is the behavior when applied in the root project (https://docs.openrewrite.org/reference/gradle-plugin-configuration#multi-module-gradle-projects)
 
 dependencies {
-    rewrite(platform("org.openrewrite.recipe:rewrite-recipe-bom:3.13.0"))
+    rewrite(platform("org.openrewrite.recipe:rewrite-recipe-bom:3.14.0"))
     rewrite("org.openrewrite.recipe:rewrite-static-analysis")
     rewrite("org.openrewrite.recipe:rewrite-logging-frameworks")
     rewrite("org.openrewrite.recipe:rewrite-testing-frameworks")

docs/code-howtos/walkthrough.md

@@ -0,0 +1,52 @@
+---
+parent: Code Howtos
+---
+
+# Walkthrough
+
+All walkthroughs are written using the internal declarative API (see `org.jabref.gui.walkthrough.declarative`) and are
+defined in the `WalkthroughAction` class. Each walkthrough is a linear series of steps, where each step is either a UI
+highlight (`VisibleComponent`) or an invisible side effect (`WalkthroughSideEffect`). The walkthroughs are built using a
+builder API (`Walkthrough.Builder`). To launch a walkthrough, simply construct a new `WalkthroughAction` and pass the
+name of the desired walkthrough.
+
+The `WalkthroughOverlay` renderer takes the output of the declarative API (`Walkthrough`) and renders it for the user.
+At a high level, a walkthrough primarily highlights GUI elements (nodes in the scene graph).
+
+The following step types are supported:
+
+## Highlights
+
+1. `Ring`: Shows a small, accent-colored circle in the upper-right corner of the node to be highlighted.
+   ![A blue, semi-transparent circle highlighting the "Preferences" button](../images/ring.png)
+2. `Spotlight`: Highlights the node of interest by darkening the rest of the window.
+   ![The "File" menu item highlighted with a spotlight effect](../images/backdrop.png)
+3. `FullScreenDarken`: Darkens the entire window, typically to display a panel in the center.
+   ![The entire application window darkened](../images/fullscreen-darken.png)
+
+## Visual Steps
+
+1. `TooltipStep`: Shows a tooltip next to a specified node. This step must be associated with a node to display
+   correctly.
+   ![A tooltip pointing to "Use Main File Directory"](../images/tooltip.png)
+2. `PanelStep`: Shows a panel with rich text and info boxes on the top, left, bottom, or right of the screen.
+   ![A information panel displayed at the top of the screen.](../images/panel-step.png)
+
+## Side Effects
+
+1. `OpenLibrarySideEffect`: Opens a specified example library.
+2. `EnsureSearchSettingsSideEffect`: Forces a search preference into a desired state.
+
+All walkthroughs are currently launched from the `Walkthroughs` component, which is located exclusively on the
+`WelcomeTab`.
+
+![The "Walkthroughs" section of the Welcome Tab, showing a list of available walkthroughs](../images/walkthroughs.png)
+
+## Quick Settings
+
+Since walkthroughs are only supposed to highlight UI components and guide the user through JabRef, quick settings are
+create so as to provide a convenient entry point for the user to edit the common settings like theme, online services,
+and main file directory. All the quick settings items are present in the `org.jabref.gui.welcome.components.QuickSettings`
+component, which is visible in the `WelcomeTab`.
+
+![The 'Quick Settings' section of the Welcome Tab, showing options for main file directory, theme, online settings, etc](../images/quicksettings.png)