Skip to content

Releases

v0.4.0

Choose a tag to compare

@github-actions github-actions released this 18 Nov 05:30

Full Changelog: v0.3.0...v0.4.0

v0.3.0

Choose a tag to compare

@github-actions github-actions released this 17 Nov 02:14

Skathi 0.3.0 brings the window API to macOS and Linux, gives Svelte apps the same window and pop-out support as Vue apps, and adds position: sticky. The CLI now warns about CSS the engine does not support and, under sk dev, about renders that waste work. The Rust crates are on crates.io for the first time, with a new skathi crate for embedding the engine in your own executable.

bun create skathi my-app

Documentation: skathi.land

Highlights

  • The window API on every platform. appWindow verbs (maximize, restore, center, show/hide, setBounds, always on top, startDragging) and its state reads now work on macOS and Linux. app-region and --window-control work on macOS. See the Window API reference and the window guides.
  • Svelte matches Vue. @skathi-native/runtime/svelte exports everything a Svelte app needs, including a Svelte <SkWindow> for pop-out windows. appWindow reads are reactive in templates, $derived and $effect.
  • position: sticky, both axes and nested scrollers, with no relayout or JavaScript on scroll.
  • CSS checks. sk check, sk build, sk publish and sk dev report properties, values, selectors and at-rules the engine does not support, with file and line (SK4001–SK4005).
  • Performance advisories under sk dev. The runtime warns when an update re-renders far more than it changes, and the devtools Performance tab shows the same hint on the recorded frame. Production builds contain none of this code.
  • TypeScript 6 in the CLI and in new apps.
  • Rust crates on crates.io: the skathi facade crate, the sk-* crates, skathi-gpui-*, redjs and skathi-taffy.
  • Reference docs and guides on skathi.land: searchable CSS, web platform, Window API, App API and sk.config.json references, and new guides.

New features

Windows, macOS and Linux

  • appWindow on macOS and Linux: maximize, unmaximize, restore, center, show, hide, setBounds, alwaysOnTop, startDragging and the state reads. maximize() never toggles on any platform.
  • Under Wayland, the compositor does not let an app place, hide or keep its window on top. These calls print an advisory instead (a size still applies).
  • app-region and --window-control work on macOS. On macOS and Linux, a custom close button goes through close-requested, beforeunload and pagehide, as it does on Windows.
  • singleInstance and the raise on a second launch work on macOS.
  • window.maximizable, minimizable and resizable in sk.config.json apply on every platform.
  • appWindow receives resize, focus and blur events.
  • defineWindow accepts theme.
  • <SkWindow>: backdrop, titleBarHeight and activate can be changed after the window opens. Changing a creation-time prop prints an advisory. A pop-out without x/y opens on the main window's monitor; one with x/y opens on the monitor at that position. Pop-outs created hidden can be shown on macOS and Linux.
  • Guides: Windows, Custom title bars, Pop-out windows, Closing and running in the background.

Svelte

  • @skathi-native/runtime/svelte re-exports the app* APIs, appWindow, defineWindow and getCurrentWindow, and adds a Svelte <SkWindow> built on the same core as the Vue component. The app* APIs can also be imported from @skathi-native/runtime in either framework.
  • appWindow reads are reactive in Svelte templates, $derived and $effect.
  • sk dev compiles .svelte files shipped inside npm packages, for example component libraries.

CSS

  • position: sticky: insets on all four sides in px, %, rem and calc(), both axes, nested scroll containers. Geometry reads (getBoundingClientRect, offsetTop, elementFromPoint, hit tests, IntersectionObserver) report the stuck position, including right after scrollTop is set. A sticky box is a stacking context at its z-index. getComputedStyle().position returns "sticky".
  • @keyframes and element.animate() animate --shading, as the docs said they did. It is still excluded from transition: all.
  • The CSS reference is now a searchable catalog with a page per property, value and selector. Each page shows per-platform support, the release the entry arrived in, examples, edge cases and workarounds.

Runtime and DOM

  • An object :style that re-renders with the same values no longer calls the host. A changed one is one host call per element, which writes only the declarations that differ and produces one MutationObserver record. See the upgrade notes for how this interacts with direct el.style writes.
  • Types for APIs the engine already had: AnalyserNode decibel range and float/byte reads, AudioBufferSourceNode loop fields and start(when, offset, duration), navigator.mediaSession with MediaMetadata (Windows and macOS), and import.meta.hot in env.d.ts.

