@gtkx/config 0.21.0 → 1.0.0-rc.1

package/README.md

@@ -1,118 +1,173 @@
 <p align="center">
-  <img src="logo.svg" alt="gtkx" width="180" />
+  <img src="https://raw.githubusercontent.com/gtkx-org/gtkx/main/logo.svg" alt="GTKX" width="100" />
 </p>
 
-# gtkx
+<h1 align="center">GTKX</h1>
 
-gtkx is a framework for building native GTK4/libadwaita desktop applications with React, TypeScript, and JSX. You write declarative JSX whose element types are GTK widget names; a custom react-reconciler maps that tree to live GObject instances, while a Rust napi addon owns the single GLib main-loop thread and performs every call into GTK. A build-time generator turns GObject-Introspection (GIR) XML into typed bindings, JSX element types, and reconciler metadata, and a Vite-based CLI provides scaffolding, a hot-reloading dev server, single-file production bundling, and GTK-asset integration.
-
-Homepage: [gtkx.dev](https://gtkx.dev)
+<p align="center">
+  The React framework for Linux.<br />
+  Build GTK4 and Adwaita apps in TypeScript, with React components and hooks driving GNOME's own widgets. What you ship is a GNOME app.
+</p>
 
-![gtkx demo](demo.gif)
+<p align="center">
+  <a href="https://www.npmjs.com/package/create-gtkx"><img src="https://img.shields.io/npm/v/create-gtkx?color=cb3837&logo=npm&label=create-gtkx" alt="npm version" /></a>
+  <a href="https://www.npmjs.com/package/create-gtkx"><img src="https://img.shields.io/npm/dm/create-gtkx?color=cb3837&logo=npm&label=downloads" alt="npm downloads" /></a>
+  <img src="https://img.shields.io/badge/node-%E2%89%A524-339933?logo=node.js&logoColor=white" alt="Node >= 24" />
+  <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: MPL-2.0" /></a>
+  <a href="https://github.com/gtkx-org/gtkx/actions/workflows/ci.yml"><img src="https://img.shields.io/github/actions/workflow/status/gtkx-org/gtkx/ci.yml?branch=main&logo=github&label=CI" alt="CI status" /></a>
+  <img src="https://img.shields.io/badge/TypeScript-strict-3178c6?logo=typescript&logoColor=white" alt="TypeScript" />
+</p>
 
-## Prerequisites
+<p align="center">
+  <a href="https://gtkx.dev">Homepage</a> &middot;
+  <a href="https://gtkx.dev/guide/why-gtkx">Documentation</a> &middot;
+  <a href="https://github.com/gtkx-org/gtkx/tree/main/examples">Examples</a> &middot;
+  <a href="https://github.com/gtkx-org/gtkx/blob/main/CONTRIBUTING.md">Contributing</a>
+</p>
 
-This is a Linux desktop framework, not a browser/DOM renderer. You need:
+---
 
-- **Node.js** — the engines floor is Node `>=24`.
-- **pnpm** — the workspace package manager, provisioned via Corepack from the `packageManager` field.
-- **Rust toolchain** — 2024 edition with a C linker, plus the napi-rs CLI and Node N-API headers, to compile the native addon. A nightly toolchain is additionally required for the coverage, asan, and miri paths.
-- **libffi** — for dynamic CIF construction and closures in the native addon.
-- **GTK4 and libadwaita** development libraries, plus the broader GNOME library set the examples use (GtkSourceView, WebKitGTK, VTE, GStreamer, etc.), with `pkg-config`.
-- **GLib/GObject** shared libraries present at build and run time; gtkx resolves GTK symbols dynamically by name.
-- **GObject-Introspection** development data and system GIR files (read by codegen), plus `glib-compile-resources` and `glib-compile-schemas` for asset compilation.
-- **A headless Wayland compositor** (Weston, or Sway when `GTKX_COMPOSITOR=sway`) and software GL/Vulkan rasterization to run GTK tests and benches without a GPU.
-- **git**, for repository initialization during scaffolding.
+GTKX generates fully typed bindings for the entire GTK4 and Adwaita surface directly from GObject-Introspection. On top of those bindings you get the React programming model: components and hooks driving GObject instances, with Fast Refresh while you develop.
 
-For the containerized CI path you additionally need Docker; the CI image pins the full GTK/Rust/Node toolchain.
+<p align="center">
+  <img src="https://raw.githubusercontent.com/gtkx-org/gtkx/main/examples/tutorial/assets/screenshot.png" alt="The Tasks app: an Adwaita window with a sidebar of smart views and colored lists on the left, and a boxed task list on the right." />
+</p>
 
-## Getting started
+<p align="center">
+  <em>The Tasks app you build in the <a href="https://gtkx.dev/tutorial/">tutorial</a>.</em>
+</p>
 
-```sh
-git clone https://github.com/gtkx-org/gtkx.git
-cd gtkx
-corepack enable
-pnpm install
-pnpm build
+## Demo
+
+The intrinsic elements in this snippet render GTK4 widgets, and ordinary React hooks and events drive them:
+
+```tsx
+import * as Gtk from "@gtkx/gi/gtk";
+import { GtkApplication, GtkApplicationWindow, GtkBox, GtkButton, GtkLabel } from "@gtkx/jsx/gtk";
+import { createRoot, quit } from "@gtkx/react";
+import { useState } from "react";
+
+const Counter = () => {
+  const [count, setCount] = useState(0);
+
+  return (
+    <GtkApplicationWindow
+      title="Hello GTKX"
+      defaultWidth={400}
+      defaultHeight={300}
+      onCloseRequest={quit}
+    >
+      <GtkBox
+        orientation={Gtk.Orientation.VERTICAL}
+        spacing={20}
+        marginTop={40}
+        marginBottom={40}
+        marginStart={40}
+        marginEnd={40}
+        valign={Gtk.Align.CENTER}
+        halign={Gtk.Align.CENTER}
+      >
+        <GtkLabel cssClasses={["title-1"]}>Welcome to GTKX!</GtkLabel>
+        <GtkLabel cssClasses={["title-2"]}>{`Count: ${count}`}</GtkLabel>
+        <GtkButton
+          label="Increment"
+          onClicked={() => setCount((c) => c + 1)}
+          cssClasses={["suggested-action", "pill"]}
+        />
+      </GtkBox>
+    </GtkApplicationWindow>
+  );
+};
+
+const App = () => (
+  <GtkApplication>
+    <Counter />
+  </GtkApplication>
+);
+
+createRoot().render(<App />);
 ```
 
-`pnpm build` runs the Rust `native-build` and `@gtkx/cli#codegen` first (hard Turbo upstreams), so the first build compiles the addon and generates the `@gtkx/gi`/`@gtkx/jsx` binding stores before any TypeScript package builds.
+This is the [`hello-world`](https://github.com/gtkx-org/gtkx/tree/main/examples/hello-world) example, with `app.tsx` and `index.tsx` combined into a single snippet. `@gtkx/gi` and `@gtkx/jsx` are per-project bindings generated by the CLI, not packages you install from npm.
 
-## Common commands
+## Why GTKX
 
-All root scripts run through Turbo over the workspace (the root meta-package is excluded with `--filter=!gtkx`).
+### A declarative layer for the GNOME stack
 
-| Command | Description |
-| --- | --- |
-| `pnpm build` | Build all workspace packages (runs codegen + native-build first). |
-| `pnpm --filter <pkg> dev` | Start a package/example dev server (hot-reloading `gtkx dev`); see [Running the examples](#running-the-examples). There is no root `dev` script. |
-| `pnpm test` | Run the Vitest workspace plus per-package test scripts. |
-| `pnpm typecheck` | Type-check every package via `tsc -b --emitDeclarationOnly` across the reference graph. |
-| `pnpm lint` | Full quality gate: ts-reference drift check, biome, knip (default + production), dependency-cruiser, plus per-package lint (Rust fmt/clippy on native). |
-| `pnpm codegen` | Generate/refresh the `.gtkx` GIR and JSX binding stores consumed by other packages. |
-| `pnpm coverage` | Aggregated v8 lcov coverage (TS) plus native Rust coverage. |
-| `pnpm sync:ts-refs` | Rewrite TypeScript project references from `package.json` deps and format them (add `--check` to fail on drift). |
-| `pnpm asan` / `pnpm miri` / `pnpm bench` | Native AddressSanitizer suite, Miri marshalling subset, and CodSpeed benchmarks under the headless compositor. |
-| `pnpm release` | Build, inject README into published packages, stage native artifacts, and publish to npm. |
-| `pnpm publish-test` | Publish to an ephemeral Verdaccio registry, then scaffold, build, typecheck, and test a consumer app end-to-end. |
+GTK4 is mature, and GtkBuilder XML can lay out a static interface, but nothing re-renders that interface when your application state changes, and nothing hot-reloads it as you work. GTKX adds that missing layer, and the tooling around it, on top of the stack you already know:
 
-To run tests for a single package, filter through Turbo or pnpm, for example:
+- a React reconciler that exposes every GObject as a JSX element,
+- a CLI for scaffolding, development, and production builds,
+- a dev server with Fast Refresh that patches your running UI in place,
+- CSS-in-JS styling and high-level list, grid, and dialog components,
+- a Testing Library-style API for querying and driving your widgets in tests,
+- and a Model Context Protocol (MCP) server that exposes your live app to AI agents.
 
-```sh
-pnpm --filter @gtkx/ffi test
-pnpm --filter @gtkx/react test
-pnpm --filter @gtkx/cli build
-```
+### The full GNOME API surface
 
-## Running the examples
+React Native and similar frameworks hide the native toolkit so one API can run everywhere. GTKX exposes it: GTK4, Adwaita, and any other GObject-Introspection library on your system. Linux-only by design.
 
-Each example exposes the standard `dev`, `build`, and `start` scripts that wrap the CLI (`gtkx dev` / `gtkx build` / `node dist/bundle.js`).
+### Why Node.js, and why generated bindings
 
-```sh
-# Counter app demonstrating the basics
-pnpm --filter hello-world dev
+GTKX runs on Node.js, which puts native modules, the npm ecosystem, and the tooling built for Node.js APIs within reach. GJS is GNOME's own runtime, built on SpiderMonkey rather than V8; node-gtk runs on Node.js but is lightly maintained, on the older nan/V8 ABI rather than N-API, and still centered on GTK3. The [why-gtkx guide](https://gtkx.dev/guide/why-gtkx) covers the comparison in full.
 
-# Notes app from the tutorial (uses @gtkx/css and @gtkx/animate, GSettings via #data)
-pnpm --filter tutorial dev
+GTKX generates the TypeScript types and the native FFI calls from the same GObject-Introspection data, so the types cannot drift from the calls they back. Codegen covers the whole GTK4 and Adwaita surface.
 
-# GTK4 widget showcase (the React port of the official gtk-demo; the only example with tests)
-pnpm --filter gtk-demo dev
-pnpm --filter gtk-demo coverage
+At runtime, the native Rust core calls straight into the system GTK4, Adwaita, and GLib libraries through libffi, without loading libgirepository at all.
 
-# Simple browser using WebKitWebView
-pnpm --filter browser dev
-```
+## Quick start
 
-Build and run any example's production bundle:
+GTKX is Linux-only and needs Node.js 24 or later. See [Requirements](#requirements).
+
+Scaffold a new app with the `create-gtkx` initializer:
 
 ```sh
-pnpm --filter hello-world build
-pnpm --filter hello-world start
+npm create gtkx@rc
 ```
 
-The tutorial additionally packages as a single executable (`pnpm --filter tutorial build:sea`) and as a Flatpak (`pnpm --filter tutorial build:flatpak`); these need esbuild, postject, and a Flatpak toolchain.
+The same command works with other package managers: `pnpm create gtkx@rc` or `yarn create gtkx@rc`.
+
+Then run your new app:
 
-## Gotchas
+```sh
+cd my-app
+npm run dev
+```
 
-- **codegen and native-build come first.** A clean checkout cannot type-check or build any TypeScript package until the Rust addon is compiled and codegen has produced `.gtkx`; both are hard Turbo upstreams. `pnpm lint` first creates the `.gtkx` symlink that knip and dependency-cruiser resolve against.
-- **Generated packages are not hand-edited.** `@gtkx/gi`, `@gtkx/jsx`, and the generated `@gtkx/gl` sources come from `@gtkx/codegen`. Change the emitters or `gtkx.config.ts` and regenerate (`pnpm codegen`); the store swap is atomic, so partial writes never appear.
-- **GTK tests/benches need a headless display.** Running native `test`/`coverage`/`asan` or the GTK suites outside the headless wrapper fails to initialize a display; the harness provisions a Wayland compositor with software rendering. Native tests run single-threaded because GTK requires a single owning thread.
-- **The native runtime is single-use.** All GObject/GTK mutation runs only on the single `gtkx-glib` thread; native init is one-shot and quit is terminal, so a process cannot restart the runtime. Importing `@gtkx/ffi` starts the GLib main loop and registers a process exit handler.
-- **Project references track deps.** TypeScript references are generated from `package.json` dependency fields by `sync-ts-references`; hand-editing them is reported as drift by the `--check` run in lint. Change deps, then run `pnpm sync:ts-refs`.
-- **`@gtkx/testing` cleanup is not automatic.** Consumers must register `cleanup()` (the e2e setup wires it into `afterEach`/`afterAll`), or leaked windows persist across tests.
-- **The dev loop restarts via exit code 75.** The dev supervisor and runner signal restart intent purely through process exit code 75; Fast Refresh applies only to SSR-transformed project files where every export looks like a React component, otherwise the whole process restarts.
+To go further, follow the [tutorial](https://gtkx.dev/tutorial/).
 
 ## Documentation
 
-Architecture and subsystem docs live under `docs/`:
+The documentation at **[gtkx.dev](https://gtkx.dev)** includes a step-by-step tutorial that builds a complete GNOME app, from scaffolding to packaging and shipping, plus guides and a full API reference.
+
+**[Read the docs &rarr;](https://gtkx.dev/guide/why-gtkx)**
+
+## Requirements
+
+GTKX is Linux-only. You need:
+
+- Linux with the GTK4 (4.20 or later), Adwaita (1.8 or later), and GLib development libraries
+- Node.js 24 or later
+
+The `@gtkx/native` addon ships prebuilt for x64 and arm64 glibc Linux; other targets need to build it from the GTKX repository, which requires a Rust toolchain.
+
+## Examples
+
+Explore the [example apps](https://github.com/gtkx-org/gtkx/tree/main/examples):
+
+- [`hello-world`](https://github.com/gtkx-org/gtkx/tree/main/examples/hello-world): the counter above.
+- [`gtk-demo`](https://github.com/gtkx-org/gtkx/tree/main/examples/gtk-demo): a React port of the official GTK4 widget showcase, covering lists, dialogs, gestures, CSS, and OpenGL.
+- [`browser`](https://github.com/gtkx-org/gtkx/tree/main/examples/browser): a WebKitWebView-based web browser.
+- [`tutorial`](https://github.com/gtkx-org/gtkx/tree/main/examples/tutorial): the Tasks app the documentation builds.
+
+## Status
+
+GTKX 1.0 is at the release candidate stage.
+
+## Contributing
+
+Contributions are welcome. See [CONTRIBUTING.md](https://github.com/gtkx-org/gtkx/blob/main/CONTRIBUTING.md), the [Code of Conduct](https://github.com/gtkx-org/gtkx/blob/main/CODE_OF_CONDUCT.md), and the [security policy](https://github.com/gtkx-org/gtkx/blob/main/SECURITY.md). Building the repo needs Node.js 24 or later, pnpm, and a Rust toolchain.
 
-- [`docs/architecture.md`](docs/architecture.md) — architecture overview and layer stack.
-- [`docs/rendering.md`](docs/rendering.md) — the render and event pipeline.
-- [`docs/codegen.md`](docs/codegen.md) — the GIR/Khronos code generator and the runtime contract.
-- [`docs/cli.md`](docs/cli.md) — the CLI and project workflow.
-- [`docs/styling.md`](docs/styling.md) — styling, animation, and GL.
-- [`docs/mcp.md`](docs/mcp.md) — the MCP server.
-- [`docs/testing.md`](docs/testing.md) — the testing architecture.
-- [`docs/build-system.md`](docs/build-system.md) — the build system and quality tooling.
+## License
 
-For an agent-oriented index of packages and the hard build rules, see [`CLAUDE.md`](CLAUDE.md).
+GTKX is licensed under [MPL-2.0](https://github.com/gtkx-org/gtkx/blob/main/LICENSE).

package/dist/config.d.ts

@@ -1,45 +1,86 @@
-import { type ArrayPropRow, type ContainerPropRow, type ElementMapRule, type ObjectPropRow, type PerElementPropRows, type UserTableRows, type VirtualPropRow } from "./table-schema.js";
+import { type DefineConfig } from "c12";
+import { z } from "zod";
 export declare const LIBRARIES_WILDCARD = "*";
-export declare const GIR_NAMESPACE_PATTERN: RegExp;
-export type GtkxConfig = UserTableRows & {
-    libraries?: typeof LIBRARIES_WILDCARD | string[];
-    girPath?: string[];
-    applicationId?: string;
-    reactCompiler?: boolean | ReactCompilerOptions;
-};
-export type ReactCompilerCompilationMode = "infer" | "syntax" | "annotation" | "all";
-export type ReactCompilerPanicThreshold = "none" | "critical_errors" | "all_errors";
-export type ReactCompilerOptions = {
+export declare const GIR_LIBRARY_PATTERN: RegExp;
+export declare const isValidApplicationId: (applicationId: string) => boolean;
+declare const COMPILATION_MODES: readonly ["infer", "syntax", "annotation", "all"];
+declare const PANIC_THRESHOLDS: readonly ["none", "critical_errors", "all_errors"];
+type ReactCompilerCompilationMode = (typeof COMPILATION_MODES)[number];
+type ReactCompilerPanicThreshold = (typeof PANIC_THRESHOLDS)[number];
+type ReactCompilerOptions = {
     compilationMode?: ReactCompilerCompilationMode;
     panicThreshold?: ReactCompilerPanicThreshold;
 };
+/**
+ * React Compiler options resolved for the build, with the compilation target
+ * fixed to React 19.
+ */
 export type ResolvedReactCompilerOptions = ReactCompilerOptions & {
     target: "19";
 };
-export declare const resolveReactCompilerOptions: (setting: GtkxConfig["reactCompiler"]) => ResolvedReactCompilerOptions | null;
-export declare const validateGtkxConfig: (config: GtkxConfig) => void;
-export type GtkxConfigEnv = {
-    mode?: string;
-};
-export type GtkxConfigFn = (env: GtkxConfigEnv) => GtkxConfig;
-export type GtkxConfigFnPromise = (env: GtkxConfigEnv) => Promise<GtkxConfig>;
-export type GtkxConfigExport = GtkxConfig | Promise<GtkxConfig> | GtkxConfigFn | GtkxConfigFnPromise;
-export declare function defineConfig(config: GtkxConfig): GtkxConfig;
-export declare function defineConfig(config: Promise<GtkxConfig>): Promise<GtkxConfig>;
-export declare function defineConfig(config: GtkxConfigFn): GtkxConfigFn;
-export declare function defineConfig(config: GtkxConfigFnPromise): GtkxConfigFnPromise;
-export declare function defineConfig(config: GtkxConfigExport): GtkxConfigExport;
-export declare const mergeConfig: (base: GtkxConfig, override: GtkxConfig) => GtkxConfig;
-export type ResolvedGtkxConfig = {
-    libraries: typeof LIBRARIES_WILDCARD | string[];
-    girPath: string[];
-    applicationId: string | undefined;
-    containerProps: PerElementPropRows<ContainerPropRow>;
-    arrayProps: PerElementPropRows<ArrayPropRow>;
-    objectProps: PerElementPropRows<ObjectPropRow>;
-    virtualProps: PerElementPropRows<VirtualPropRow>;
-    elementMap: ElementMapRule[];
+export declare const resolveReactCompilerOptions: (setting: Config["reactCompiler"]) => ResolvedReactCompilerOptions | null;
+declare const configSchema: z.ZodObject<{
+    libraries: z.ZodOptional<z.ZodCustom<"*" | string[], "*" | string[]>>;
+    girPath: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    applicationId: z.ZodCustom<string, string>;
+    elementProps: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        kind: z.ZodLiteral<"container">;
+        prop: z.ZodString;
+        child: z.ZodString;
+        append: z.ZodOptional<z.ZodCustom<import("./element-props.js").Call, import("./element-props.js").Call>>;
+        remove: z.ZodOptional<z.ZodCustom<import("./element-props.js").Call, import("./element-props.js").Call>>;
+        insert: z.ZodOptional<z.ZodCustom<import("./element-props.js").Call, import("./element-props.js").Call>>;
+        reorder: z.ZodOptional<z.ZodCustom<import("./element-props.js").Call, import("./element-props.js").Call>>;
+        autowrap: z.ZodOptional<z.ZodString>;
+        adopt: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<true>, z.ZodString]>>;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"value">;
+        prop: z.ZodString;
+        call: z.ZodCustom<import("./element-props.js").Call, import("./element-props.js").Call>;
+        after: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"controlled-text">;
+        prop: z.ZodString;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"lazy">;
+        prop: z.ZodString;
+        lookup: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"list">;
+        prop: z.ZodString;
+        add: z.ZodUnion<readonly [z.ZodCustom<import("./element-props.js").Call, import("./element-props.js").Call>, z.ZodArray<z.ZodCustom<import("./element-props.js").Call, import("./element-props.js").Call>>]>;
+        remove: z.ZodOptional<z.ZodCustom<import("./element-props.js").Call, import("./element-props.js").Call>>;
+        clear: z.ZodOptional<z.ZodCustom<import("./element-props.js").Call, import("./element-props.js").Call>>;
+    }, z.core.$strict>], "kind">>>>;
+    reactCompiler: z.ZodOptional<z.ZodCustom<boolean | ReactCompilerOptions, boolean | ReactCompilerOptions>>;
+    codegen: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+/**
+ * User-facing configuration for a GTKX project, as authored in `gtkx.config.ts`:
+ * the GIR libraries to bind, extra `.gir` search paths, the GApplication id,
+ * custom element prop mappings, and the React Compiler and codegen settings.
+ */
+export type Config = z.infer<typeof configSchema>;
+export declare const validateConfig: (config: Config) => void;
+/**
+ * Identity helper that returns the given configuration typed as {@link Config},
+ * enabling editor autocompletion and type checking in `gtkx.config.ts`.
+ */
+export declare const defineConfig: DefineConfig<Config>;
+/**
+ * Deep-merges two configurations, with `override` taking precedence over `base`.
+ * @param base The lower-priority configuration.
+ * @param override The higher-priority configuration whose values win on conflict.
+ */
+export declare const mergeConfig: (base: Config, override: Config) => Config;
+/**
+ * Configuration reduced to the values needed at runtime: the GApplication
+ * identifier and the resolved React Compiler options (`null` when disabled).
+ */
+export type ResolvedConfig = {
+    applicationId: string;
     reactCompiler: ResolvedReactCompilerOptions | null;
 };
-export declare const resolveGtkxConfig: (config: GtkxConfig) => ResolvedGtkxConfig;
+export declare const resolveConfig: (config: Config) => ResolvedConfig;
+export {};
 //# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AACA,OAAO,EACH,KAAK,YAAY,EACjB,KAAK,gBAAgB,EACrB,KAAK,cAAc,EACnB,KAAK,aAAa,EAClB,KAAK,kBAAkB,EACvB,KAAK,aAAa,EAClB,KAAK,cAAc,EAMtB,MAAM,mBAAmB,CAAC;AAE3B,eAAO,MAAM,kBAAkB,MAAM,CAAC;AAEtC,eAAO,MAAM,qBAAqB,EAAE,MAA+C,CAAC;AAEpF,MAAM,MAAM,UAAU,GAAG,aAAa,GAAG;IACrC,SAAS,CAAC,EAAE,OAAO,kBAAkB,GAAG,MAAM,EAAE,CAAC;IAEjD,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IAEnB,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB,aAAa,CAAC,EAAE,OAAO,GAAG,oBAAoB,CAAC;CAClD,CAAC;AAEF,MAAM,MAAM,4BAA4B,GAAG,OAAO,GAAG,QAAQ,GAAG,YAAY,GAAG,KAAK,CAAC;AAErF,MAAM,MAAM,2BAA2B,GAAG,MAAM,GAAG,iBAAiB,GAAG,YAAY,CAAC;AAEpF,MAAM,MAAM,oBAAoB,GAAG;IAC/B,eAAe,CAAC,EAAE,4BAA4B,CAAC;IAC/C,cAAc,CAAC,EAAE,2BAA2B,CAAC;CAChD,CAAC;AAEF,MAAM,MAAM,4BAA4B,GAAG,oBAAoB,GAAG;IAC9D,MAAM,EAAE,IAAI,CAAC;CAChB,CAAC;AAIF,eAAO,MAAM,2BAA2B,GACpC,SAAS,UAAU,CAAC,eAAe,CAAC,KACrC,4BAA4B,GAAG,IAIjC,CAAC;AAiEF,eAAO,MAAM,kBAAkB,GAAI,QAAQ,UAAU,KAAG,IAUvD,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG;IACxB,IAAI,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG,CAAC,GAAG,EAAE,aAAa,KAAK,UAAU,CAAC;AAE9D,MAAM,MAAM,mBAAmB,GAAG,CAAC,GAAG,EAAE,aAAa,KAAK,OAAO,CAAC,UAAU,CAAC,CAAC;AAE9E,MAAM,MAAM,gBAAgB,GAAG,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC,GAAG,YAAY,GAAG,mBAAmB,CAAC;AAErG,wBAAgB,YAAY,CAAC,MAAM,EAAE,UAAU,GAAG,UAAU,CAAC;AAC7D,wBAAgB,YAAY,CAAC,MAAM,EAAE,OAAO,CAAC,UAAU,CAAC,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;AAC/E,wBAAgB,YAAY,CAAC,MAAM,EAAE,YAAY,GAAG,YAAY,CAAC;AACjE,wBAAgB,YAAY,CAAC,MAAM,EAAE,mBAAmB,GAAG,mBAAmB,CAAC;AAC/E,wBAAgB,YAAY,CAAC,MAAM,EAAE,gBAAgB,GAAG,gBAAgB,CAAC;AAsBzE,eAAO,MAAM,WAAW,GAAI,MAAM,UAAU,EAAE,UAAU,UAAU,KAAG,UACnB,CAAC;AAEnD,MAAM,MAAM,kBAAkB,GAAG;IAC7B,SAAS,EAAE,OAAO,kBAAkB,GAAG,MAAM,EAAE,CAAC;IAChD,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,aAAa,EAAE,MAAM,GAAG,SAAS,CAAC;IAClC,cAAc,EAAE,kBAAkB,CAAC,gBAAgB,CAAC,CAAC;IACrD,UAAU,EAAE,kBAAkB,CAAC,YAAY,CAAC,CAAC;IAC7C,WAAW,EAAE,kBAAkB,CAAC,aAAa,CAAC,CAAC;IAC/C,YAAY,EAAE,kBAAkB,CAAC,cAAc,CAAC,CAAC;IACjD,UAAU,EAAE,cAAc,EAAE,CAAC;IAC7B,aAAa,EAAE,4BAA4B,GAAG,IAAI,CAAC;CACtD,CAAC;AAEF,eAAO,MAAM,iBAAiB,GAAI,QAAQ,UAAU,KAAG,kBAUrD,CAAC"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAsB,KAAK,YAAY,EAAE,MAAM,KAAK,CAAC;AAE5D,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,eAAO,MAAM,kBAAkB,MAAM,CAAC;AAEtC,eAAO,MAAM,mBAAmB,EAAE,MAA+C,CAAC;AAKlF,eAAO,MAAM,oBAAoB,kBAAmB,MAAM,KAAG,OAK5D,CAAC;AAEF,QAAA,MAAM,iBAAiB,YAAI,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,KAAK,CAAU,CAAC;AAE5E,QAAA,MAAM,gBAAgB,YAAI,MAAM,EAAE,iBAAiB,EAAE,YAAY,CAAU,CAAC;AAE5E,KAAK,4BAA4B,GAAG,CAAC,OAAO,iBAAiB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEvE,KAAK,2BAA2B,GAAG,CAAC,OAAO,gBAAgB,CAAC,CAAC,MAAM,CAAC,CAAC;AAErE,KAAK,oBAAoB,GAAG;IACxB,eAAe,CAAC,EAAE,4BAA4B,CAAC;IAC/C,cAAc,CAAC,EAAE,2BAA2B,CAAC;CAChD,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,4BAA4B,GAAG,oBAAoB,GAAG;IAC9D,MAAM,EAAE,IAAI,CAAC;CAChB,CAAC;AAIF,eAAO,MAAM,2BAA2B,YAAa,MAAM,CAAC,eAAe,CAAC,KAAG,4BAA4B,GAAG,IAI7G,CAAC;AAwFF,QAAA,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAOhB,CAAC;AAEH;;;;GAIG;AACH,MAAM,MAAM,MAAM,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC;AAElD,eAAO,MAAM,cAAc,WAAY,MAAM,KAAG,IAG/C,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,YAAY,EAAE,YAAY,CAAC,MAAM,CAAgC,CAAC;AAE/E;;;;GAIG;AACH,eAAO,MAAM,WAAW,SAAU,MAAM,YAAY,MAAM,KAAG,MAA8B,CAAC;AAE5F;;;GAGG;AACH,MAAM,MAAM,cAAc,GAAG;IACzB,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,4BAA4B,GAAG,IAAI,CAAC;CACtD,CAAC;AAEF,eAAO,MAAM,aAAa,WAAY,MAAM,KAAG,cAG7C,CAAC"}

package/dist/config.js

@@ -1,7 +1,19 @@
-import { isValidApplicationId } from "@gtkx/utils";
-import { validateArrayPropRows, validateContainerPropRows, validateElementMap, validateObjectPropRows, validateVirtualPropRows, } from "./table-schema.js";
+import { createDefineConfig } from "c12";
+import { defu } from "defu";
+import { z } from "zod";
+import { configError, elementPropsSchema, isRecord, rawIssue } from "./element-props.js";
 export const LIBRARIES_WILDCARD = "*";
-export const GIR_NAMESPACE_PATTERN = /^[A-Za-z][A-Za-z0-9]*-\d+(?:\.\d+)*$/;
+export const GIR_LIBRARY_PATTERN = /^[A-Za-z][A-Za-z0-9]*-\d+(?:\.\d+)*$/;
+const APPLICATION_ID_PATTERN = /^[A-Za-z_][A-Za-z0-9_-]*(\.[A-Za-z_][A-Za-z0-9_-]*)+$/;
+const APPLICATION_ID_MAX_LENGTH = 255;
+export const isValidApplicationId = (applicationId) => {
+    if (applicationId.length === 0 || applicationId.length > APPLICATION_ID_MAX_LENGTH) {
+        return false;
+    }
+    return APPLICATION_ID_PATTERN.test(applicationId);
+};
+const COMPILATION_MODES = ["infer", "syntax", "annotation", "all"];
+const PANIC_THRESHOLDS = ["none", "critical_errors", "all_errors"];
 const REACT_COMPILER_TARGET = "19";
 export const resolveReactCompilerOptions = (setting) => {
     if (setting === false)
@@ -9,96 +21,77 @@ export const resolveReactCompilerOptions = (setting) => {
     const overrides = setting === undefined || setting === true ? {} : setting;
     return { ...overrides, target: REACT_COMPILER_TARGET };
 };
-const validateLibraryEntry = (library) => {
-    if (typeof library === "string" && GIR_NAMESPACE_PATTERN.test(library)) {
+const COMPILATION_MODE_SET = new Set(COMPILATION_MODES);
+const PANIC_THRESHOLD_SET = new Set(PANIC_THRESHOLDS);
+const librariesSchema = z.custom().check((ctx) => {
+    const value = ctx.value;
+    if (value === LIBRARIES_WILDCARD)
         return;
-    }
-    if (library === LIBRARIES_WILDCARD) {
-        throw new Error('gtkx.config.ts: to generate every library, set `libraries: "*"` as a bare string, not an array entry');
-    }
-    throw new Error(`gtkx.config.ts: invalid library identifier "${String(library)}" — must be of the form "Name-Version" (e.g. "Gtk-4.0")`);
-};
-const validateLibraries = (libraries) => {
-    if (libraries === undefined || libraries === LIBRARIES_WILDCARD) {
+    if (!Array.isArray(value) || value.length === 0) {
+        ctx.issues.push(rawIssue(value, [], `must be "${LIBRARIES_WILDCARD}", a non-empty string array, or omitted`));
         return;
     }
-    if (!Array.isArray(libraries) || libraries.length === 0) {
-        throw new Error('gtkx.config.ts: `libraries` must be "*", a non-empty string array, or omitted');
-    }
-    for (const library of libraries) {
-        validateLibraryEntry(library);
-    }
-};
-const validateGirPath = (girPath) => {
-    if (girPath !== undefined && !Array.isArray(girPath)) {
-        throw new Error("gtkx.config.ts: `girPath` must be an array of strings if provided");
+    value.forEach((entry, index) => {
+        if (typeof entry === "string" && GIR_LIBRARY_PATTERN.test(entry))
+            return;
+        if (entry === LIBRARIES_WILDCARD) {
+            ctx.issues.push(rawIssue(value, [index], `to generate every library, set \`libraries: "${LIBRARIES_WILDCARD}"\` as a bare string, not an array entry`, true));
+            return;
+        }
+        ctx.issues.push(rawIssue(value, [index], `invalid library identifier "${String(entry)}", must be of the form "Name-Version" (e.g. "Gtk-4.0")`, true));
+    });
+});
+const applicationIdSchema = z.custom().check((ctx) => {
+    const value = ctx.value;
+    if (typeof value !== "string" || !isValidApplicationId(value)) {
+        ctx.issues.push(rawIssue(value, [], `invalid \`applicationId\` "${String(value)}", must satisfy g_application_id_is_valid (e.g. "org.example.MyApp")`, true));
     }
-};
-const validateApplicationId = (applicationId) => {
-    if (applicationId === undefined)
+});
+const reactCompilerSchema = z.custom().check((ctx) => {
+    const value = ctx.value;
+    if (typeof value === "boolean")
         return;
-    if (typeof applicationId !== "string" || !isValidApplicationId(applicationId)) {
-        throw new Error(`gtkx.config.ts: invalid \`applicationId\` "${String(applicationId)}" — ` +
-            `must satisfy g_application_id_is_valid (e.g. "org.example.MyApp")`);
-    }
-};
-const REACT_COMPILER_COMPILATION_MODES = ["infer", "syntax", "annotation", "all"];
-const REACT_COMPILER_PANIC_THRESHOLDS = ["none", "critical_errors", "all_errors"];
-const validateReactCompilerEnum = (value, allowed, field) => {
-    if (value !== undefined && !allowed.includes(value)) {
-        throw new Error(`gtkx.config.ts: invalid \`reactCompiler.${field}\` "${String(value)}" — must be one of ${allowed.join(", ")}`);
-    }
-};
-const validateReactCompiler = (reactCompiler) => {
-    if (reactCompiler === undefined || typeof reactCompiler === "boolean")
+    if (!isRecord(value)) {
+        ctx.issues.push(rawIssue(value, [], "must be a boolean or an options object"));
         return;
-    if (typeof reactCompiler !== "object" || reactCompiler === null || Array.isArray(reactCompiler)) {
-        throw new Error("gtkx.config.ts: `reactCompiler` must be a boolean or an options object");
     }
-    validateReactCompilerEnum(reactCompiler.compilationMode, REACT_COMPILER_COMPILATION_MODES, "compilationMode");
-    validateReactCompilerEnum(reactCompiler.panicThreshold, REACT_COMPILER_PANIC_THRESHOLDS, "panicThreshold");
-};
-export const validateGtkxConfig = (config) => {
-    validateLibraries(config.libraries);
-    validateGirPath(config.girPath);
-    validateApplicationId(config.applicationId);
-    validateContainerPropRows(config.containerProps);
-    validateArrayPropRows(config.arrayProps);
-    validateObjectPropRows(config.objectProps);
-    validateVirtualPropRows(config.virtualProps);
-    validateElementMap(config.elementMap);
-    validateReactCompiler(config.reactCompiler);
-};
-export function defineConfig(config) {
-    return config;
-}
-const isMergeableObject = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
-const mergeConfigValue = (base, override) => {
-    if (override === undefined)
-        return base;
-    if (base === undefined)
-        return override;
-    if (Array.isArray(base) && Array.isArray(override))
-        return [...base, ...override];
-    if (isMergeableObject(base) && isMergeableObject(override)) {
-        const merged = { ...base };
-        for (const key of Object.keys(override)) {
-            merged[key] = mergeConfigValue(base[key], override[key]);
-        }
-        return merged;
+    const compilationMode = value.compilationMode;
+    if (compilationMode !== undefined &&
+        !(typeof compilationMode === "string" && COMPILATION_MODE_SET.has(compilationMode))) {
+        ctx.issues.push(rawIssue(value, [], `invalid \`reactCompiler.compilationMode\` "${String(compilationMode)}", must be one of ${COMPILATION_MODES.join(", ")}`, true));
+    }
+    const panicThreshold = value.panicThreshold;
+    if (panicThreshold !== undefined &&
+        !(typeof panicThreshold === "string" && PANIC_THRESHOLD_SET.has(panicThreshold))) {
+        ctx.issues.push(rawIssue(value, [], `invalid \`reactCompiler.panicThreshold\` "${String(panicThreshold)}", must be one of ${PANIC_THRESHOLDS.join(", ")}`, true));
     }
-    return override;
+});
+const configSchema = z.object({
+    libraries: librariesSchema.optional(),
+    girPath: z.array(z.string(), { error: "must be an array of strings if provided" }).optional(),
+    applicationId: applicationIdSchema,
+    elementProps: elementPropsSchema.optional(),
+    reactCompiler: reactCompilerSchema.optional(),
+    codegen: z.boolean({ error: "must be a boolean" }).optional(),
+});
+export const validateConfig = (config) => {
+    const result = configSchema.safeParse(config);
+    if (!result.success)
+        throw configError(result.error);
 };
-export const mergeConfig = (base, override) => mergeConfigValue(base, override);
-export const resolveGtkxConfig = (config) => ({
-    libraries: config.libraries ?? [],
-    girPath: config.girPath ?? [],
+/**
+ * Identity helper that returns the given configuration typed as {@link Config},
+ * enabling editor autocompletion and type checking in `gtkx.config.ts`.
+ */
+export const defineConfig = createDefineConfig();
+/**
+ * Deep-merges two configurations, with `override` taking precedence over `base`.
+ * @param base The lower-priority configuration.
+ * @param override The higher-priority configuration whose values win on conflict.
+ */
+export const mergeConfig = (base, override) => defu(override, base);
+export const resolveConfig = (config) => ({
     applicationId: config.applicationId,
-    containerProps: config.containerProps ?? {},
-    arrayProps: config.arrayProps ?? {},
-    objectProps: config.objectProps ?? {},
-    virtualProps: config.virtualProps ?? {},
-    elementMap: config.elementMap ?? [],
     reactCompiler: resolveReactCompilerOptions(config.reactCompiler),
 });
 //# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -1 +1 @@
-{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"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","sourcesContent":["import { createDefineConfig, type DefineConfig } from \"c12\";\nimport { defu } from \"defu\";\nimport { z } from \"zod\";\nimport { configError, elementPropsSchema, isRecord, rawIssue } from \"./element-props.js\";\n\nexport const LIBRARIES_WILDCARD = \"*\";\n\nexport const GIR_LIBRARY_PATTERN: RegExp = /^[A-Za-z][A-Za-z0-9]*-\\d+(?:\\.\\d+)*$/;\n\nconst APPLICATION_ID_PATTERN = /^[A-Za-z_][A-Za-z0-9_-]*(\\.[A-Za-z_][A-Za-z0-9_-]*)+$/;\nconst APPLICATION_ID_MAX_LENGTH = 255;\n\nexport const isValidApplicationId = (applicationId: string): boolean => {\n    if (applicationId.length === 0 || applicationId.length > APPLICATION_ID_MAX_LENGTH) {\n        return false;\n    }\n    return APPLICATION_ID_PATTERN.test(applicationId);\n};\n\nconst COMPILATION_MODES = [\"infer\", \"syntax\", \"annotation\", \"all\"] as const;\n\nconst PANIC_THRESHOLDS = [\"none\", \"critical_errors\", \"all_errors\"] as const;\n\ntype ReactCompilerCompilationMode = (typeof COMPILATION_MODES)[number];\n\ntype ReactCompilerPanicThreshold = (typeof PANIC_THRESHOLDS)[number];\n\ntype ReactCompilerOptions = {\n    compilationMode?: ReactCompilerCompilationMode;\n    panicThreshold?: ReactCompilerPanicThreshold;\n};\n\n/**\n * React Compiler options resolved for the build, with the compilation target\n * fixed to React 19.\n */\nexport type ResolvedReactCompilerOptions = ReactCompilerOptions & {\n    target: \"19\";\n};\n\nconst REACT_COMPILER_TARGET = \"19\";\n\nexport const resolveReactCompilerOptions = (setting: Config[\"reactCompiler\"]): ResolvedReactCompilerOptions | null => {\n    if (setting === false) return null;\n    const overrides = setting === undefined || setting === true ? {} : setting;\n    return { ...overrides, target: REACT_COMPILER_TARGET };\n};\n\nconst COMPILATION_MODE_SET: Set<string> = new Set(COMPILATION_MODES);\n\nconst PANIC_THRESHOLD_SET: Set<string> = new Set(PANIC_THRESHOLDS);\n\nconst librariesSchema = z.custom<typeof LIBRARIES_WILDCARD | string[]>().check((ctx) => {\n    const value = ctx.value;\n    if (value === LIBRARIES_WILDCARD) return;\n    if (!Array.isArray(value) || value.length === 0) {\n        ctx.issues.push(rawIssue(value, [], `must be \"${LIBRARIES_WILDCARD}\", a non-empty string array, or omitted`));\n        return;\n    }\n    value.forEach((entry, index) => {\n        if (typeof entry === \"string\" && GIR_LIBRARY_PATTERN.test(entry)) return;\n        if (entry === LIBRARIES_WILDCARD) {\n            ctx.issues.push(\n                rawIssue(\n                    value,\n                    [index],\n                    `to generate every library, set \\`libraries: \"${LIBRARIES_WILDCARD}\"\\` as a bare string, not an array entry`,\n                    true,\n                ),\n            );\n            return;\n        }\n        ctx.issues.push(\n            rawIssue(\n                value,\n                [index],\n                `invalid library identifier \"${String(entry)}\", must be of the form \"Name-Version\" (e.g. \"Gtk-4.0\")`,\n                true,\n            ),\n        );\n    });\n});\n\nconst applicationIdSchema = z.custom<string>().check((ctx) => {\n    const value = ctx.value;\n    if (typeof value !== \"string\" || !isValidApplicationId(value)) {\n        ctx.issues.push(\n            rawIssue(\n                value,\n                [],\n                `invalid \\`applicationId\\` \"${String(value)}\", must satisfy g_application_id_is_valid (e.g. \"org.example.MyApp\")`,\n                true,\n            ),\n        );\n    }\n});\n\nconst reactCompilerSchema = z.custom<boolean | ReactCompilerOptions>().check((ctx) => {\n    const value = ctx.value;\n    if (typeof value === \"boolean\") return;\n    if (!isRecord(value)) {\n        ctx.issues.push(rawIssue(value, [], \"must be a boolean or an options object\"));\n        return;\n    }\n    const compilationMode = value.compilationMode;\n    if (\n        compilationMode !== undefined &&\n        !(typeof compilationMode === \"string\" && COMPILATION_MODE_SET.has(compilationMode))\n    ) {\n        ctx.issues.push(\n            rawIssue(\n                value,\n                [],\n                `invalid \\`reactCompiler.compilationMode\\` \"${String(compilationMode)}\", must be one of ${COMPILATION_MODES.join(\", \")}`,\n                true,\n            ),\n        );\n    }\n    const panicThreshold = value.panicThreshold;\n    if (\n        panicThreshold !== undefined &&\n        !(typeof panicThreshold === \"string\" && PANIC_THRESHOLD_SET.has(panicThreshold))\n    ) {\n        ctx.issues.push(\n            rawIssue(\n                value,\n                [],\n                `invalid \\`reactCompiler.panicThreshold\\` \"${String(panicThreshold)}\", must be one of ${PANIC_THRESHOLDS.join(\", \")}`,\n                true,\n            ),\n        );\n    }\n});\n\nconst configSchema = z.object({\n    libraries: librariesSchema.optional(),\n    girPath: z.array(z.string(), { error: \"must be an array of strings if provided\" }).optional(),\n    applicationId: applicationIdSchema,\n    elementProps: elementPropsSchema.optional(),\n    reactCompiler: reactCompilerSchema.optional(),\n    codegen: z.boolean({ error: \"must be a boolean\" }).optional(),\n});\n\n/**\n * User-facing configuration for a GTKX project, as authored in `gtkx.config.ts`:\n * the GIR libraries to bind, extra `.gir` search paths, the GApplication id,\n * custom element prop mappings, and the React Compiler and codegen settings.\n */\nexport type Config = z.infer<typeof configSchema>;\n\nexport const validateConfig = (config: Config): void => {\n    const result = configSchema.safeParse(config);\n    if (!result.success) throw configError(result.error);\n};\n\n/**\n * Identity helper that returns the given configuration typed as {@link Config},\n * enabling editor autocompletion and type checking in `gtkx.config.ts`.\n */\nexport const defineConfig: DefineConfig<Config> = createDefineConfig<Config>();\n\n/**\n * Deep-merges two configurations, with `override` taking precedence over `base`.\n * @param base The lower-priority configuration.\n * @param override The higher-priority configuration whose values win on conflict.\n */\nexport const mergeConfig = (base: Config, override: Config): Config => defu(override, base);\n\n/**\n * Configuration reduced to the values needed at runtime: the GApplication\n * identifier and the resolved React Compiler options (`null` when disabled).\n */\nexport type ResolvedConfig = {\n    applicationId: string;\n    reactCompiler: ResolvedReactCompilerOptions | null;\n};\n\nexport const resolveConfig = (config: Config): ResolvedConfig => ({\n    applicationId: config.applicationId,\n    reactCompiler: resolveReactCompilerOptions(config.reactCompiler),\n});\n"]}