Skip to content

Releases: longbridge/gpui-kit

Release list

v0.6.0

v0.6.0 Latest
Latest

Choose a tag to compare

View all tags
@huacnlee huacnlee released this 03 Sep 14:30
v0.6.0
94a313a
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

GPUI Kit v0.6.0

v0.6.0 is a major expansion of the project since v0.5.0. The project is now GPUI Kit: a layered toolkit for building desktop applications with GPUI. This release introduces an unstyled foundation crate, a single-dependency facade, a scriptable application runtime, a substantially expanded component set, richer text editing and rendering, motion, accessibility, and new developer tooling.

This release note focuses on user-visible additions, improvements, API changes, and deprecations. It intentionally omits fixes made while the new v0.6.0 features were being developed.

GPUI Kit and the new crate architecture

The repository and ecosystem are now named GPUI Kit, and the documentation has moved to gpui-kit.com. GPUI Component remains the styled component layer within the toolkit. (#2927)

The new architecture separates reusable behavior from presentation:

  • gpui-kit is the recommended facade for applications. It re-exports GPUI and the enabled Kit layers, provides application(), init(), and an actions! macro, and keeps matching GPUI dependencies together.
  • gpui-base provides unstyled behavior, state, interaction, and infrastructure primitives. It includes text editing and rich text, selection, dock layout, virtual lists, dialogs, popovers, controls, motion, history, and navigation foundations.
  • gpui-component remains the complete styled UI system and builds on gpui-base.
  • gpui-shell is a new scriptable application runtime that lets a Rust host expose GPUI capabilities to JavaScript. (#2821)
  • gpui-fps adds a real-time FPS and resource HUD, including CPU, memory, GPU, and frame-tail reporting. (#2704)
  • gpui-wry is now the standalone WebView integration crate.

Applications may continue depending directly on gpui-component, or adopt the new facade:

[dependencies]
gpui-kit = "0.6"
use gpui_kit::*;
use gpui_kit::component::Root;

fn main() {
    gpui_kit::application().run(|cx| {
        gpui_kit::init(cx);
        // Open windows and build the application here.
    });
}

New components and application building blocks

The styled component library has grown well beyond the v0.5.0 surface:

  • Application structure: Command palette, NativeMenu, StatusBar, Pagination, Stepper, HoverCard, AlertDialog, FocusTrap, and a redesigned declarative Dialog API.
  • Data entry and display: Combobox, Rating, ProgressCircle, a new lightweight declarative Table, and multi-row headers, cell selection, custom row heights, resizing constraints, and batched export for DataTable.
  • Communication UI: composable Message, MessageScroller, Bubble, Attachment, and Marker components for chat and assistant-style interfaces. (#2832)
  • Loading and feedback: Shimmer, animated progress states, configurable notification placement and width, dismiss callbacks, and optional OS notification-center delivery.
  • Navigation: NavStack provides browser-style push, back, and forward navigation with animated transitions. (#2922)

Existing controls received broader composition and interaction APIs, including context menus for sidebar and tree items, async submenus, collapsible sidebar modes, animated tabs and tooltips, programmatic resizable panels, reverse sliders, configurable calendar week starts, accessible labels and control IDs, and drag-and-drop support for list items.

Text editing, rich text, and selection

Text editing is now split into purpose-built controls:

  • Input / InputState for single-line text, masks, validation, and number entry.
  • Textarea / TextareaState for multiline text, rows, soft wrapping, auto-grow, and chat-style submit behavior.
  • Editor / EditorState for code editing, highlighting, line numbers, folding, decorations, diagnostics, search, replacement, and LSP integration. (#2691)

The editor adds transaction-based undo, code folding, inline completions, semantic tokens, document colors, configurable wrapping indent, selection APIs, readonly mode, replace/replace-all actions, and broader syntax highlighting. Tree-sitter language support is now split into per-language Cargo features, so applications can select only the grammars they need.

TextView now lives in gpui-base, with the existing gpui_component::text API retained as a compatibility facade. Rich text gains incremental Markdown parsing, inline and local images, Markdown extensions/plugins, math blocks, table actions and horizontal scrolling, source-preserving copy, link-click handling, multi-click selection, drag auto-scroll, and max_lines. A new SelectableText element participates in window-level selection without requiring a rich-text document. (#2881)

Window-level TextSelection can combine selection across multiple TextView and SelectableText regions, enabling document-like selection and copying across independently rendered elements.

Docking, layout, and scrolling

Docking now has a reusable pure-data layout foundation in gpui-base. It supports serializable tiles, tab groups, split resizing, drag/drop placement reporting, undo/redo, animated drop placeholders, snapping neighboring panel edges, and LayoutChanged events. This makes dock layout state usable independently of the styled dock UI.

Scrolling behavior has been revised for better interoperability between nested scroll containers. Highlights include explicit Scrollable identity, axis locking for trackpad gestures, improved scrollbar visibility transitions, responsive Markdown tables, and width-aware virtual-list measurement.

Motion and visual system

gpui-base::motion introduces a layered animation system with keyframes, timing functions, spring motion, presence transitions, staggered animation, reveal helpers, and interpolation. Components now use spring transitions where targets can change during an active animation. (#2866)

The theme system adds gradient backgrounds, global radius consistency, configurable focus rings, selection and Markdown-table semantic colors, custom primary-button and switch colors, and improved dark-mode syntax highlighting. Form controls, popovers, tabs, sliders, and scrollbars have been visually refined for clearer interaction states.

Charts and visualization

Charts gain:

  • SankeyChart and RadarChart.
  • Candlestick charts.
  • Interactive hover tooltips.
  • Negative bar values and a value axis.
  • Arbitrary fills such as gradients, per-bar corner radii, grid and x-axis options.
  • Pie-chart leader-line labels and Radar-chart element labels.
  • More efficient Sankey topology and deduplicated, value-indexed band scales.

Accessibility and platform integration

Accessibility information is now exposed across the component set, including roles, labels, values, toggle state, and stable control IDs. Buttons and checkboxes support role overrides and presentational roles, while editable controls expose their values to accessibility clients.

Native integration expands with OS-native application and context menus, menu item images, improved Linux client-side decorations, window-manager-aware title-bar controls, notification-center bridging, and an owned raw Wry WebView handle.

Performance and developer experience

  • Large editor documents now use a SumTree-based wrapping cache, incremental foreground parsing, bounded syntax injections, and cheaper rewrapping and outdent paths.
  • Large TextView replacements are parsed off the UI thread, while Markdown blocks are shared instead of cloned each frame.
  • Dock, input, notification, color-picker, chart tooltip, and shell rendering paths avoid redundant work and unnecessary rerenders.
  • The new gpui-fps HUD reports presented frames and process resource use for profiling live applications.
  • The documentation site now includes English and Chinese references for GPUI Base, GPUI Shell, the component library, design guidance, coding guidance, and runnable examples.
  • A distributable GPUI Kit skill bundles the design and coding guides for coding agents.

Breaking API changes and migration

Input, Textarea, and Editor are separate APIs

InputState is now single-line only. Migrate multiline inputs to TextareaState and code editors to EditorState:

- use gpui_component::input::{Input, InputState};
+ use gpui_component::input::{Textarea, TextareaState};

- InputState::new(window, cx).multi_line(true).auto_grow(3, 8)
+ TextareaState::new(window, cx).auto_grow(3, 8)
- InputState::new(window, cx).code_editor("rust")
- Input::new(&state)
+ EditorState::new("rust", window, cx)
+ Editor::new(&state)

Input-only adornments such as prefix, suffix, the mask toggle, and the clear button are not properties of Textarea or Editor; compose those actions around the control instead.

Table names

The former stateful Table is now DataTable. Table names the new declarative table element. (#2075)

- use gpui_component::table::Table;
+ use gpui_component::table::DataTable;

The selector-column option was renamed from row_selector to row_header. (#2366)

Divider is now Separator

The module, types, and DescriptionList method were renamed. (#2335)

``...

Read more

Contributors

duo, stippi, and 92 other contributors
Assets 2
Loading

v0.5.1

v0.5.1

Choose a tag to compare

View all tags
@madcodelife madcodelife released this 05 Feb 11:06
v0.5.1
0f0ab35
  • chore: Fix compilation errors on macOS caused by core-text dependency.
Loading

v0.5.0

v0.5.0

Choose a tag to compare

View all tags
@huacnlee huacnlee released this 08 Dec 03:05
v0.5.0
76424dd

ColorPicker

ContextMenu

Divider

image

Dock

Editor

Screen.Recording.2025-12-06.at.2.47.49.PM.mov
  • editor: Improve scroll to support position at the edge of the editor on click by @huacnlee in #1672
  • editor: Fix cursor direction not resetting after mouseup by @FlyingYu-Z in #1708

Input

image
  • input: Fix resetting highlighting for single line code editor by @zanmato in #1742
  • input: Fix wrong font being used in Input by @zanmato in #1706

List

Menu

  • menu: Use defer to avoid race conditions with click listeners by @zanmato in #1651
  • menu: Add check_side to PopupMenu to support display check at right side by @huacnlee in #1677

Chat

SCR-20251126-puzm image

Scrollbar

Refactor Scrollbar API to easy to use, and tidy scrollbar position in entire of components.

image
  • scrollbar: Remove Scrollbar::uniform_scroll, use Scrollbar::vertical instead by @huacnlee in #1659
  • scrollbar: Manage ScrollbarState in Scrollbar internal by @huacnlee in #1690
  • scrollbar: Introduce overflow_scrollbar to adds Scrollbars to elements by @huacnlee in #1694

Setting

Screen.Recording.2025-11-20.at.17.24.50.mov

Sidebar

Table

  • table: Refactor TableDelegate to easy to access delegate by @huacnlee in #1712
  • table: Add render_header method to support custom table header by @huacnlee in #1746

Tab

  • tab: Allow tab item to fill remaining space by @obito-t in #1654

TextView

  • text_view: Adding optional code block actions to the TextView by @duanebester in #1725
Screenshot 2025-12-01 at 8 38 22 PM

Theme

TitleBar

  • title_bar: Improve Styled support to TitleBar by @huacnlee in #1693
  • title_bar: Fix TitleBar drag area on macOS, and only handle show window menu when it supports by @huacnlee in #1710
  • title_bar: Remove window control bg color in normal mode by @huacnlee in #1720

Webview

Others

Full Changelog: v0.4.2...v0.5.0

Contributors

huacnlee, zanmato, and 6 other contributors
Loading

v0.4.2

v0.4.2

Choose a tag to compare

View all tags
@huacnlee huacnlee released this 27 Nov 02:14
v0.4.2
70b413c

Contributors

huacnlee, zanmato, and 2 other contributors
Loading

v0.4.1

v0.4.1

Choose a tag to compare

View all tags
@huacnlee huacnlee released this 20 Nov 09:34
v0.4.1
0a24925

Button

  • button: Add dropdown_caret option to show a caret icon to end of button. by @huacnlee in #1637

Chart

Dock

  • dock: Don't close tab via action when it can't be closed via context menu by @CherryWorm in #1581
  • dock: Add a way for Panels to track the tab bar they belong to by @CherryWorm in #1580

DropdownButton

  • dropdown_button: Add more button option methods to DropdownButton. by @huacnlee in #1633

Editor

  • editor: Fix may crash on render indent guides. by @huacnlee in #1619

Icon

Input

List

Menu

Notification

  • notification: Fix close animation not working when closed from content by @Moulberry in #1578

NumberInput

Resizable

  • resizable: Improve to avoid panels from improperly resizing on container resizing. by @CherryWorm in #1560

Resizable & Dock

  • resizable, dock: Improve Panel adjust size logic on layout changed. by @CherryWorm in #1588

Root

  • root: Improve new method argument to use into <AnyView>. by @huacnlee in #1594

Select

  • select: Add render prop to customize item title display. by @obito-t in #1638

Sidebar

  • sidebar: Improve Sidebar to allows caret icon to expand submenu. by @huacnlee in #1642
  • sidebar: Add to support disable state to sidebar item. by @adriano-tumino in #1645

Slider

Table

Theme

Tiles

  • tiles: Add auto-snap support for tiles panel to top and left edges by @ihavecoke in #1577

New Contributors

Full Changelog: v0.4.0...v0.4.1

Contributors

huacnlee, zanmato, and 8 other contributors
Loading

v0.4.0

v0.4.0

Choose a tag to compare

View all tags
@huacnlee huacnlee released this 17 Nov 02:09
v0.4.0
3975a75

Break Change

In this version we have make a lot of breaking changes to improve the overall API consistency and usability.

If you are upgrading from v0.3.x, please check the changelog carefully and adjust your code accordingly,
the PR links are provided for more details of each change.

  • breadcrumb: Rename item to child and add children method. by @huacnlee in #1519
  • clipboard: Removed content method from Clipboard. by @huacnlee in #1520
  • dialog: Rename Modal to Dialog. by @huacnlee in #1538
  • form: Renamed column to columns. by @huacnlee in #1522
  • form: Rename FormField to Field. by @huacnlee in #1539
  • input, select, date_picker: Refactor cleanable to have argument and default to false. by @Moulberry in #1506
  • list, table: Refactor List, Table to have ListState, TableState. by @huacnlee in #1468
  • notification: Add &mut Self to content and action method. by @huacnlee in #1569
  • radio: Rename on_change to on_click for RadioGroup. by @huacnlee in #1517
  • resizable: Simplify Resizable API. by @huacnlee in #1459
  • select, list: Update searchable default to false. by @huacnlee in #1504
  • sheet: Rename Drawer to Sheet. by @huacnlee in #1527
  • spinner: Rename Indicator to Spinner. by @huacnlee in #1526
  • tab: Refactor creation to use builder pattern by @madcodelife in #1553
  • table: Change context_menu method in TableDelegate to mutable window and cx. by @huacnlee in #1487
  • toggle: Refactor Toggle, ToggleGroup API. by @huacnlee in #1515

What's New

Assets

Button

Chart

Collapsible

ContextMenu

  • context_menu: Fix ContextMenu to cover parent element area. by @huacnlee in #1566

Input & Editor

Field

Label

  • label: Fix Label highlight may crash of not a char boundary. by @huacnlee in #1574

List

  • list: Fix incorrect next selection when select index is none by @madcodelife in #1498
  • list: Add searchable, search_placeholder option to List and Select. by @huacnlee in #1503
  • list: Avoid select item when selectable(false). by @huacnlee in #1508

Menu

  • menu: Add item and export PopupMenuItem with builder methods to PopupMenu. by @huacnlee in #1445
  • menu: Fix #1545 Popover change broken submenu click in dropdown menu. by @huacnlee in #1563

Modal

  • modal, drawer: Block background interaction when Modal, Drawer is active. by @FlyingYu-Z in #1483
  • modal: Adjust close button position. by @huacnlee in #1532

NumberInput

Popover

Progress

Select

Slider

Tab

  • tab: Use on_click instead of action for TabBar dropdown menu. by @huacnlee in #1454

Table

Theme

  • theme: Export more theme options for schema. by @huacnlee in #1442
  • theme: Allows to use alpha color for active_border but at least 0.3. by @obito-t in #1531

Tiles

  • tiles: Add tile_radius theme option and default 0px. by @huacnlee in #1441
  • tiles: Add scrollbar_show option to Tiles by @ihavecoke in #1496
  • tiles: Add to support panel auto-snap while drag movement by @ihavecoke in #1552

WebView

  • webview: Add inspector feature to enable WebView developer tools by @ihavecoke in #1564

Other Changes

New Contributors

Full Changelog: v0.3.1...v0.4.0

Contributors

huacnlee, gurjeet, and 8 other contributors
Loading

v0.3.1

v0.3.1

Choose a tag to compare

View all tags
@madcodelife madcodelife released this 27 Oct 06:10
v0.3.1
183d177

What's Changed

Input

  • input: Fix may flash scroll when move cursor in auto grow mode. by @huacnlee in #1419

Editor

List

  • list: Use click events instead of mouse events when confirming by @madcodelife in #1427

Tiles

  • tiles: Ensure to response correct panel on drag or resize. by @huacnlee in #1422

Theme

  • theme: Update scrollbar background color to transparent for all themes. by @Copilot in #1421

Example

  • example: Add missed control icon assets by @iainlau in #1424
  • example: Fix title bar paddings for window_title example. by @huacnlee in #1429

Others

New Contributors

Full Changelog: v0.3.0...v0.3.1

Contributors

huacnlee, iainlau, and madcodelife
Loading

v0.3.0

v0.3.0

Choose a tag to compare

View all tags
@huacnlee huacnlee released this 24 Oct 02:52
v0.3.0
251d4b8

New features

Button

Checkbox

Dropdown

  • dropdown: Use display_title for item title if present by @stippi in #1410

Editor

Highlighter

  • highlighter: Make SyntaxHighlighter::styles method public for external use by @huacnlee in #1415

Input

  • input: impl Selectable for TextInput that allow it as trigger for popover by @richerfu in #1353
  • input: Fix set_value when Input is disabled by @huacnlee in #1362
  • input: Grouping input history to avoid IME placeholder by @huacnlee in #1375
  • input: Fix Input panics when masked have non-ASCII characters by @huacnlee in #1382
  • input: Stop propagation on scroll wheel by @huacnlee in #1406
  • input: Hide scrollbar when not overflow in auto grow mode by @huacnlee in #1407
  • input: Fix Input to prepare text wrapper by @huacnlee in #1417

Markdown

  • markdown: Use list for Markdown render and add scrollbar by @huacnlee in #1357

Menu

  • menu: Fix submenu item selection when multiple submenus exist by @ihavecoke in #1342
  • menu: Fix trigger action with context by @huacnlee in #1372

Plot

Scrollbar

  • scrollbar: Fix scroll to show mode by @huacnlee in #1381
  • scrollbar: Update scrollbar background color to transparent for all themes by @huacnlee #1421

VirtualList

  • virtual_list: Fix VirtualList to limit only allow 1 direction scrollable by @huacnlee in #1386
  • virtual_list: Fix VirtualList by measure item to get correct content_size to avoid scroll overflow by @huacnlee in #1388

Docs

Documentation website is online: https://longbridge.github.io/gpui-component

Others

New Contributors

Contributors

huacnlee, stippi, and 7 other contributors
Loading

v0.2.0

v0.2.0

Choose a tag to compare

View all tags
@huacnlee huacnlee released this 09 Oct 07:23
v0.2.0
ca9d5b7

🚀 First release version to crates.io.

Improvements

Input & Text

Editor

TextView & Highlight

  • Refactor TextView/SyntaxHighlighter with async parsing to improve performance by @sunli829 (#1299)
  • Support custom code block style by @huacnlee (#1288)

Theme & Style

Menu & Context

Bug Fixes

Chores & Internal

New Contributors

Full Changelog: v20250925...v0.2.0

Contributors

huacnlee, xudesheng, and 4 other contributors
Loading