CLI and tooling

  • CSS checks. sk check reads <style> blocks in Vue and Svelte files, static style attributes, imported CSS with its @imports, and index.html. It warns with file and line:

    • SK4001: a property the engine does not support
    • SK4002: a value or function it does not apply
    • SK4003: a selector that can never match
    • SK4004: an at-rule whose rules are dropped
    • SK4005: one summary per dependency package (--no-deps skips dependencies)

    Nothing inside @supports, var() values or CSS-wide keywords is reported. sk build and sk publish print the same warnings for the CSS they bundle and never fail on them. sk dev checks at startup and then checks each file you edit, printing each warning once per session. check.allow in sk.config.json applies to all of them.

  • Two new templates from skathi-templates: player, a music player in Svelte 5 with shader effects, and weather, a Vue weather app whose sky and rain are shaders. Use sk create --template player|weather or pick one in bun create skathi. An installed CLI downloads the template from the commit the release pinned, so the npm package does not carry the demo media.

  • A template's own icon.png replaces the Skathi icon in the created app.

  • sk create writes "typescript": "^6".

Devtools

  • Performance advisories. Under sk dev, a [skathi perf] line is printed once per cause, and a hint is added to the recorded frame in the Performance tab:
    • wasted-render: a Vue update re-rendered 500+ elements and under 5% changed. Names the reactive values and the input event that triggered it.
    • long-list: a list of 50+ items re-rendered while under 25% of it was visible in its scroll container.
    • host-writes: 1000+ style, class, attribute and text writes in one frame, with the top three components.
  • A screenshot of an unknown window id is an error, instead of a capture of the first visible window.
  • devtools/ctl.ts run from an app folder defaults to that app's dist/.sk-dev. When there is no handshake, it tells you to run sk dev.

Documentation

Embedding (Rust)

  • New skathi crate: the single dependency for embedding Skathi in your own executable. It re-exports the embedding API (Builder, Handle, HostContext and the rest), tray, hotkeys and run_exe. It mirrors sk-app's features, with prod on by default. Through links metadata it reports the linker arguments and Windows resources your executable must carry (DEP_SKATHI_LINK_ARGS, DEP_SKATHI_WINDOWS_RESOURCES). Build the payload with sk build --payload-only or sk publish --payload-only. See docs.rs/skathi.
  • redjs builds from crates.io without a checkout or setup step. It downloads the pinned JavaScriptCore prebuilt into a shared cache (REDJS_CACHE_DIR, otherwise your user cache directory) and checks its hash.

Fixes

CSS and effects

  • A negative animation-delay or transition-delay starts the animation part-way through. Before, it was clamped to 0s, so staggered animations ran in phase.
  • :focus, :focus-visible and :focus-within on an ancestor (.slider:focus .thumb) apply. Before, these rules were dropped with an advisory.
  • --shading fades in from, and out to, an element with no effect, instead of snapping.
  • Changing or transitioning an [SkAnimated] speed no longer makes the animation jump. The motion continues from where it is.
  • Absolutely positioned, fixed and z-indexed descendants are part of a content effect's ([SkContent]) input. Before, they were painted after the effect captured its content.
  • sk dev picks up the first shader of an app tha...
Read more

v0.2.0

Choose a tag to compare

@github-actions github-actions released this 16 Nov 02:13

The first full release of Skathi: desktop apps from Vue 3 and Svelte 5 components, rendered on the GPU without a browser.

bun create skathi my-app

Documentation: skathi.land

Highlights

  • bun create skathi. A new app in one command: pick the showcase, minimal or svelte template, the platforms and the package manager.
  • Svelte 5. Svelte apps alongside Vue, from their own template, with hot reload. An app that doesn't use Vue's renderer, router or Pinia no longer carries them in its bundle.
  • Shader effects grew up. Effects can shade an element's own content, keep history between frames, take images as parameters, and cross-fade into a different effect. A new devtools panel edits them live.
  • New web APIs: Pointer Lock, View Transitions, smooth scrolling, Element.animate() on more properties.
  • More CSS: masks, text-shadow, modern colour functions, order, object-position, and CSS.supports() / @supports that tell the truth.

