Lukas Wirth
5849530017
## Summary Replace GPUI's shared asset futures with owning cache entries. The mutex-backed waiter collection in futures::future::Shared can contend between a worker and the browser main thread, where blocking waits are forbidden. - Keep loading on the background executor, with one foreground task publishing the cached result and notifying interested views. - Deduplicate loads and view registrations; cancel pending work on eviction without allowing completion to update a replacement entry. - Change App::fetch_asset to return Option<A::Output>, remove ImageLoadingTask, and make ImageCacheItem an opaque owning entry. - Migrate the retain-all image cache and image gallery LRU example. Repository-wide search found no further callers requiring migration. Results become visible after the foreground completion task publishes them. Entries expose neither cloneable nor awaitable task handles. Release Notes: - N/A
GPUI Examples
Examples can be run from the Zed repository root:
cargo run -p gpui --example hello_world
Where to start
hello_worldshows the basic shape of a GPUI application: create anApplication, open a window, create a root view, and render adiv.inputdemonstrates text input, focus, selections, clipboard actions, and keyboard bindings.uniform_listshows how to render a simple virtualized list.testingdemonstrates#[gpui::test],TestAppContext, actions, focus, and window-based tests.
Layout and styling
grid_layoutdemonstrates CSS-grid-style layout.opacitydemonstrates opacity styling.patternshows patterned backgrounds.shadowdemonstrates box shadows.textshows styled text rendering.text_layoutdemonstrates text alignment, decoration, weights, and wrapping.text_wrappershows wrapping text content.
Interaction
anchordemonstrates anchored positioning.data_tablecombines virtualized list rendering with table-style rows and a custom scrollbar.drag_dropshows draggable elements and drop targets.focus_visibledemonstrates keyboard-visible focus styling.mouse_pressuredemonstrates pressure-sensitive pointer input where supported.popovershows floating layers withdeferredandanchored.scrollabledemonstrates scrollable content.tab_stopshows keyboard tab navigation.
Images, drawing, and animation
animationdemonstrates GPUI animations and animated SVG transforms.gif_viewershows GIF rendering.gradientdemonstrates linear gradients and color spaces.imageshows local and remote image loading, image sizing, and asset setup.image_gallerydemonstrates image caching and loading remote images.image_loadingshows image loading states and asset loading.paintingdemonstrates custom drawing with paths and canvas.svgshows SVG rendering.
Windows and application behavior
move_entity_between_windowsshows moving an entity between windows.on_window_close_quitdemonstrates quitting when a window closes.set_menusshows application menu setup.system_notificationsdemonstrates posting, replacing, dismissing, and responding to operating-system notifications.windowdemonstrates creating normal, dialog, popup, and floating windows.window_positioningdemonstrates window bounds and placement.window_shadowdemonstrates window shadow styling.
Specialized examples
These examples are useful when working on GPUI itself, but they may not be the best starting point for new applications:
active_state_bugis a focused active-state reproduction.layer_shelldemonstrates Linux layer-shell windows.list_exampledemonstrates bottom-aligned list state and scrollbar behavior.ownership_postsupports the ownership and data-flow documentation.paths_benchis a path rendering benchmark.treerenders a deep tree of nested elements.