gui_toolkit: releases

gui_toolkit 0.119.0

2026-11-09T00:00:00Z

Added

Web addresses in plain text become links: ui.rich_links(text, style, &runs) turns a string into rich runs whose http:// and https:// addresses are links in the theme's link colour, underlined, without the sentence's closing marks around them (ui.web_address_len).

gui_toolkit 0.118.0

2026-11-09T00:00:00Z

Added

Automatic partial redraw: ui.set_partial_redraw (or Host.partial_redraw in host) redraws only the boxes whose drawing changed since the last frame, with no rectangle marked by hand; an idle frame redraws nothing, a caret blink or a hover a small rectangle, custom draws included. Underneath, draw.damage_auto with draw.damage_span_begin / damage_span_end compares a digest of what each span draws (draw.Damage_Memory, damage_volatile, damage_whole, ui.damage_stats); render.texture_version and render.damage_building are new, and a frame with a region is whole when the clear colour, blend space, text or corner settings change. Toolkit.metrics (DevTools) reports it: the partial frames, why the others were whole, and the share of pixels drawn.

gui_toolkit 0.117.0

2026-11-09T00:00:00Z

Added

The machined finish (Finish.Machined): bevelled buttons that sink when pressed, fields and segmented tracks as sunken wells with a ring of the accent when focused, separators as carved grooves (box flags .Sunken, .Groove); flat on a light palette. Its primitives for a program's own surfaces: machined_bevel, machined_well, machined_groove, machined_plate, machined_lamp, machined_pip (each draws its flat form outside the finish); Theme.glow sets its halos. It draws up to MACHINED_OVERFLOW_PX outside a box: a region redrawn alone must hold that margin. fidget: a Machined finish switch (Ctrl+M).

Changed

Themes replace the named palettes: ui.THEMES (25 themes, most with a dark and a light version: opencode native's and the toolkit's), Theme_Def, Theme_Colors, theme_palette, theme_palettes, palette_of, theme_find; theme_show applies a theme, a mode (system, dark, light) and a finish, and follows the system; theme_recolor moves a program's own colours to the theme shown; themes_read reads a user's themes. NAMED_PALETTES, palette_named and the PALETTE_* constants are gone: palette_of("Midnight"), palette_of("Midnight", light = true) for Daylight. Palette.well: the colour of sunken surfaces. See docs/themes.md.

gui_toolkit 0.116.0

2026-11-09T00:00:00Z

Added