Effects (--shading)

  • [SkContent] effects shade the element's own painting (images and text included); [SkHistory] effects read their previous frame, for trails, feedback and multi-pass looks.
  • Image textures as parameters: --shading: glass(url(assets/normals.png), 10px, 1).
  • 32 parameter floats per effect; the pointer position filled in by the host, and an effect clock that shares its zero with performance.now(), so a page can hand an effect a start time.
  • Backdrop helpers in the sk Slang module.
  • A transition on --shading cross-fades between two different effects, not only between parameters of one.
  • The showcase has a Shaders page: shatter, ripples, snow and fireflies over the whole window, liquid glass, nebula, orbit, dissolve, halftone, colour grade and patterned glass.

Devtools

  • An Effects panel: the effects on the page, with controls generated from each effect's schema, applied live.
  • effects in the devtools CLI lists --shading schemas and sets live overrides.

Web platform

  • Pointer Lock (requestPointerLock, pointerLockElement, movementX/Y). Escape always releases it. On Linux, X11 only.
  • View Transitions: document.startViewTransition() for same-document transitions in the main window, with view-transition-name and the ::view-transition-* pseudo-elements.
  • Smooth scrolling: scroll-behavior: smooth, and behavior: "smooth" in scrollTo, scrollBy and scrollIntoView.
  • Element.animate() and @keyframes animate border-width and overflow.
  • getComputedStyle() answers padding, margin and border-width longhands.
  • cloneNode/importNode fixes; listeners added to <body> before mount are kept.
  • Many DOM and browser APIs moved from the JavaScript runtime into native code (History, element geometry and scrolling, viewport metrics, the CSS namespace, document.defaultView, <head> members). Apps load less JavaScript at startup.

CSS

  • Masks: mask, mask-image (images and gradients), mask-mode, mask-position, mask-size, mask-repeat, mask-composite. Unprefixed only; -webkit-mask-* is not read. mask-clip/mask-origin support border-box.
  • text-shadow.
  • oklch(), oklab(), lab(), lch(), hwb(), color() and color-mix() anywhere a colour is accepted.
  • order for flex and grid items; object-position for images, video, canvas and Lottie (transitionable); contain and will-change are accepted.
  • CSS.supports() and @supports answer from one catalog of what the engine actually applies. The CSS reference lists every property as supported, partial, planned or not supported.
  • Isolated layers now work on Linux and macOS too: clip-path, colour-matrix filters and text backgrounds render the same on every platform.

Hot reload

  • import.meta.hot for app modules, including accept(deps, cb) and acceptExports.
  • One dev bundle per npm package, even when the app imports several of its entry points.

Fixes

  • Gradients on Linux (wgpu) and glyph edges on macOS (Metal) now match Windows; Oklab gradients use the exact sRGB curve.
  • Whitespace-only text outside inline content no longer renders.
  • Launching an app while its previous instance is still closing waits for it instead of failing.
  • sk check no longer reports code that the production bundle drops anyway.

Behaviour changes

  • document.activeElement is <body> when nothing has focus, as in browsers.
  • Adding the same listener twice to the same target is a no-op, as in browsers.
  • Opening a link in an app embedded without a desktop host rejects with ENOSYS instead of doing nothing.

Building from source

  • ThorVG links from a pinned prebuilt archive instead of being compiled; WebGPU comes from redjs with a single wgpu revision; leaner gpui and Windows dependencies; faster relinks of sk-app in development.

Full Changelog: v0.1.0-beta.4...v0.2.0

v0.1.0-beta.4

v0.1.0-beta.4 Pre-release
Pre-release

Choose a tag to compare

@github-actions github-actions released this 15 Nov 12:53

ThorVG 1.1.2-2 (static, for sk-thorvg-sys)

Choose a tag to compare

@github-actions github-actions released this 15 Nov 13:30

ThorVG static libraries for crates/sk-thorvg-sys (its build.rs downloads these), built by the thorvg prebuilt workflow at c64d2a3 from its thorvg submodule, with the crate's default features. ThorVG is MIT; the code it bundles keeps its own licenses (JerryScript Apache-2.0, RapidJSON MIT, lodepng Zlib).

v0.1.0-beta.3

v0.1.0-beta.3 Pre-release
Pre-release

Choose a tag to compare

@github-actions github-actions released this 14 Nov 22:51

v0.1.0-beta.2

v0.1.0-beta.2 Pre-release
Pre-release

Choose a tag to compare

@github-actions github-actions released this 14 Nov 16:04

v0.1.0-beta.1

v0.1.0-beta.1 Pre-release
Pre-release

Choose a tag to compare

@github-actions github-actions released this 14 Nov 13:02