pulsar
EN

Changelog

All notable changes to this project are documented here. The format follows Keep a Changelog and the project uses Semantic Versioning.

[Unreleased]

[1.2.3] - 2026-11-02

Fixed

  • pulsar build --target android works after a Pulsar upgrade: a CMake build cache generated by another version is cleared instead of failing on a source tree mismatch.
  • Desktop toolchains and built apps bundle the QtMultimedia QML module, the multimedia plugins and the TLS/network-information plugins. Windows now scans the host QML imports with windeployqt, so in-app video and wss:// WebSockets work from release builds.
  • The Android Qt bundle ships qtmultimedia. An older bundle is detected and replaced on pulsar install --android or the first Android build.
  • Release packaging fails when the staged toolchain misses a QML module or the multimedia plugins used by the host.

[1.2.2] - 2026-11-02

Fixed

  • The Linux Qt bundle includes the libraries QML modules link to (libQt6QuickControls2Impl, libQt6QuickLayouts, libQt6QuickEffects and the rest), so Qt Quick Controls plugins no longer load system copies and fail with a Qt version mismatch. pulsar run and pulsar build work again from the released toolchain.
  • The CLI archive ships CMakeLists.txt, host/, bridge/, launcher/ and android/, so pulsar build --target android works from an installed release instead of failing on a missing CMakeLists.txt.

[1.2.1] - 2026-11-02

Fixed

  • Built-in Catppuccin theme tokens (mauve, text, subtext, surface and the rest) are typed by default, so EmptyState and other SDK defaults typecheck in apps that do not augment ThemeColors.
  • pulsar update verifies SHA256SUMS, accepts --version <v>, and relinks the current app's node_modules/pulsar to the new SDK. Apps created by newer CLIs link through $PULSAR_HOME/current, so they follow later updates.

[1.2.0] - 2026-11-02

Added

  • Responsive shell: createBreakpoints(app) plus window width/height as window-resize (desktop and Android rotation/split screen), NavBar, NavigationRail (with a padding gutter), Container (maxWidth), maxWidth/align on layout nodes and Grid with columns: "auto".
  • Column and Row now honour padding as an outer gutter.
  • Components: Avatar (initials/status/badge), Badge (count or dot pill, and a badge prop on icons/buttons/avatars), Skeleton, Spinner, BottomSheet, EmptyState, Toolbar, Fab, Menu, Accordion, Segmented, SearchField, RangeSlider, Radio/RadioGroup, Tabs, Pager, Snackbar and Popover.
  • Elevation and shadows render through MultiEffect; panels support gradients, border colours and rounded corners.
  • Neon glow on any component (neon: true or NeonOptions) with MultiEffect, now on Android too. effects: false keeps a plain outline and software rendering falls back to it automatically.
  • Grid and virtualised list primitives: auto columns, end-reached paging, pull-to-refresh, multi-select, sticky sections, swipe actions and drag reorder.
  • Gestures and layers: long press, tooltips, pinch zoom, pager and overlays.
  • Rich text and input: TextArea, password fields, keyboard hints, submit/focus callbacks, autofocus, max length, read-only, selectable text, markdown, elide, alignment and max lines.
  • Screen router (createRouter) with a navigation stack and system back handling.
  • Host-backed media player: playlists, play/pause/seek/rate/volume, state/position/duration events, and an Android foreground service with MediaSession and lockscreen controls.
  • Clipboard, OS share, Android orientation lock and keep-awake, and accessibility labels on common nodes.
  • Runtime OS permissions (permissions.request/check) with osPermissions in pulsar.json mapped into the Android manifest.
  • fs.watch and net.download with progress and Range resume.
  • Android notification channels and tap routing; shared text and opened files arrive as app events.
  • Native macOS menu bar from app.setMenu([...]): nested menus, separators, shortcuts and checkable items; choosing an item emits menu with its id. Linux and Windows ignore the call for now.
  • Desktop power monitor: system.power() returns the power source, battery state and percentage; power-suspend, power-resume and power-source events fire on sleep and on AC/battery changes. Linux uses logind and UPower over D-Bus with a sysfs fallback; other platforms report unknown.
  • notify.show takes actions: [{ id, title }]; a button press emits notification-action with the token and id. Uses the freedesktop notification daemon on Linux (D-Bus); other platforms show the plain body.
  • Desktop video playback in a built-in full-screen player: fs.open on a video file plays it in-app when QtMultimedia is available instead of handing it to the OS. The release toolchains now bundle QtMultimedia. Tap or Space pauses, Escape or the close button exits, with a seek bar and timer.
  • Theme work: Catppuccin Frappe/Latte presets, Paper Mono and Material Symbols, typed named/CSS colours and custom theme tokens, theme overrides, density and font scale, motion tokens and transparent frameless windows.
  • Sheet / Modal take dismissible (default true) and duration (fade time in ms, default 140). dismissible: false keeps the overlay open on a backdrop tap.

