# Changelog ## [Unreleased] - Add `core.Input.InputSource` and `KeepInputSource`, which select a keyboard input source, such as `com.apple.keylayout.ABC` for English, while a text field has the focus, and select `base.Command`'s each time its field takes the focus, so a palette kept mounted can be opened again. - Document what linking `tsx` costs in binary size, about 20 MB on the desktops, and why: its reflective method lookups and goja's turn off the linker's dead method elimination (#839 by @houko). - Add `Scope.Store`, the graph's `core.Store`, which a host passes to another root's `RootOptions.Storage` so a plugin run on a root of its own keeps its `Storage` on the device with the app's (#837 by @houko). - Register `url_schemes` on Windows and Linux too, in the NSIS installer, the MSIX package and the desktop entry the Linux packages carry, and hand their links to `desktop.OnOpenLinks`, at launch and from a second launch to the running app; `nsgotest.App.OpenLinks` delivers one in a test (#262 by @houko). - Round a subtree reaching past 2^14 pixels again when it moves by whole pixels, as `float32` edges that far out can land on another pixel, so a DataTable of a million rows no longer fails `CheckCommits` on HarmonyOS (#809 by @houko). - Show a pushed page's title in tvOS's navigation bar in the header's color, and size a large title's header as the bar, since tvOS draws no large titles, so it leaves no empty band (#816 by @houko). - Add `tsx.View.Export` and `View.Props`, which render a component a package exports in place of the root its entry mounts, so one signed package provides several views, each with state of its own and under the same capabilities, and fail with `tsx.ErrNoViewExport` or `tsx.ErrViewExportNotComponent` instead of a blank view (#883 by @houko). - Add `-widgets-profile` and `-clip-profile` to override iOS extension provisioning profiles from the command line (#879 by @houko). - Add `datatable.DataTable.CellTooltip`, a body cell's tooltip that shows once the pointer rests on the cell, describes the cell to screen readers and takes its look from `Styles.CellTooltip`, since what `RenderCell` draws takes no pointer and a `ui.Tooltip` there never showed (#820 by @houko). - Fail a target test whose screenshot a device's log dropped or cut part of, which `App.Screenshot` now checks by the PNG's length and CRC-32, instead of writing a corrupt PNG (#810 by @houko). - Add `tsx.Limits.Memory`, off by default and `memory=` in `-limits`, which stops a sandboxed TSX bundle before `ArrayBuffer`, the typed arrays, `repeat`, `padStart`, `padEnd`, `Array.from`, `join`, `fill`, array copies, `apply`'s argument lists or `JSON.stringify` allocate past it, counting what they made until it is collected and reading the sizes they allocate by once, so that a getter or a proxy cannot change them, so one oversized allocation of theirs no longer ends the app; copies, concatenations, spreads and `replace` are not counted, so it does not hold a bundle written to exhaust memory (#760 by @houko). - Add `ui.Select.OptionsFunc`, options that follow signals and update the open list in place, keeping the field's value and focus (#848 by @houko). - Deliver `nsgotest.App.PickImages` answers to the app under `nsgo test -target` macos, windows and linux, in place of the system's picker, as headless tests already do (#866 by @houko). - Remove the CSS providers of a Linux app window's inputs from the display when the window closes, instead of keeping them for the rest of the process (#859 by @houko). - Add `WebView.InjectedJavaScriptBeforeContentFunc`, a pre-content script that follows a signal: when it changes, the web view loads its source again with the new script instead of having to be recreated (#840 by @houko). - Update Windows `ImageSource.Pixels` frames in their existing Direct2D bitmap when their size is unchanged, avoiding a bitmap allocation for every frame (#863 by @houko). - Write a `PrivacyInfo.xcprivacy` into every Apple app, widget extension, App Clip, Apple Watch app and dynamic `-embed` framework, declaring the required-reason APIs NSGo and Go's runtime use, with `apple.privacy` and a manifest in `resources/` adding the app's own (#746 by @houko). - Have `tsx.Load` return `tsx.ErrNoTree` for a scope without a view tree instead of panicking with a nil pointer, and document that it runs synchronously on the caller's goroutine (#838 by @houko). - Add the `--nsgo-os` launch flag, `?nsgo-os=ios` in a page's query, which runs a web build as macOS, Windows, Linux, iOS or Android: the app reads that OS and its idiom, and `core.Env.Simulated` reports that the platform's native parts are absent, so `NavHeader` and the drawn tab bar stand in for the system's, there is no application menu or native popup menu (`desktop.PopupMenu`) while drawn menus such as `ui.ContextMenu` and `ui.Menu` still work, and `mobile.IsAvailable` and `desktop.IsAvailable` are false. - Reload WeChat DevTools' mini program project through `cli close` and `cli auto` after each build, so `nsgo build -run` and `nsgo dev` compile and show fresh files (#844 by @houko). - Export `pkg.SignDocument` and `Signed.Open` for app-owned JSON documents signed in isolated `app:` contexts (#868 by @houko). - Keep Android and HarmonyOS target test installs under a `.nsgotest` bundle identity and remove them after each run, leaving the app's installed build in place (#812 by @houko). - Add `WebView.Mobile`, TSX's `mobile`, which shows a page as a phone sees it on Windows, macOS and Linux, with mouse drags and wheel or trackpad swipes reaching it as touches, so YouTube's Shorts switch videos with a vertical swipe (#806 by @houko). - Add `icon.android`, an adaptive Android launcher icon of a foreground and a background layer, with a `monochrome` layer for Android 13's themed icons, in APKs and App Bundles (#747 by @houko). - Add `nsgotest.App.SetWindowEnvironment`, which changes one window's environment apart from the app's other windows, so a test can put the main window in the background while another window shows, and have the Minimize, Zoom and Toggle Full Screen roles change only the main window, as the desktops do (#783 by @houko). - Add `examples/gallery-miniprogram`, the gallery for mini programs: buttons, text fields, toggles, a slider, badges, avatars, images, a list, layout, tabs, a navigation stack and the platform's alerts, clipboard and storage, on `base` in `ui`'s look and within the platforms' 2 MB package. - Add the device's hinge state and angle to `Env.Geometry` itself (`State`, `Angle`, `HasAngle`), set on iOS 27.1 from `UIHingeInteraction` and on Android from the fold's state, so a screen opened flat or a cover display while closed says how far the device is open without an obstruction to carry it (#822 by @houko). - Build the gallery for HarmonyOS too, with its own tab bar and without the Shader and DataTable demos the preview cannot draw yet, and send a HarmonyOS test's press to what shows under the point rather than to a row scrolled out of view beneath it (#805 by @houko). - Take the frames of what an alert's answer starts in `nsgotest`'s `Answer` and `App.OnAlert`, as every other step does, so a sheet closed from an alert's callback is gone once `Answer` returns instead of staying until the test advances the clock (#782 by @houko). - Report a malformed SVG string in a TSX `icon` prop once, naming the parse error, instead of silently drawing nothing (#594 by @dhruv1220). - Route Linux application-menu Close and Quit roles through the owning window and app teardown (#768 by @houko). - Stop committing an iOS 27.1 surface's reserved regions read in the previous display's or orientation's coordinate space just after it changes size, which split the iPhone Duo's outer display or reserved a rectangle on its inner one as it opened and closed, and read them again once the change settles (#823 by @houko). - Send an iOS rotation's or display switch's safe area and traits with the size they go with, instead of ahead of it, so an app no longer sees one orientation's or display's safe area at the other's size where UIKit changes both before it lays the view out, as on the iPhone Duo's close (#824 by @houko). - Bound backtracking regular expressions in sandboxed TSX calls by their time budget (#759 by @houko). - Match headless menu shortcut spelling precedence with Windows and Linux (#769 by @houko). - Show a navigation stack's pages' `Header` in mini programs, which took the phone's OS for one that draws a system header and showed neither a title nor back; `core.Env.Simulated` reports true there. - Make headless `App.Menu`, `Key` and `ChooseMenu` in a macOS environment use the application menu a surface sent last, as the menu bar and `YieldsToMenu` bindings do (#709 by @houko). - Add keyed `core.PresenceOf` with bounded leaving branches for animated value changes (#786 by @houko). - Let TSX packages carry opaque signed metadata in `pkg.Contents.Extra` (#761 by @houko). - Have an app under `nsgo test -target macos` open its windows as `nsgo.Run` does without an `Environment` option, so a window it opens with `desktop.OpenWindow` hears the main window's keys through `KeyOptions.AllSurfaces`, and have steps act on its main window, which opens at the desktop's default 480 by 640 points without `nsgotest.Size` and shows a root view too, so `desktop.CurrentWindow` and `OnClosing` work there; closing it asks `OnClosing`, and a quit the app asks for counts in `App.Quits` instead of ending the test's process (#763, #771 by @houko). - Lay the gallery out for Apple Watch, as a list of the demos a watch can show, and for Apple TV, as a sidebar the remote's focus moves through, each leaving out the demos the device cannot use (#803 by @houko). - Apply watchOS animated values after each commit, so controls whose initial state is bound to a non-running animated value show that state on their first frame (#815 by @houko). - Measure a watchOS scroll view's offset from where its content rests, so one that starts near the top of the screen, below a header, rests at zero instead of minus its distance from the top, and presses reach the row under the finger rather than one that far above it (#814 by @houko). - Draw `ui.NavPage`'s `NavHeader`, back button included, and `ui.TabShell`'s tab bar on watchOS, and show `ui.SwitchSystem` as ui's own switch there, where the watch, which reports iOS, took iOS's system header, tab bar and switch and showed none (#813 by @houko). - Leave a camera cutout inside the safe area's insets to the safe area on iOS 27.1, instead of reporting it in `Env.Geometry` as an occluding obstruction with a reserved rectangle, as the iPhone Duo's outer display did (#821 by @houko). - Wait for the gallery's web page to report its button before its trusted-input test clicks it, so macOS tests do not race page loading (#753). - Show the simulator's window in `nsgo run`, `nsgo dev` and `nsgo test` on Xcode 27, which replaced Simulator with DeviceHub: open the app by its bundle ID, DeviceHub's first and Simulator's on older Xcode, and warn when neither opens instead of ignoring it (#826 by @houko). - Fix a `YieldsToMenu` binding losing its key on Windows and Linux to an application-menu item those menus leave out, one of macOS's own roles or a Speech item where nothing speaks (#770 by @houko). - Keep the gallery's pages, page headers, sidebar and content pane clear of the left and right safe area, such as the vertical status bar beside a foldable's outer display and an iPhone's camera in landscape (#825 by @houko). - Glide Android scroll views with OverScroller's spline fling, as Android's own scroll views do (#833 by @owocc). - Keep the code and message of what a TSX plugin's synchronous export throws in `Plugin.Call`'s error, as a rejected promise's, instead of the raw exception (#847 by @houko). - Draw a Linux input with no font family in the desktop's UI font, as a text is, instead of GTK's fallback "Sans 10": reading `gtk-font-name` at startup left GTK's default font stale, so an input and a text of the same style drew one string at different widths. An editor's style also no longer reaches another window's editor that has the same node id (#764 by @houko). - Keep what `ui.SidebarShell`'s sidebar, footer, headers and content hold and `ui.NavHeader`'s buttons clear of the left and right safe area, as on an iPhone in landscape, without padding a page inside the shell twice, and drop the gallery's own padding for it (#835 by @houko). - Have `nsgotest` count a press of another view as a new click on the macOS and Linux targets, as headless, so a press on a page that a press just pushed or popped reaches it instead of going to the page's previous view as a double click's second (#854 by @houko). ## [0.2.0] - 2026-11-19 - Add HarmonyOS as a preview target, whose ArkTS host runs the engine in ArkWeb and draws it with ArkUI views, in `nsgo build`, `nsgo run` and `nsgo test -target harmonyos` (#79 by @togotop). - Add in-app purchases on macOS, iOS and tvOS through StoreKit 2: the store's products and prices, purchases answering cancelled and pending apart from failed with the signed transaction, updates made outside the app, finishing, current entitlements and restoring, in Go, TSX and `nsgotest`, when `nsgo.yaml` sets `apple.purchases` (#353 by @houko). - Add `desktop.SetWindowWorkspaces` and `WindowOptions.Workspaces`, which keep a window on every Space and over other apps' full screen spaces on macOS, at any level but the desktop's, which stays behind them, and on every virtual desktop on X11, with `desktop.CanSetWindowWorkspaces`, which says whether it takes effect (#572 by @houko). - Add transparent desktop windows without a frame, shadow or taskbar button, as `WindowOptions.Transparent`, `NoShadow` and `SkipTaskbar`, the main window's `nsgo.WindowTransparent`, `WindowNoShadow` and `SkipTaskbar`, and `desktop.SetWindowTransparent`, `SetWindowShadow` and `SetSkipTaskbar`, on macOS, Windows and Linux, with `desktop.CanMakeWindowsTransparent` and `CanSkipTaskbar` saying where they take effect (#567 by @houko). - Add `PanelOptions.Transparent`, a panel with no background, frame or shadow of its own whose content draws its corners and shadow, and `PanelOptions.FitContent`, a panel sized to its content before it first shows and as it changes, on macOS, Windows and Linux, with `desktop.Transparent` saying whether a transparent panel or window draws nothing of its own now (#315 by @houko). - Add `SidebarShell.Fixed`, a sidebar the user cannot resize. - Add `desktop.SetWindowPointerEvents`, with `WindowOptions.PointerEvents` and `PanelOptions.PointerEvents`, which lets the pointer through a window to the windows below it everywhere or wherever it draws nothing, on macOS, Windows and Linux (#568 by @houko). - Add `desktop.FrontmostApp`, the application in front on the desktop with its ID, name, process ID and full screen, tracked as other apps come to the front, on macOS, Windows and X11, and `desktop.CanReadFrontmostApp`, which says where it is followed; both are held to `core.AccessFrontmostApp` and set in tests through `nsgotest.Environment` (#570 by @houko). - Add `ImageSource.Pixels` and `Version`, which show an `image.RGBA` the app draws in an `Image` or a `Canvas` with its alpha, no load events and no fade, swapped in place without encoding on Apple platforms, Windows and Linux (#107 by @houko). - Add `Scope.SetWebCookies`, which writes cookies, HttpOnly ones included, to the persistent store the app's web views share on Apple platforms, Windows, Linux and Android, so they can carry the sign-in of the user's own browser (#387 by @houko). - Add `desktop.CanSetWindowLevel` and `desktop.CanPlaceWindows`, and keep a floating window above the others on Linux under X11, so a Wayland app can tell that its window is neither stacked nor placed (#573 by @houko). - Add `WebView.PinchZoom`, `Ref.Load` and the platform's `Domain` and `Code` on `WebError`; on Windows, Ctrl with the wheel or with + and - zooms a web view only with `PinchZoom` (#233 by @houko). - Add `core.ScrollEvent.Stale`, TSX's `stale`, which marks a report from before the platform applied a scroll from code, and `terminal.View.HideIndicator`, which hides its scroll bar (#692 by @houko). - Add `chat.Composer.AutoFocus`, which focuses the editor as the composer mounts. - Add `chat.QuotaRow.Pace`, which marks on a limit's bar in `chat.Quota` and `chat.QuotaSummary` what would remain had it been used evenly, so a fill short of the mark runs out before it resets. - Add `ContentWidth` to `chat.Conversation` and `chat.FloatingConversation`, which centers the transcript and the floating composer in at most that width, and fill the conversation without it, replacing the fixed 720 pt `chat.ContentWidth` (#719). - Report `Video.OnError` instead of an opaque picture for a local video whose alpha the platform cannot keep: WebM with alpha on macOS and iOS, any clip with alpha on Windows until Media Foundation's alpha output is checked, and on Linux HEVC with alpha, or VP8 and VP9 with alpha without GStreamer's codecalpha plug-in; add `MediaError.Reason`, `MediaErrorAlphaUnsupported` for these, so an app can fall back to its own decoder without matching the message (#569 by @houko). - Give a `Select`'s and a `DatePicker`'s field the height, padding and type their `Style` sets, as an `Input`'s, instead of only the view around it, so a small one lines up with a `SizeSmall` button (#721 by @Session500). - Stop reporting a web view load that was stopped, replaced or turned into a download to `OnError` on Apple platforms and Windows (#233 by @houko). - Keep a view's own outer shadows and outline outside its `Overflow: Hidden` clip on Apple for views, images and macOS scroll views, as CSS does (#238 by @houko). - Lay out and draw a Windows window at each size as a drag resizes it, as macOS does, instead of stretching the last frame to the window. - Show `chat.FloatingConversation`'s bottom edge blur only while a composer is shown, so a transcript without one ends sharp. - Keep a `base/terminal` view following output that comes faster than frames instead of leaving the end, and follow it again once scrolled back to the end (#686). - Keep a multiline `Input`'s scroll bar along its edges on macOS and iOS, its padding insetting the text, which scrolls under it (#701). - Keep a scroll view still as a text selection starts in it on macOS, rather than scrolling it toward where the last drag ended or the window's corner. - Open the output directory with `nsgo build -open` when nsgo leads its terminal's session, as in an app's terminal without a shell, instead of losing the opener as nsgo exits (#672). - Show a bundled macOS app's Dock badge without the notification permission until the app uses notifications (#190 by @houko). - Accept a bare OS name in `nsgo check -target`, `nsgo build -target` and `nsgo.yaml`'s `build.targets`, and an arch-qualified name in `nsgo test -target`, so the commands take each other's target spellings (#593 by @dhruv1220). - Keep an engine fault's `CheckCommits` re-panic ahead of its exit notification, so fault-isolation tests cannot mistake the notification for a swallowed panic (#703). - Accept CRLF checkouts of generated catalogs without reporting them as out of date (#726). - Let macOS editing role items with `OnSelect` follow the focused editor's enabled state (#724). - Target Android runtime manifests at API 36 by default and warn when release builds override it below Google Play's requirement (#748). - Share Go compile workers across concurrent `nsgo build` targets instead of oversubscribing the CPU (#725). - Stop canvases and shaders on Apple platforms and the web from drawing an earlier image for an image's inline `Data` once the earlier buffer was freed and its address reused, by keeping a cached image's bytes alive (#715, #737, #751). - Localize the separator between Android TalkBack's state parts with the app's language, including Chinese punctuation (#704). - Keep a toast's title, description, leading view and action current when showing a replacement with the same ID, and have the screen reader read the replacement (#749). ## [0.1.0] - 2026-11-16 NSGo 0.1.0 is the first release of a cross-platform native UI framework in Go, porting NSH's design: write an app once, in Go or TSX, and it runs on phones, tablets, TVs, watches, desktops and the web in each platform's own views. Its API is not stable yet. - **Every platform from one Mac.** Build for macOS, iOS with App Clips, tvOS, watchOS, Windows, Linux, Android and the web with only Go and Xcode, and for WeChat, QQ, Alipay and Douyin mini programs experimentally. - **Native views.** Text, input methods, scrolling, menus and accessibility are each platform's own, and what one platform has, such as Liquid Glass, the others imitate. - **Fine-grained updates.** Signals update only what reads them, through flexbox and grid layout, CSS-like styles, Tailwind classes, themes and animations on the platform's frame clock. - **Components.** `base` offers unstyled components from buttons to a million-row `DataTable`, charts, flow diagrams, a code editor, a rich-text editor and a terminal, and `ui` gives them NSGo's look. - **Platform services.** Use navigation, notifications, permissions, pickers, sharing, haptics, widgets and Live Activities, and on desktops windows, panels, menus, tray icons and global shortcuts. - **TSX apps.** Write apps in TSX as NSH does, with hot updates that keep state, and ship them as signed, sandboxed packages a Go app runs. - **Localized and embeddable.** Translate with YAML catalogs, CLDR plurals and right-to-left layout, and embed NSGo in iOS, Android, Go desktop and web apps. - **The `nsgo` tool.** Create apps, run them with hot reload and DevTools, test them with `nsgotest`, and package them for app stores, Flathub and direct downloads with updates. - **Small and fast.** A counter app packs to about 8 MB on the desktops and starts faster than NSH, MyGo and GPUI in NSGo's benchmarks. Thanks to everyone who shaped this release with code, reports and ideas: @houko, @daodao97, @Heyana, @ayuayue, @henry-wm, @Jungley8, @togotop, @westhiker, @Laotree, @OfficialDiLi, @happyhaha1, @roamlog, @yangjuncode, @pdenapo and @monkeyWie.