@gtkx/vitest 0.20.0 → 0.21.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/README.md +26 -62
  2. package/package.json +2 -2
package/README.md CHANGED
@@ -1,23 +1,39 @@
1
1
  <p align="center">
2
- <img src="https://raw.githubusercontent.com/eugeniodepalo/gtkx/main/logo.svg" alt="GTKX" width="60" height="60">
2
+ <img src="https://raw.githubusercontent.com/eugeniodepalo/gtkx/main/logo.svg" alt="GTKX" width="100" height="100">
3
3
  </p>
4
4
 
5
5
  <h1 align="center">GTKX</h1>
6
6
 
7
7
  <p align="center">
8
- <strong>Build native GTK4 desktop applications with React and TypeScript.</strong>
8
+ <strong>Linux application development for the modern age powered by GTK4 and React</strong>
9
9
  </p>
10
10
 
11
11
  <p align="center">
12
- <a href="https://www.npmjs.com/package/@gtkx/react"><img src="https://img.shields.io/npm/v/@gtkx/react.svg" alt="npm version"></a>
13
- <a href="https://github.com/gtkx-org/gtkx/actions"><img src="https://img.shields.io/github/actions/workflow/status/eugeniodepalo/gtkx/ci.yml" alt="CI"></a>
14
- <a href="https://github.com/gtkx-org/gtkx/blob/main/LICENSE"><img src="https://img.shields.io/badge/license-MPL--2.0-blue.svg" alt="License"></a>
15
- <a href="https://github.com/gtkx-org/gtkx/discussions"><img src="https://img.shields.io/badge/discussions-GitHub-blue" alt="GitHub Discussions"></a>
12
+ <a href="https://www.npmjs.com/package/@gtkx/react"><img src="https://img.shields.io/npm/v/@gtkx/react.svg" alt="npm version"></a>
13
+ <a href="https://github.com/gtkx-org/gtkx/actions"><img src="https://img.shields.io/github/actions/workflow/status/eugeniodepalo/gtkx/ci.yml" alt="CI"></a>
14
+ <a href="https://github.com/gtkx-org/gtkx/blob/main/LICENSE"><img src="https://img.shields.io/badge/license-MPL--2.0-blue.svg" alt="License"></a>
15
+ <a href="https://github.com/gtkx-org/gtkx/discussions"><img src="https://img.shields.io/badge/discussions-GitHub-blue" alt="GitHub Discussions"></a>
16
16
  </p>
17
17
 
18
18
  ---
19
19
 
20
- GTKX lets you write Linux desktop applications using React. Your components render as native GTK4 widgets through a Rust FFI bridge—no webviews, no Electron, just native performance with the developer experience you already know.
20
+ <p align="center">
21
+ <img src="https://raw.githubusercontent.com/eugeniodepalo/gtkx/main/demo.gif" alt="GTKX Demo" width="100%">
22
+ </p>
23
+
24
+ ---
25
+
26
+ GTKX is a modern framework for building native Linux applications using React and GTK. It provides the full range of GTK4, GLib, and Node.js APIs, allowing you to create rich, performant desktop applications with the tools and libraries you already know.
27
+
28
+ ## Features
29
+
30
+ - **React 19** — Hooks, concurrent features, and the component model you know
31
+ - **Fully native Node.js environment** - Runs on vanilla Node.js, with the help of a Neon native module
32
+ - **TypeScript first** — Full type safety with auto-generated bindings
33
+ - **Rich GLib support** — Provides bindings for most modern GLib/GObject libraries, including Adwaita
34
+ - **HMR** — Fast refresh during development powered by Vite
35
+ - **CSS-in-JS styling** — Easy styling with GTK CSS powered by Emotion
36
+ - **Testing library** — Testing Library-inspired API for testing components and E2E
21
37
 
22
38
  ## Quick Start
23
39
 
@@ -27,66 +43,14 @@ cd my-app
27
43
  npm run dev