Changed

  • Store.set is a no-op when the new value is deeply equal to the current one (same JSON), so polling sync loops no longer re-render unchanged lists.
  • The neon effect is drawn with MultiEffect instead of a custom shader.
  • Controls default to the neutral Qt Quick Controls Basic style before the theme styles them.

Fixed

  • Page scroll now moves its content: the wrapper is parented to the Flickable contentItem instead of the Flickable itself.
  • A VirtualList scrolls its own rows again; row swipe gestures are limited to the x axis, and a non-interactive list passes drags to the page.
  • Column/row and navigation rail padding is applied to the first and last visible children, so content stays off card and window edges.
  • Neon on Android renders a real glow again; the outline fallback anchors to the right item and the demo stacks it vertically on a phone.
  • The switch thumb no longer lags when turning on.
  • Taps inside a sheet panel no longer fall through to the backdrop and close the overlay, and the tap that opened a sheet no longer closes it.
  • Sheets fade in and out on opacity instead of scaling, which is cheaper for large trees on mobile.
  • Text width/elide, grid column stretching, virtual-list row opacity and input backgrounds are corrected.
  • Desktop file dialogs on Linux use the Qt dialog instead of the platform theme's native one, so the picker lists files under a KDE theme outside Plasma instead of failing with Unknown protocol "file".
  • Builds honour the app's root .gitignore and a new manifest ignore list, and always skip .env* and sync.db*, so secrets and local databases no longer end up in executables, APKs or the Android dev payload.

Docs

  • README (English and Russian) covers the responsive shell, the new components, breakpoints, navigation rail padding and neon.

Tests

  • Unit tests for fs.open, fs.exportTo, dialog.toast and the __export-result reply; media and fs.watch tests are isolated from the global permission gate.

[1.1.0] - 2026-11-01

Added

  • net.websocket(url, options?) for ws:// and wss:// connections: open, message, close and error events, text and binary messages, subprotocols, custom headers and a connect timeout. It runs in the native host on Qt WebSockets and needs the net permission.
  • Qt WebSockets is now a build dependency; release toolchains and Android Qt bundles ship it.
  • JS UI kit for QML-free apps: card, appBar, list, scroll, icon, iconButton, chip, sheet, progress and select, a light/dark theme and the Material Icons font. Re-renders now reconcile existing QML objects instead of rebuilding the tree, preserving focus and scroll.
  • QML-like TypeScript components: bind, For, When, defineComponent and web-named components (Column, Row, Card, Header, Input, Checkbox, Modal, ...). Children are variadic; the existing ui.* factories stay compatible.
  • pulsar create now scaffolds the TypeScript template by default. The QML starter moved to --template qml; --template js is an alias for the default.
  • Android dev loop: pulsar dev --android builds a dev APK once, serves the bundle over adb reverse and reloads the app in 1–2 s. Native inputs (host C++, manifest, CMake, app id) are fingerprinted, so the APK is rebuilt and reinstalled only when they change.
  • Device control from the CLI while the dev loop runs: ui, state, tap, type, expect, shot, swipe, key and eval, coordinate input with --at, and ui --system for system dialogs.
  • A flow-test API (cli/testing.ts) for driving a running dev app with tap, type, expect, state and shot from a Bun script.
  • In-process reload (pulsar reload): the QuickJS context is recreated and the store is seeded from the previous session, so JS edits apply in about 200 ms without restarting the app.
  • A dev error overlay with a Reload button; stack frames are mapped back to the TypeScript sources in the terminal and in the overlay via inline source maps.

