@gtkx/react 0.10.5 → 0.11.0

package/README.md

@@ -0,0 +1,103 @@
+<p align="center">
+  <img src="https://raw.githubusercontent.com/eugeniodepalo/gtkx/main/logo.svg" alt="GTKX" width="60" height="60">
+</p>
+
+<h1 align="center">GTKX</h1>
+
+<p align="center">
+  <strong>Build native GTK4 desktop applications with React and TypeScript.</strong>
+</p>
+
+<p align="center">
+  <a href="https://www.npmjs.com/package/@gtkx/react"><img src="https://img.shields.io/npm/v/@gtkx/react.svg" alt="npm version"></a>
+  <a href="https://github.com/eugeniodepalo/gtkx/actions"><img src="https://img.shields.io/github/actions/workflow/status/eugeniodepalo/gtkx/ci.yml" alt="CI"></a>
+  <a href="https://github.com/eugeniodepalo/gtkx/blob/main/LICENSE"><img src="https://img.shields.io/badge/license-MPL--2.0-blue.svg" alt="License"></a>
+  <a href="https://github.com/eugeniodepalo/gtkx/discussions"><img src="https://img.shields.io/badge/discussions-GitHub-blue" alt="GitHub Discussions"></a>
+</p>
+
+---
+
+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.
+
+## Quick Start
+
+```bash
+npx @gtkx/cli create my-app
+cd my-app
+npm run dev
+```
+
+## Example
+
+```tsx
+import {
+  GtkApplicationWindow,
+  GtkBox,
+  GtkButton,
+  GtkLabel,
+  quit,
+  render,
+} from "@gtkx/react";
+import * as Gtk from "@gtkx/ffi/gtk";
+import { useState } from "react";
+
+const App = () => {
+  const [count, setCount] = useState(0);
+
+  return (
+    <GtkApplicationWindow
+      title="Counter"
+      defaultWidth={300}
+      defaultHeight={200}
+      onCloseRequest={quit}
+    >
+      <GtkBox
+        orientation={Gtk.Orientation.VERTICAL}
+        spacing={20}
+        valign={Gtk.Align.CENTER}
+      >
+        <GtkLabel label={`Count: ${count}`} cssClasses={["title-1"]} />
+        <GtkButton label="Increment" onClicked={() => setCount((c) => c + 1)} />
+      </GtkBox>
+    </GtkApplicationWindow>
+  );
+};
+
+render(<App />, "com.example.counter");
+```
+
+## Features
+
+- **React 19** — Hooks, concurrent features, and the component model you know
+- **Native GTK4 widgets** — Real native controls, not web components in a webview
+- **Adwaita support** — Modern GNOME styling with Libadwaita components
+- **Hot Module Replacement** — Fast refresh during development
+- **TypeScript first** — Full type safety with auto-generated bindings
+- **CSS-in-JS styling** — Familiar styling patterns adapted for GTK
+- **Testing utilities** — Component testing similar to Testing Library
+
+## Examples
+
+Explore complete applications in the [`examples/`](./examples) directory:
+
+- **[gtk-demo](./examples/gtk-demo)** — Full replica of the official GTK demo app
+- **[hello-world](./examples/hello-world)** — Minimal application showing a counter
+- **[todo](./examples/todo)** — Full-featured todo application with Adwaita styling and testing
+- **[deploying](./examples/deploying)** — Example of packaging and distributing a GTKX app
+
+## Documentation
+
+Visit [https://eugeniodepalo.github.io/gtkx](https://eugeniodepalo.github.io/gtkx/) for the full documentation.
+
+## Contributing
+
+Contributions are welcome! Please see the [contributing guidelines](./CONTRIBUTING.md) and check out the [good first issues](https://github.com/eugeniodepalo/gtkx/labels/good%20first%20issue).
+
+## Community
+
+- [GitHub Discussions](https://github.com/eugeniodepalo/gtkx/discussions) — Questions, ideas, and general discussion
+- [Issue Tracker](https://github.com/eugeniodepalo/gtkx/issues) — Bug reports and feature requests
+
+## License
+
+[MPL-2.0](./LICENSE)

package/dist/factory.js

@@ -8,6 +8,7 @@ const resolveContainerClass = (type) => {
             return namespace[className];
         }
     }
+    return null;
 };
 export const createNode = (typeName, props, existingContainer, rootContainer) => {
     const containerClass = resolveContainerClass(typeName);

package/dist/generated/internal.d.ts

@@ -1,4 +1,30 @@
-/** Internal metadata for the reconciler. Not part of the public API. */
+/**
+ * Internal metadata for the reconciler.
+ * This is the SINGLE SOURCE OF TRUTH for widget classification.
+ * Not part of the public API.
+ */
+import * as Adw from "@gtkx/ffi/adw";
+import * as Gtk from "@gtkx/ffi/gtk";
+/** List widgets that require renderItem prop. */
+export declare const LIST_WIDGET_CLASSES: readonly [typeof Gtk.GridView, typeof Gtk.ListView];
+/** Dropdown widgets with special item handling. */
+export declare const DROP_DOWN_CLASSES: readonly [typeof Adw.ComboRow, typeof Gtk.DropDown];
+/** Column view widgets with column-based layout. */
+export declare const COLUMN_VIEW_CLASSES: readonly [typeof Gtk.ColumnView];
+/** Widgets that auto-wrap children (ListBox wraps in ListBoxRow, FlowBox wraps in FlowBoxChild). */
+export declare const AUTOWRAP_CLASSES: readonly [typeof Gtk.FlowBox, typeof Gtk.ListBox];
+/** Stack widgets that show one child at a time. */
+export declare const STACK_CLASSES: readonly [typeof Gtk.Stack, typeof Adw.ViewStack];
+/** Notebook widgets with tabbed interface. */
+export declare const NOTEBOOK_CLASSES: readonly [typeof Gtk.Notebook];
+/** Widgets that support popover menu children. */
+export declare const POPOVER_MENU_CLASSES: readonly [typeof Gtk.MenuButton, typeof Gtk.PopoverMenu, typeof Gtk.PopoverMenuBar];
+/** Methods that define the packable interface (pack start/end positioning). */
+export declare const PACK_INTERFACE_METHODS: string[];
+/** Methods that define the prefix/suffix interface (Adwaita action rows). */
+export declare const PREFIX_SUFFIX_INTERFACE_METHODS: string[];
+/** Constructor parameters for each widget type, derived from GIR analysis. */
 export declare const CONSTRUCTOR_PROPS: Record<string, string[]>;
 export declare const PROPS: Record<string, Record<string, [string | null, string]>>;
+/** Signal names for each widget type, derived from CodegenWidgetMeta. */
 export declare const SIGNALS: Record<string, Set<string>>;