Repository navigation
Changelog
This release covers changes since 0.0.36.
Breaking changes
- Router attachment is now renderer-specific.
Router.attachWindowListeners(window)has been removed. Browser apps should importattachRouterfromretend-weband callattachRouter(router, window); GPUI apps should importattachRouterfromretend-gpuiand callattachRouter(router, useWindow()). Both return a cleanup function. The core router now exposesrouter.sync(path)for adopting a host URL without writing it back to history (3df152d, 4e38450). - GPUI navigation no longer imitates the browser. The window option
locationhas been replaced byinitialPath, which sets the starting route and does not change afterward.window.host.location,window.host.history, and the host's synthetic history events are gone. Use the router to navigate, andattachRouterto loadinitialPathand keep route titles in sync with the native window title (4e38450, c9da01d). - GPUI resource events use
GpuiResourceEventinstead ofGpuiImageEvent. Update imports or annotations for imageload/errorhandlers. The new class also covers audioendedanderrorevents (5edb2a1).
GPUI: native controls and media
- Added a non-visual
<audio>element for local audio files and imported assets. It supports reactivesrc,autoPlay,loop,mutedandvolumeprops;play()/pause()methods; andended/errorevents. Audio decoding and playback run off the UI thread. Remote streams are not supported (5edb2a1). - Added OS-native editing context menus for
inputandtextareaon macOS and Windows, including Cut, Copy, Paste and Select All. macOS also integrates system spelling suggestions and supported Writing Tools. RegisteringonContextMenulets an application replace the default menu (f41238d). - Added
useWindow().showMenu({ position, items })for native popup menus on macOS and Windows. Menus support labeled actions, disabled items and separators; the promise resolves to the selected action ID ornullwhen dismissed. Linux popup menus are not yet supported (48291dc). - Ordinary rendered text can now be selected with the mouse and copied with the platform's keyboard shortcut. Use
style.userSelect: 'text' | 'none'to control selection in a subtree. A selection is currently limited to one contiguous rendered text run, not multiple block elements (0839134).
GPUI: windows, input and styling
- Added
useSystem()with reactive OSthemeandaccentColorCells, anduseWindow().orientationas a reactiveportrait/landscapeCell. macOS applications can position the traffic-light controls withsystem.trafficLightPosition(ef840ce). - Added
onWheelandGpuiWheelEventfor raw wheel and trackpad input, including deltas, pointer position, modifier keys and available touch phases. UnlikeonScroll, this fires without requiring a scroll container; it does not cancel native scrolling (ec54b36). - Added
cursorandpointerEventsstyles for native pointer behavior, plusstyle.placeholder.colorforinputandtextareaplaceholders (00d6b27, f41238d). - Root-relative image paths such as
/logo.pngnow resolve against Vite'spublicDirin development. Packaged applications include those public assets in their resources (6c916fb).
Router and server rendering
- Routes containing only
pathandredirectcan now match without a component or children (489841f). - Browser navigation now updates the document title when traversing history with the back and forward buttons, not just during direct navigation (dcd4d3f).
- Separated browser history and title synchronization into
retend-web; removed the server virtual DOM's browser-likelocationandhistorymachinery. Updated Vite static-site generation module loading and route metadata handling (3df152d, c9da01d, 980623e).
DevTools
- Added an Open component definition action to the inspector. The Retend Vite plugin now records component source locations so DevTools can open the selected component in the editor during development (8e51498).
- Fixed the DevTools panel disappearing after hot module replacement, and improved component-tree scrolling, panel spacing and inspector actions, including screenshot copying feedback (897d44a, d6e55f8, ab1892c).
Oxlint plugin
- Added
jsx-props-orderto the recommended rule set. It orders JSX attributes asref/key, regular props,class, event handlers and function props, thenstyle. A spread attribute restarts ordering for subsequent attributes (fcf8648).
Scaffolding and documentation
- GPUI projects generated by
retend-startnow useattachRouterand includevite/clienttypes. When project docs are requested, the scaffold includes a local GPUI reference for elements, styling, windows and events (4e38450, 980623e). - Rebuilt the documentation landing page, added dedicated GPUI reference pages, and revised the existing guides and visual components (a3a6aef, 4b6d743, e64c621).
Releases
- Added a version-driven GitHub Actions release workflow. When the package version changes on
mainandAUTO_RELEASE_ENABLEDis set, CI verifies the changes, builds five native addon targets, packages and publishes the eight workspace packages and five native packages through npm Trusted Publishing, then creates a GitHub release using the versioned changelog and native artifacts. Publishing can resume after a partial failure without republishing existing npm versions (f10152a, d2451b1).