Changed

  • For / List render a scrollable column instead of a ListView for now, so rows keep correct hit areas on Android. Row paths stay keyed; virtualization returns later.

Fixed

  • TypeScript UI windows now render on Android: the embedded host bundles PulsarView, applies __ui trees to the window and exposes the bridge as a context property.
  • Android text input and checkbox taps now reach the app store (textChanged plus a tap overlay), so typing, toggling and adding tasks work on device.
  • Store.set stores the new value before notifying listeners, so a UI render triggered by a change sees the updated state instead of the previous one.
  • Checkboxes and switches no longer emit toggle when their checked state is set programmatically, which could otherwise loop through the app store.

[1.0.1] - 2026-10-31

Added

  • pulsar doctor warns when the active toolchain version differs from the CLI version, with the command that fixes it.

Docs

  • README (English and Russian) now covers fs.open, fs.exportTo and dialog.toast, including where exported files land on desktop and Android.

Tests

  • Unit tests for fs.open, fs.exportTo, dialog.toast and the __export-result reply, using a mock transport.

[1.0.0] - 2026-10-31

First stable release. The documented API is considered stable; the gaps listed below are planned for 1.1.

Platforms

  • Linux x64 and ARM64, macOS Intel and Apple Silicon, Windows x64 and ARM64 ship a CLI, a fat toolchain with bundled Qt, and a slim toolchain without it.
  • Android arm64-v8a builds a signed APK (minSdk 28, targetSdk 35).
  • Linux ARM64 and Windows ARM64 are built and packaged in CI but have not been run on real hardware yet. iOS is not supported.

Added

  • Single-file desktop apps: a Qt-free launcher embeds the runtime and the Qt host into one executable.
  • UI from JavaScript: ui.column/row/box/text/button/... renders a window without QML, re-rendering when the Store changes.
  • Embedded QuickJS harness on the desktop (qml-host-qjs).
  • Network in the native host: net.fetch and streaming net.request with timeout, redirects and abort.
  • OS integration: single instance with second-instance, deep links and open files (open-url, open-file), file associations, recent documents, secure storage backed by the OS keychain, and manifest permissions enforced on every capability.
  • System surface: notifications, screens, theme, locale, tray, dialogs and the full fs capability set.
  • Android: in-process QuickJS and QML, lifecycle events (app-pause, app-resume, app-stop, back-pressed), native HTTP with binary streaming, and pulsar install --android to provision JDK, SDK, NDK and Qt.
  • Attachments: the multi-file SAF picker and fs.exportTo to the device Downloads on Android, fs.open and dialog.toast on both platforms, and fs.exportTo/fs.open on the desktop.
  • Portable runtime target with an import audit (pulsar check --target android|portable).

Fixed

  • Android: the keyboard now opens on the first tap on Samsung and Android 16; the packaged Qt bundle carries the patched input delegate.

Known gaps

  • No WebSocket in net.
  • The JS-rendered UI rebuilds the whole tree on every change.
  • Installed apps do not update themselves; pulsar update only updates the CLI.
  • Notification action buttons, a desktop power monitor and a native macOS menu bar are not implemented.
  • Android x86_64 (emulators) is not packaged.

[0.2.0] - 2026-10-24

Added

  • Android support: pulsar build --target android, the APK toolchain bootstrap and the published Qt for Android bundles for Linux and macOS hosts.
  • An engine-neutral core with the portable target.
  • Published Qt for Android bundle made relocatable and self-contained.

[0.1.3] - 2026-10-15

Added

  • Releases for Linux, macOS and Windows with per-platform Qt packaging.
  • Bootstrap installers for shell and PowerShell.

[0.1.0] - 2026-10-14

First public builds: Linux release, self-contained Qt runtime and the single-file layout.

Edit on GitHub