desktop.handlers_for_file, desktop.open_with: "Open with": the applications the system knows for a type of file, the default first, and a file opened with one of them (Linux: shared-mime-info, desktop entries, mimeapps.list; Windows: the shell's handlers). Also desktop.exec_arguments, desktop.exec_expand and platform.launch_detached (Linux).

gui_toolkit 0.114.2

2026-11-09T00:00:00Z

Fixed

A window never shown is in no task bar (Wayland): open_window makes a surface with no role, and the toplevel is made at the first show_window. A program that starts hidden in the notification area was listed in the task bars that show every toplevel (ShojiWM). set_maximized and set_fullscreen asked before the first show are asked by the new toplevel.

gui_toolkit 0.115.0

2026-11-09T00:00:00Z

Fixed

The wheel goes to the box that scrolls its way: a box that scrolls only sideways (.View_Scroll_X, a wide table) no longer takes an up-and-down wheel from the page around it, and Shift+wheel scrolls such a box sideways, as in a browser. A box that scrolls itself still gets the wheel as it is (a number field steps further with Shift).

gui_toolkit 0.114.1

2026-11-09T00:00:00Z

Fixed

The tests of the toolbox build on Windows again: the test of start_group is Linux's only (#+build linux: a file name that ends in _test gives Odin no system). The test of a host at rest counts its wakes: an event of the desktop may end one wait, a wait that does not sleep wakes hundreds of times.
platform.wait_event (Wayland): less than a millisecond left is a millisecond of sleep. It returned at once, and a loop that waits until a deadline spun through its last millisecond (about 150 wakes).

gui_toolkit 0.114.0

2026-11-09T00:00:00Z

Added

ui.field_frame, the box flag .Focus_Within, the theme tag bare: one surface for a field and what goes with it (an icon, a count), with one focus ring around all of it while a box inside has the focus. A field built under bare draws no background, border or focus ring of its own: no box inside a box, no square ring inside round corners.

gui_toolkit 0.113.0

2026-11-09T00:00:00Z

Added

toolbox.start_group, toolbox.stop_group (Linux): a command in a process group of its own, stopped with all it started (a wrapper such as NixOS's sway leaves its real program running when only the wrapper is stopped). tk desktop_tests uses them.

gui_toolkit 0.112.0

2026-11-09T00:00:00Z

Added

platform.raise_window (Wayland): asks the focus through xdg_activation_v1, with the seat's last input serial. It did nothing before. A program shown by a shortcut of the compositor now gets the keyboard on compositors that do not focus a new window by themselves.

gui_toolkit 0.111.3

2026-11-09T00:00:00Z

Fixed

Tray (Linux): GetAll of the StatusNotifierItem includes IconPixmap. Panels that read the properties in one call (Quickshell, Waybar) showed the "missing icon" pattern.

gui_toolkit 0.111.2

2026-11-09T00:00:00Z

Fixed

Wayland: a wait sleeps through the renderer's own traffic: the presentation feedback and the FIFO events of the frame just shown, and the ids of the renderer's callbacks, made the connection readable at each refresh, and every wait ended there: a window at rest drew a frame at each refresh. A wait now ends on what is the window's (its input, a repaint asked for), a change of the clipboard, a wake, a bus or the time. tests/linux_desktop checks that a wait at rest sleeps its time.

gui_toolkit 0.111.1

2026-11-09T00:00:00Z

Fixed

Linux: the loop sleeps at rest again: the system's repaint request (a configure, an expose) stayed set, so every hosts_wait ended at once and a window drew frames for ever (60 a second; a core for a hidden one). host_frame now takes the request (its frame answers it), and a hidden window's request ends no wait. tests/linux_desktop checks that no frame is due at rest.

gui_toolkit 0.111.0

2026-11-09T00:00:00Z

Added

desktop: the Autostart part: the program starts with the user's session (Options.autostart, with autostart_arguments: --hidden for a program of the notification area). Linux: an XDG autostart entry ($XDG_CONFIG_HOME/autostart/<slug>.desktop, autostart_dir, <prefix>AUTOSTART_DIR); Windows: the value of the key under HKCU\...\CurrentVersion\Run. Status, repair when the arguments change, removal of only what is the program's.

gui_toolkit 0.110.0

2026-11-09T00:00:00Z

Added

host.host_hide, host.host_show: a window with its renderer off the screen and back, the renderer's surface released first (render.surface_drop) and made again at the first frame after the show (render.surface_remake(r, handles), which now takes the window's native handles). tk desktop_tests builds its tests with the native text backend and tests a host's hide and show with its renderer.

Fixed

Wayland: a window shown again after hide_window no longer ends the connection (must ack the initial configure before attaching buffer): the hide destroys the surface with its role, since the last frames' content updates could wait behind a FIFO barrier of wp_fifo_v1 that an unmapped surface never clears, and the new role's first commit with them.

gui_toolkit 0.109.0

2026-11-09T00:00:00Z

Added

platform.hide_window: a shown window off the screen and back with show_window in a few milliseconds, its interface kept (a program in the notification area): Wayland (the toplevel role made again, its first configure waited for), X11 (withdrawn), Windows (SW_HIDE). Window.shown_again counts the shows after a hide; host_frame then makes a new swap chain (render.surface_remake), which Vulkan's FIFO on Wayland would otherwise wait on for good.

gui_toolkit 0.108.0

2026-11-09T00:00:00Z

Added

platform.needs_frame_outline: a window with an integrated title bar and no frame of the system's (Linux: no server-side decorations, not tiled, no X11 frame extents; neither maximized nor full screen) gets a 1-pixel outline in the theme's border colour, drawn by ui.

Fixed

An integrated title bar on Linux works as a frame: a press on the caption moves the window (Wayland xdg_toplevel.move, X11 _NET_WM_MOVERESIZE), the bands along its four sides resize it (with the resize cursor over them), a double click on the caption maximizes or restores it, and a right click there opens the compositor's window menu. Nothing of that happened: the window could not be moved. The window menu now gets the press's serial and the surface's coordinates.

gui_toolkit 0.107.0

2026-11-09T00:00:00Z

Added

png package: the one PNG codec of the toolkit. png.encode(rgba, width, height, .Small | .Fast) writes straight RGBA8 as a PNG file (.Small: the filter of least sum per row and flate.deflate; .Fast: Sub and flate.deflate_runs), png.decode reads any PNG (every colour type, bit depth, palette, tRNS; 16 bits rounded to 8) as straight RGBA8, png.rgba8_of converts any core:image picture. platform.clipboard_image_decode(mime, bytes) reads a PNG, JPEG or BMP file, platform.clipboard_pick_mime(offered, wanted) picks the type to read of another program's offer.

Changed

One PNG codec everywhere: paint.png_encode / png_decode, cdp.png_encode / png_decode, the screenshots of devtools, testkit/session's pictures, the CBDT emoji of font and the Windows clipboard use the png package. devtools.png_encode is removed: png.encode(rgba, w, h, .Fast) writes the same file. The Windows clipboard no longer links vendor:stb/image, and platform.png_encode writes at .Fast (a 1400 x 925 picture in 2 ms rather than 90).

Removed

platform.png_encode_hook and platform.png_decode_hook: the toolkit has its own PNG codec on every system (platform.png_encode / png_decode), so an application has nothing to set.

Fixed

Linux: pasting another program's image or files: platform.clipboard_get_image read nothing unless the application had set a PNG hook, so an image copied by a screenshot tool, a browser's Copy image or wl-copy --type image/png did not paste. It is read now on Wayland and X11 through the toolkit's PNG codec, and an offer of image/jpeg or image/bmp alone is read too; clipboard_formats says .Image for them. clipboard_get_files also reads GNOME Files' x-special/gnome-copied-files when there is no text/uri-list. The tray's PNG icon is decoded the same way.
tk desktop_tests leaves no compositor running: a server it starts (and the test program) runs in a process group of its own, and is stopped with its whole group, also on a failure, a time limit or a signal to tk. A wrapper such as NixOS's sway (dbus-run-session, which runs sway and a session bus beside it) took the signal alone and left sway, swaybg and the bus running, holding the command's output open. Their output goes to files now, the test program's printed when it ends. a_lost_server_closes_its_windows stops its second server with its children, so the window hears the compositor go.

gui_toolkit 0.106.0

2026-11-08T00:00:00Z

Added

Content that fades out at its edges: draw.mask_edge_fade draws the mask of a push_mask that fades the content to transparent over given widths at the left, top, right and bottom edges; ui.next({edge_fade = ...}) gives it to a box that clips, so that a list that scrolls fades out where it goes on instead of ending in a straight cut.

gui_toolkit 0.105.0

2026-11-08T00:00:00Z

Added

platform.can_hide_windows: whether a window can exist unseen, made and never shown. Yes on Windows; no on Wayland and X11, where a toplevel is shown as soon as it has a buffer: a program that needs an unseen window opens an offscreen one there.

Fixed

Variable faces off Windows: font.axes reads a face's axes from its fvar table, and font.with_variations makes an instance the native backend opens at its location (a simulation of it keeps it). Both did nothing there, so a variable font was drawn at its default instance: a web font in font-weight: 400 whose default is 300 came out light.

gui_toolkit 0.104.1

2026-11-08T00:00:00Z

Fixed

Docs tables on a phone, on every site: the rule that keeps a table's columns wide enough is in the documentation's own style sheet (docs_css), not only in DOCS_CODE_CSS; Wren's docs, whose site has its own table styles, squeezed them still.

gui_toolkit 0.104.0

2026-11-08T00:00:00Z

Added

site.Meta.changelog_page and version_anchor: where a site tells a version (the feed's links, llms.txt), for a site whose changelog is another page or whose anchors are written otherwise (Wren's changelog/#v0-7-0).

Fixed

Docs tables on a phone: each column keeps room for its text (26 characters, at most 70 % of the screen) and the table scrolls sideways in its frame. The columns were squeezed to one word a line.

gui_toolkit 0.103.0

2026-11-08T00:00:00Z

Added

site.build_docs: a documentation site from a project's Markdown: a page per document in the site's header and footer, a menu from docs/_nav.txt (folded under a "Documentation" toggle on a phone, no script), a search with no server, collapsible groups, a breadcrumb, the previous and next pages, "On this page", the old addresses sent on. site.check_links checks a built site's links without a browser; site.check also checks the documentation pages at 390 px. Wren's documentation generator moved here; the toolkit's Docs section uses it.

Changed

site.render_markdown replaces markdown_html: one converter (Wren's, which reads more: blockquotes, HTML blocks, aligned tables, autolinks, titles, heading anchors, unique ids), with coloured code blocks (site.write_code_block, site.Code_Language), the headings and the plain text of a document. A | in a code span no longer splits a table cell, two trailing spaces are a hard break, and a title keeps a _ inside a word.

gui_toolkit 0.102.0

2026-11-08T00:00:00Z

Added

toolbox package (tk_toolbox, [docs/toolbox.md](docs/toolbox.md)): what the tools of a project share. run (the output shown or appended to a log; a working directory, an environment, a time limit, echo), capture (the standard output and the exit code, the standard error shown on failure), env_with, exit_code and succeeded (a Windows exit code read as the program's signed 32-bit code), sha256_hex and sha256_file, download_pinned (curl with retries, GitHub's API when a release download fails, a file whose SHA-256 is wrong removed), download_through_api, release_asset_id and system_program. tools/tk uses it; its own copies of these procedures are gone.
paint package (tk_paint, [docs/paint.md](docs/paint.md)): a vector rasterizer on the CPU for pictures made ahead of time, pure Odin and deterministic: an RGBA canvas with a transform, paths (lines, quadratic and cubic Béziers, arcs, rounded rectangles, ellipses, polygons), fill (non-zero, even-odd) and stroke / widen (width, miter, bevel and round joins, flat, square and round caps) with antialiasing, solid colours and linear / radial gradients that pad or repeat, set_clip, draw_canvas / resize (cubic for downscaling, nearest for magnifying), png_encode / png_decode, ico_encode with PNG or DIB entries (dib_encode). tk make_logo and tk make_icon draw with it on Windows and Linux; GDI+ and tools/tk/gdiplus_windows.odin are gone.
desktop package (tk_desktop, [docs/desktop.md](docs/desktop.md)): the integration of a program with the user's desktop (Start menu and desktop shortcuts, the PATH with a console launcher, the freedesktop.org entry and icons, a link in ~/.local/bin, and for a browser its registration and URL schemes), its watcher, its command line, and the installed copy (manifest, Settings > Apps record, uninstall, NixOS runtime). Every name and mark is a field of the program's Identity; every place is an injectable root. Moved from Wren and made generic. process package (tk_process, [docs/process.md](docs/process.md)): command_line_args (UTF-8 on Windows), console_write / console_error (a Windows program with a window writes to its parent's console), executable_path, parent_dir.
tk site_docs: the documents of docs/ as a "Docs" section of the website, with its own Markdown to HTML converter (tools/tk/site_docs.odin). The Pages workflow runs it.
cdp and site packages (src/cdp, src/site): a client of the DevTools protocol for tools (a window or a browser, input, waits, pictures, screencasts, scripts, timelines compared with another run) and the steps of a project website (CHANGELOG.md to a changelog page, news and classic pages, what a page says when shared, Markdown to HTML, the pages checked in a real browser), generic: opencode native uses both. docs/cdp.md, docs/site.md.

Changed

The Node tools are tk commands: tk cdp (was tools/cdp.mjs), tk screenshots, tk theme_shots, tk timeline_test (was tests/e2e/timeline.mjs), tk doc_check (same flags: --root, --extra), tk site_build, site_changelog, site_meta, site_card, site_check. The CI and the Pages workflow run only Odin; Node is no longer needed.

Fixed

tk site_check checks the site as it is published (the Docs pages and the 404 too) and waits for what each step leads to instead of fixed delays (opencode native's check, now shared): the old check hung when the viewer did not open. tk theme_shots reads the palettes from src/ui/theme_default.odin (tools/theme_shots.mjs still read ui/, gone since the packages moved to src/).

gui_toolkit 0.101.0

2026-11-08T00:00:00Z

Changed

The library's packages are in src/ (src/ui, src/platform...): a program's collection points there (-collection:gt=<toolkit>/src), and the examples, tests, tools and docs apart from it. Every step is a command of tools/tk, on Windows and Linux: build (an example; build.bat and ./build.sh are its shortcuts), ci (what tools/linux_ci.sh did), desktop_tests (what tools/linux_desktop.sh did, its fake xdg-open an Odin program), build_text on Linux too. The scripts are gone. flake.nix: the development shell on Linux (the pinned Odin with wgpu-native, Rust, the virtual desktops' servers).

gui_toolkit 0.100.0

2026-11-08T00:00:00Z

Added

config.Search: the search of a settings UI made of pages (search_begin, search_page, search_shows, searching): which preferences a query shows (every word in the name, the title or the description; a page whose title matches shows all of it) and each page's heading before its first match. The UI keeps its own layout.

gui_toolkit 0.99.0

2026-11-08T00:00:00Z

Added

update (package tk_update): signed updates of a program, from Wren and opencode native. A Product (name, signing context, public key) checks what a release publishes: one manifest per platform and channel (manifest_name, channels optional), signed with Ed25519, for a strictly newer version and the release's own file name (check_release). place puts the downloaded program in place of the running one after its size and SHA-256 (Windows: renamed aside, put back on failure; Linux: renamed over), remove_leftovers cleans up at the next start, and manifest_of, manifest_bytes and sign are the release tool's side. [docs/update.md](docs/update.md).
platform.set_app_id: the program's id on the Linux desktop, the name of its .desktop file: Wayland's app_id and X11's WM_CLASS (which windows on X11 had none of). By default the executable's file name, where every window said "gui_toolkit", so a task bar could not find the program's icon and name.

Changed

tk release publishes a version on Windows or Linux (tools/tk), in place of tools/release.ps1, which is gone: the CHANGELOG section and the version, the commit, the annotated tag, the push and the GitHub release. The About picture is taken again on Windows only.

Fixed

System fonts on Linux take fontconfig's aliases and generic families: font.load_system and font.has_system_family give "Courier New" the installed font the configuration binds to it (Liberation Mono, by 30-metric-aliases.conf), and monospace, serif, sans-serif and the other generic families the font fontconfig picks. They refused any answer whose family was not the one asked for, so such a name was missing and text fell to the next font.

gui_toolkit 0.98.3

2026-11-08T00:00:00Z

Fixed

tools/tk's pinned downloads (wgpu-native, DXC, the emoji font) try again, and a file of a GitHub release whose download fails comes through GitHub's API (with GH_TOKEN or GITHUB_TOKEN when set), checked against its SHA-256 as before: GitHub's release downloads answered 504 for over an hour while its API served the same files, and a CI fetching wgpu-native failed. The tool's own tests run in run_tests (tk_tool).

gui_toolkit 0.98.2

2026-11-08T00:00:00Z

Fixed

platform.custom_cursor_info on Linux says the size and hotspot of the cursor as it is shown, the image at the scale it is shown at (scale, or the window's: custom_cursor_scale), as on Windows; it said those of the source image whatever the scale. The scaling is shared with the pixels made for X and Wayland (custom_cursor_geometry).

gui_toolkit 0.98.1

2026-11-07T00:00:00Z

Fixed

A lazy column lets its view move by less than a pixel: the item the view is on was kept in its place by its rect, rounded to whole pixels; that error, read as a move of the content, put a view moving by less than a pixel a frame (a slow glide, the wheel's click just past its dead zone) back where it was every few frames, and it did not move. Its place is now read where the layout put it, not rounded.