28
44
  ```
29
45
 
30
- ## Example
31
-
32
- ```tsx
33
- import {
34
- GtkApplicationWindow,
35
- GtkBox,
36
- GtkButton,
37
- GtkLabel,
38
- quit,
39
- render,
40
- } from "@gtkx/react";
41
- import * as Gtk from "@gtkx/ffi/gtk";
42
- import { useState } from "react";
43
-
44
- const App = () => {
45
- const [count, setCount] = useState(0);
46
-
47
- return (
48
- <GtkApplicationWindow
49
- title="Counter"
50
- defaultWidth={300}
51
- defaultHeight={200}
52
- onClose={quit}
53
- >
54
- <GtkBox
55
- orientation={Gtk.Orientation.VERTICAL}
56
- spacing={20}
57
- valign={Gtk.Align.CENTER}
58
- >
59
- <GtkLabel label={`Count: ${count}`} cssClasses={["title-1"]} />
60
- <GtkButton label="Increment" onClicked={() => setCount((c) => c + 1)} />
61
- </GtkBox>
62
- </GtkApplicationWindow>
63
- );
64
- };
65
-
66
- render(<App />, "com.example.counter");
67
- ```
68
-
69
- ## Features
70
-
71
- - **React 19** — Hooks, concurrent features, and the component model you know
72
- - **Native GTK4 widgets** — Real native controls, not web components in a webview
73
- - **Adwaita support** — Modern GNOME styling with Libadwaita components
74
- - **Declarative animations** — Framer Motion-like API using native Adwaita animations
75
- - **Hot Module Replacement** — Fast refresh during development
76
- - **TypeScript first** — Full type safety with auto-generated bindings
77
- - **CSS-in-JS styling** — Familiar styling patterns adapted for GTK
78
- - **Testing utilities** — Component testing similar to Testing Library
79
-
80
46
  ## Examples
81
47
 
82
48
  Explore complete applications in the [`examples/`](./examples) directory:
83
49
 
84
- - **[gtk-demo](./examples/gtk-demo)** — Full replica of the official GTK demo app
85
50
  - **[hello-world](./examples/hello-world)** — Minimal application showing a counter
86
- - **[todo](./examples/todo)** — Full-featured todo application with Adwaita styling and testing
87
- - **[x-showcase](./examples/x-showcase)** — Showcase of all x.\* virtual components
51
+ - **[gtk-demo](./examples/gtk-demo)** — Full replica of the official GTK demo app
52
+ - **[tutorial](./examples/tutorial)** — Notes app from the tutorial with GSettings and Adwaita
88
53
  - **[browser](./examples/browser)** — Simple browser using WebKitWebView
89
- - **[deploying](./examples/deploying)** — Example of packaging and distributing a GTKX app
90
54
 
91
55
  ## Documentation
92
56
 
@@ -94,7 +58,7 @@ Visit [https://gtkx.dev](https://gtkx.dev) for the full documentation.
94
58
 
95
59
  ## Contributing
96
60
 
97
- Contributions are welcome! Please see the [contributing guidelines](./CONTRIBUTING.md) and check out the [good first issues](https://github.com/gtkx-org/gtkx/labels/good%20first%20issue).
61
+ Contributions are welcome! Please see the [contributing guidelines](./CONTRIBUTING.md).
98
62
 
99
63
  ## Community
100
64
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@gtkx/vitest",
3
- "version": "0.20.0",
3
+ "version": "0.21.0",
4
4
  "description": "Vitest plugin for GTKX applications with Xvfb display isolation",
5
5
  "keywords": [
6
6
  "gtkx",
@@ -38,7 +38,7 @@
38
38
  "src"
39
39
  ],
40
40
  "devDependencies": {
41
- "vitest": "^4.0.18"
41
+ "vitest": "^4.1.2"
42
42
  },
43
43
  "peerDependencies": {
44
44
  "vitest": ">=4"