@gtkx/config 2.0.0-beta.10 → 2.0.0-beta.11

package/README.md

@@ -1,177 +1,19 @@
-<p align="center">
-  <img src="https://raw.githubusercontent.com/gtkx-org/gtkx/main/logo.svg" alt="GTKX" width="100" />
-</p>
+# @gtkx/config
 
-<h1 align="center">GTKX</h1>
+Typed application configuration for GTKX.
 
-<p align="center">
-  The React framework for Linux.<br />
-  Write native GNOME applications with React and TypeScript.
-  Real Adwaita and GTK4 widgets with standard web tooling.
-</p>
+Use `defineConfig` in `gtkx.config.ts` to declare the application ID, native libraries, resources, and deployment settings. The CLI loads this configuration for development, code generation, and builds.
 
-<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%A526.7-339933?logo=node.js&logoColor=white" alt="Node >= 26.7" />
-  <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>
+```ts
+import { defineConfig } from "@gtkx/config";
 
-<p align="center">
-  <a href="https://gtkx.dev">Homepage</a> &middot;
-  <a href="https://gtkx.dev/guide/getting-started">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>
-
----
-
-<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>
-
-<p align="center">
-  <em>The Tasks app you build in the <a href="https://gtkx.dev/tutorial/">tutorial</a>.</em>
-</p>
-
-## Demo
-
-This app starts with an Adwaita application shell, renders native GTK4 widgets inside it, and uses ordinary React hooks and events:
-
-```tsx
-import * as Gtk from "@gtkx/gi/gtk";
-import { AdwApplication, AdwApplicationWindow, AdwHeaderBar, AdwToolbarView } from "@gtkx/jsx/adw";
-import { 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 (
-    <AdwApplicationWindow
-      title="Hello GTKX"
-      defaultWidth={400}
-      defaultHeight={300}
-      onCloseRequest={quit}
-    >
-      <AdwToolbarView topBar={<AdwHeaderBar />}>
-        <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: ${String(count)}`}</GtkLabel>
-          <GtkButton
-            label="Increment"
-            onClicked={() => setCount((c) => c + 1)}
-            cssClasses={["suggested-action", "pill"]}
-          />
-        </GtkBox>
-      </AdwToolbarView>
-    </AdwApplicationWindow>
-  );
-};
-
-const App = () => (
-  <AdwApplication>
-    <Counter />
-  </AdwApplication>
-);
-
-createRoot().render(<App />);
-```
-
-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.
-
-## Why GTKX
-
-### Adwaita-first application development
-
-GTKX uses Adwaita as the foundation for applications, windows, navigation, dialogs, and adaptive layouts, with the complete GTK4 toolkit underneath. It adds a declarative React layer and an integrated TypeScript toolchain to the GNOME platform:
-
-- 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, React Hook Form-powered Adwaita controls, gettext-backed react-i18next localization, React Spring animations, React Navigation stack, tab, drawer, and split view navigators, 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.
-
-### Native GNOME widgets, without a compatibility layer
-
-React Native and similar frameworks hide the native toolkit so one API can run everywhere. GTKX renders real Adwaita and GTK4 widgets and exposes any other GObject-Introspection library on your system. It is GNOME-native and Linux-only by design.
-
-### Why Node.js, and why generated bindings
-
-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 what running on Node.js means day to day.
-
-GTKX generates the TypeScript types and native FFI calls from the same GObject-Introspection data, so the types cannot drift from the calls they back. `Adw-1` is the sole default GIR root; its GIR include pulls in `Gtk-4.0`, so codegen covers both complete API surfaces. Neither belongs in a GTKX 2 `libraries` list.
-
-At runtime, the native Rust core calls straight into the system Adwaita, GTK4, and GLib libraries through libffi, without loading libgirepository at all.
-
-## Quick start
-
-GTKX is Linux-only and needs Node.js 26.7 or later. See [Requirements](#requirements).
-
-Scaffold a new app with the `create-gtkx` initializer:
-
-```sh
-npm create gtkx@beta
+export default defineConfig({
+    applicationId: "com.example.MyApp",
+});
 ```
 
-The same command works with other package managers: `pnpm create gtkx@beta` or `yarn create gtkx@beta`.
-
-Then run your new app:
-
-```sh
-cd my-app
-npm run dev
-```
-
-To go further, follow the [tutorial](https://gtkx.dev/tutorial/).
-
-## Documentation
-
-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 Adwaita (1.8 or later), GTK4 (4.20 or later), and GLib development libraries
-- Node.js 26.7 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 Adwaita counter above.
-- [`gtk-demo`](https://github.com/gtkx-org/gtkx/tree/main/examples/gtk-demo): the official GTK4 widget showcase in an Adwaita application shell, covering lists, dialogs, gestures, CSS, and OpenGL.
-- [`browser`](https://github.com/gtkx-org/gtkx/tree/main/examples/browser): an Adwaita browser built around `WebKitWebView`.
-- [`animations`](https://github.com/gtkx-org/gtkx/tree/main/examples/animations): an Adwaita showcase for `@gtkx/animated`, with React Spring animations driven by the GTK frame clock.
-- [`navigation`](https://github.com/gtkx-org/gtkx/tree/main/examples/navigation): a tour of `@gtkx/navigation`, React Navigation's stack, tab, and drawer navigators rendered with libadwaita.
-- [`tutorial`](https://github.com/gtkx-org/gtkx/tree/main/examples/tutorial): the Tasks app the documentation builds.
-
-## Status
-
-GTKX is stable and ready for production use.
-
-## 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 26.7 or later, pnpm, and a Rust toolchain.
+[Guide](https://gtkx.dev/v2/guide/configuration-and-codegen) · [API reference](https://gtkx.dev/v2/reference/@gtkx/config/) · [GTKX](https://gtkx.dev)
 
-## License
+GTKX runs on Linux with Node.js and system native libraries. See [Getting Started](https://gtkx.dev/v2/guide/getting-started) for supported versions and installation. This README describes the 2.0 beta.
 
-GTKX is licensed under [MPL-2.0](https://github.com/gtkx-org/gtkx/blob/main/LICENSE).
+[MPL-2.0](https://github.com/gtkx-org/gtkx/blob/main/LICENSE).

package/dist/config-dependencies.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config-dependencies.d.ts","sourceRoot":"","sources":["../src/config-dependencies.ts"],"names":[],"mappings":"AAAA,OAAO,EAAyB,KAAK,gBAAgB,EAAE,KAAK,eAAe,EAAE,MAAM,MAAM,CAAC;AAO1F,KAAK,cAAc,CAAC,CAAC,IAAI;IAAE,YAAY,EAAE,MAAM,EAAE,CAAC;IAAC,KAAK,EAAE,CAAC,CAAA;CAAE,CAAC;AAuD9D,QAAA,MAAM,qBAAqB,GAAI,SAAS,gBAAgB,KAAG,eAY1D,CAAC;AAEF,QAAA,MAAM,qBAAqB,GAAI,OAAO,MAAM,EAAE,cAAc,QAAQ,CAAC,MAAM,CAAC,KAAG,IAI9E,CAAC;AAEF,QAAA,MAAM,qBAAqB,GAAI,OAAO,OAAO,KAAG,MAAM,EACqC,CAAC;AAE5F,QAAA,MAAM,yBAAyB,GAAU,CAAC,EAAE,WAAW,MAAM,OAAO,CAAC,CAAC,CAAC,KAAG,OAAO,CAAC,cAAc,CAAC,CAAC,CAAC,CAqBlG,CAAC;AAEF,OAAO,EACH,yBAAyB,EACzB,qBAAqB,EACrB,qBAAqB,EACrB,qBAAqB,GACxB,CAAC"}
+{"version":3,"file":"config-dependencies.d.ts","sourceRoot":"","sources":["../src/config-dependencies.ts"],"names":[],"mappings":"AAAA,OAAO,EAAyB,KAAK,gBAAgB,EAAE,KAAK,eAAe,EAAE,MAAM,MAAM,CAAC;AAO1F,KAAK,cAAc,CAAC,CAAC,IAAI;IAAE,YAAY,EAAE,MAAM,EAAE,CAAC;IAAC,KAAK,EAAE,CAAC,CAAA;CAAE,CAAC;AAyD9D,QAAA,MAAM,qBAAqB,GAAI,SAAS,gBAAgB,KAAG,eAY1D,CAAC;AAEF,QAAA,MAAM,qBAAqB,GAAI,OAAO,MAAM,EAAE,cAAc,QAAQ,CAAC,MAAM,CAAC,KAAG,IAI9E,CAAC;AAEF,QAAA,MAAM,qBAAqB,GAAI,OAAO,OAAO,KAAG,MAAM,EACqC,CAAC;AAE5F,QAAA,MAAM,yBAAyB,GAAU,CAAC,EAAE,WAAW,MAAM,OAAO,CAAC,CAAC,CAAC,KAAG,OAAO,CAAC,cAAc,CAAC,CAAC,CAAC,CAqBlG,CAAC;AAEF,OAAO,EACH,yBAAyB,EACzB,qBAAqB,EACrB,qBAAqB,EACrB,qBAAqB,GACxB,CAAC"}

package/dist/config-dependencies.js

@@ -18,7 +18,8 @@ const addUrl = (url) => {
     }
 };
 const cacheBustedUrl = (url) => {
-    if (!url.startsWith("file:")) {
+    const state = captureStorage.getStore();
+    if (state === undefined || !url.startsWith("file:")) {
         return url;
     }
     const path = fileURLToPath(url);
@@ -26,7 +27,7 @@ const cacheBustedUrl = (url) => {
         return url;
     }
     const parsed = new URL(url);
-    parsed.searchParams.set("gtkx-config-load", captureStorage.getStore()?.cacheKey ?? "uncaptured");
+    parsed.searchParams.set("gtkx-config-load", state.cacheKey);
     return parsed.href;
 };
 const registerResolutionHook = () => registerHooks({

package/dist/config-dependencies.js.map

@@ -1 +1 @@
-{"version":3,"file":"config-dependencies.js","sourceRoot":"","sources":["../src/config-dependencies.ts"],"names":[],"mappings":"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","sourcesContent":["import { createJiti, type Jiti, type TransformOptions, type TransformResult } from \"jiti\";\nimport { AsyncLocalStorage } from \"node:async_hooks\";\nimport { createRequire, registerHooks } from \"node:module\";\nimport { extname, sep } from \"node:path\";\nimport { fileURLToPath } from \"node:url\";\n\ntype CaptureState = { cacheKey: string; dependencies: Set<string>; transformer: Jiti };\ntype CapturedConfig<T> = { dependencies: string[]; value: T };\n\nconst captureStorage: AsyncLocalStorage<CaptureState> = new AsyncLocalStorage();\nconst dependenciesByValue: WeakMap<object, string[]> = new WeakMap();\nconst CACHE_BUSTED_EXTENSIONS: ReadonlySet<string> = new Set([\".cjs\", \".js\", \".json\", \".mjs\"]);\n\nconst isTrackedPath = (path: string): boolean => !path.includes(`${sep}node_modules${sep}`);\n\nconst addPath = (path: string): void => {\n    if (isTrackedPath(path)) {\n        captureStorage.getStore()?.dependencies.add(path);\n    }\n};\n\nconst addUrl = (url: string): void => {\n    if (url.startsWith(\"file:\")) {\n        addPath(fileURLToPath(url));\n    }\n};\n\nconst cacheBustedUrl = (url: string): string => {\n    if (!url.startsWith(\"file:\")) {\n        return url;\n    }\n\n    const path = fileURLToPath(url);\n\n    if (!isTrackedPath(path) || !CACHE_BUSTED_EXTENSIONS.has(extname(path))) {\n        return url;\n    }\n\n    const parsed = new URL(url);\n    parsed.searchParams.set(\"gtkx-config-load\", captureStorage.getStore()?.cacheKey ?? \"uncaptured\");\n\n    return parsed.href;\n};\n\nconst registerResolutionHook = (): ReturnType<typeof registerHooks> =>\n    registerHooks({\n        resolve(specifier, context, nextResolve) {\n            const result = nextResolve(specifier, context);\n            addUrl(result.url);\n\n            return { ...result, url: cacheBustedUrl(result.url) };\n        },\n    });\n\nconst clearNativeModuleCache = (dependencies: Iterable<string>): void => {\n    const cache = createRequire(import.meta.url).cache;\n\n    for (const path of dependencies) {\n        Reflect.deleteProperty(cache, path);\n    }\n};\n\nconst transformConfigModule = (options: TransformOptions): TransformResult => {\n    const state = captureStorage.getStore();\n\n    if (state === undefined) {\n        throw new Error(\"Configuration transformation started outside a dependency capture\");\n    }\n\n    if (options.filename !== undefined) {\n        addPath(options.filename);\n    }\n\n    return { code: state.transformer.transform(options) };\n};\n\nconst setConfigDependencies = (value: object, dependencies: Iterable<string>): void => {\n    const paths = [...new Set(dependencies)];\n    dependenciesByValue.set(value, paths);\n    clearNativeModuleCache(paths);\n};\n\nconst configDependenciesFor = (value: unknown): string[] =>\n    typeof value === \"object\" && value !== null ? dependenciesByValue.get(value) ?? [] : [];\n\nconst captureConfigDependencies = async <T>(operation: () => Promise<T>): Promise<CapturedConfig<T>> => {\n    const state: CaptureState = {\n        cacheKey: process.hrtime.bigint().toString(),\n        dependencies: new Set(),\n        transformer: createJiti(import.meta.url, { fsCache: false, moduleCache: false }),\n    };\n    const hook = registerResolutionHook();\n\n    try {\n        const value = await captureStorage.run(state, operation);\n\n        return { dependencies: [...state.dependencies], value };\n    } catch (error) {\n        if (typeof error === \"object\" && error !== null) {\n            setConfigDependencies(error, state.dependencies);\n        }\n\n        throw error;\n    } finally {\n        hook.deregister();\n    }\n};\n\nexport {\n    captureConfigDependencies,\n    configDependenciesFor,\n    setConfigDependencies,\n    transformConfigModule,\n};\n"]}
+{"version":3,"file":"config-dependencies.js","sourceRoot":"","sources":["../src/config-dependencies.ts"],"names":[],"mappings":"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","sourcesContent":["import { createJiti, type Jiti, type TransformOptions, type TransformResult } from \"jiti\";\nimport { AsyncLocalStorage } from \"node:async_hooks\";\nimport { createRequire, registerHooks } from \"node:module\";\nimport { extname, sep } from \"node:path\";\nimport { fileURLToPath } from \"node:url\";\n\ntype CaptureState = { cacheKey: string; dependencies: Set<string>; transformer: Jiti };\ntype CapturedConfig<T> = { dependencies: string[]; value: T };\n\nconst captureStorage: AsyncLocalStorage<CaptureState> = new AsyncLocalStorage();\nconst dependenciesByValue: WeakMap<object, string[]> = new WeakMap();\nconst CACHE_BUSTED_EXTENSIONS: ReadonlySet<string> = new Set([\".cjs\", \".js\", \".json\", \".mjs\"]);\n\nconst isTrackedPath = (path: string): boolean => !path.includes(`${sep}node_modules${sep}`);\n\nconst addPath = (path: string): void => {\n    if (isTrackedPath(path)) {\n        captureStorage.getStore()?.dependencies.add(path);\n    }\n};\n\nconst addUrl = (url: string): void => {\n    if (url.startsWith(\"file:\")) {\n        addPath(fileURLToPath(url));\n    }\n};\n\nconst cacheBustedUrl = (url: string): string => {\n    const state = captureStorage.getStore();\n\n    if (state === undefined || !url.startsWith(\"file:\")) {\n        return url;\n    }\n\n    const path = fileURLToPath(url);\n\n    if (!isTrackedPath(path) || !CACHE_BUSTED_EXTENSIONS.has(extname(path))) {\n        return url;\n    }\n\n    const parsed = new URL(url);\n    parsed.searchParams.set(\"gtkx-config-load\", state.cacheKey);\n\n    return parsed.href;\n};\n\nconst registerResolutionHook = (): ReturnType<typeof registerHooks> =>\n    registerHooks({\n        resolve(specifier, context, nextResolve) {\n            const result = nextResolve(specifier, context);\n            addUrl(result.url);\n\n            return { ...result, url: cacheBustedUrl(result.url) };\n        },\n    });\n\nconst clearNativeModuleCache = (dependencies: Iterable<string>): void => {\n    const cache = createRequire(import.meta.url).cache;\n\n    for (const path of dependencies) {\n        Reflect.deleteProperty(cache, path);\n    }\n};\n\nconst transformConfigModule = (options: TransformOptions): TransformResult => {\n    const state = captureStorage.getStore();\n\n    if (state === undefined) {\n        throw new Error(\"Configuration transformation started outside a dependency capture\");\n    }\n\n    if (options.filename !== undefined) {\n        addPath(options.filename);\n    }\n\n    return { code: state.transformer.transform(options) };\n};\n\nconst setConfigDependencies = (value: object, dependencies: Iterable<string>): void => {\n    const paths = [...new Set(dependencies)];\n    dependenciesByValue.set(value, paths);\n    clearNativeModuleCache(paths);\n};\n\nconst configDependenciesFor = (value: unknown): string[] =>\n    typeof value === \"object\" && value !== null ? dependenciesByValue.get(value) ?? [] : [];\n\nconst captureConfigDependencies = async <T>(operation: () => Promise<T>): Promise<CapturedConfig<T>> => {\n    const state: CaptureState = {\n        cacheKey: process.hrtime.bigint().toString(),\n        dependencies: new Set(),\n        transformer: createJiti(import.meta.url, { fsCache: false, moduleCache: false }),\n    };\n    const hook = registerResolutionHook();\n\n    try {\n        const value = await captureStorage.run(state, operation);\n\n        return { dependencies: [...state.dependencies], value };\n    } catch (error) {\n        if (typeof error === \"object\" && error !== null) {\n            setConfigDependencies(error, state.dependencies);\n        }\n\n        throw error;\n    } finally {\n        hook.deregister();\n    }\n};\n\nexport {\n    captureConfigDependencies,\n    configDependenciesFor,\n    setConfigDependencies,\n    transformConfigModule,\n};\n"]}

package/dist/config-reloader.d.ts

@@ -0,0 +1,8 @@
+import { type LoadConfigOptions, type LoadedConfig } from "./loader.ts";
+type ConfigReloader = {
+    reload: () => Promise<LoadedConfig>;
+    resolvePaths: () => string[];
+};
+declare const createConfigReloader: (cwd: string, options?: LoadConfigOptions, initialDependencies?: string[]) => Promise<ConfigReloader>;
+export { createConfigReloader };
+//# sourceMappingURL=config-reloader.d.ts.map

package/dist/config-reloader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-reloader.d.ts","sourceRoot":"","sources":["../src/config-reloader.ts"],"names":[],"mappings":"AAEA,OAAO,EAAc,KAAK,iBAAiB,EAAE,KAAK,YAAY,EAAE,MAAM,aAAa,CAAC;AAGpF,KAAK,cAAc,GAAG;IAClB,MAAM,EAAE,MAAM,OAAO,CAAC,YAAY,CAAC,CAAC;IACpC,YAAY,EAAE,MAAM,MAAM,EAAE,CAAC;CAChC,CAAC;AAEF,QAAA,MAAM,oBAAoB,GACtB,KAAK,MAAM,EACX,UAAS,iBAAsB,EAC/B,sBAAqB,MAAM,EAAO,KACnC,OAAO,CAAC,cAAc,CAqCxB,CAAC;AAEF,OAAO,EAAE,oBAAoB,EAAE,CAAC"}

package/dist/config-reloader.js

@@ -0,0 +1,38 @@
+import { relative, resolve } from "node:path";
+import { configDependenciesFor } from "./config-dependencies.js";
+import { loadConfig } from "./loader.js";
+import { resolveConfigDependencies } from "./static-dependencies.js";
+const createConfigReloader = async (cwd, options = {}, initialDependencies = []) => {
+    let selectedConfigFile;
+    let knownDependencies = initialDependencies;
+    if (options.configFile === undefined) {
+        const loaded = await loadConfig(cwd, options);
+        selectedConfigFile = loaded.configFile;
+        knownDependencies = [...knownDependencies, ...configDependenciesFor(loaded)];
+    }
+    else {
+        selectedConfigFile = resolve(cwd, options.configFile);
+    }
+    const selectedConfigName = relative(cwd, selectedConfigFile);
+    const resolvePaths = () => [
+        ...new Set([selectedConfigFile, ...knownDependencies]
+            .flatMap((path) => resolveConfigDependencies(path, selectedConfigName, cwd))),
+    ];
+    return {
+        resolvePaths,
+        reload: async () => {
+            let loaded;
+            try {
+                loaded = await loadConfig(cwd, { ...options, configFile: selectedConfigFile });
+            }
+            catch (error) {
+                knownDependencies = [...new Set([...knownDependencies, ...configDependenciesFor(error)])];
+                throw error;
+            }
+            knownDependencies = configDependenciesFor(loaded);
+            return loaded;
+        },
+    };
+};
+export { createConfigReloader };
+//# sourceMappingURL=config-reloader.js.map

package/dist/config-reloader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-reloader.js","sourceRoot":"","sources":["../src/config-reloader.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAC9C,OAAO,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AACjE,OAAO,EAAE,UAAU,EAA6C,MAAM,aAAa,CAAC;AACpF,OAAO,EAAE,yBAAyB,EAAE,MAAM,0BAA0B,CAAC;AAOrE,MAAM,oBAAoB,GAAG,KAAK,EAC9B,GAAW,EACX,UAA6B,EAAE,EAC/B,sBAAgC,EAAE,EACX,EAAE;IACzB,IAAI,kBAA0B,CAAC;IAC/B,IAAI,iBAAiB,GAAG,mBAAmB,CAAC;IAE5C,IAAI,OAAO,CAAC,UAAU,KAAK,SAAS,EAAE,CAAC;QACnC,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;QAC9C,kBAAkB,GAAG,MAAM,CAAC,UAAU,CAAC;QACvC,iBAAiB,GAAG,CAAC,GAAG,iBAAiB,EAAE,GAAG,qBAAqB,CAAC,MAAM,CAAC,CAAC,CAAC;IACjF,CAAC;SAAM,CAAC;QACJ,kBAAkB,GAAG,OAAO,CAAC,GAAG,EAAE,OAAO,CAAC,UAAU,CAAC,CAAC;IAC1D,CAAC;IAED,MAAM,kBAAkB,GAAG,QAAQ,CAAC,GAAG,EAAE,kBAAkB,CAAC,CAAC;IAC7D,MAAM,YAAY,GAAG,GAAa,EAAE,CAAC;QACjC,GAAG,IAAI,GAAG,CACN,CAAC,kBAAkB,EAAE,GAAG,iBAAiB,CAAC;aACrC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,yBAAyB,CAAC,IAAI,EAAE,kBAAkB,EAAE,GAAG,CAAC,CAAC,CACnF;KACJ,CAAC;IAEF,OAAO;QACH,YAAY;QACZ,MAAM,EAAE,KAAK,IAAI,EAAE;YACf,IAAI,MAAoB,CAAC;YAEzB,IAAI,CAAC;gBACD,MAAM,GAAG,MAAM,UAAU,CAAC,GAAG,EAAE,EAAE,GAAG,OAAO,EAAE,UAAU,EAAE,kBAAkB,EAAE,CAAC,CAAC;YACnF,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACb,iBAAiB,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,iBAAiB,EAAE,GAAG,qBAAqB,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;gBAC1F,MAAM,KAAK,CAAC;YAChB,CAAC;YAED,iBAAiB,GAAG,qBAAqB,CAAC,MAAM,CAAC,CAAC;YAElD,OAAO,MAAM,CAAC;QAClB,CAAC;KACJ,CAAC;AACN,CAAC,CAAC;AAEF,OAAO,EAAE,oBAAoB,EAAE,CAAC","sourcesContent":["import { relative, resolve } from \"node:path\";\nimport { configDependenciesFor } from \"./config-dependencies.ts\";\nimport { loadConfig, type LoadConfigOptions, type LoadedConfig } from \"./loader.ts\";\nimport { resolveConfigDependencies } from \"./static-dependencies.ts\";\n\ntype ConfigReloader = {\n    reload: () => Promise<LoadedConfig>;\n    resolvePaths: () => string[];\n};\n\nconst createConfigReloader = async (\n    cwd: string,\n    options: LoadConfigOptions = {},\n    initialDependencies: string[] = [],\n): Promise<ConfigReloader> => {\n    let selectedConfigFile: string;\n    let knownDependencies = initialDependencies;\n\n    if (options.configFile === undefined) {\n        const loaded = await loadConfig(cwd, options);\n        selectedConfigFile = loaded.configFile;\n        knownDependencies = [...knownDependencies, ...configDependenciesFor(loaded)];\n    } else {\n        selectedConfigFile = resolve(cwd, options.configFile);\n    }\n\n    const selectedConfigName = relative(cwd, selectedConfigFile);\n    const resolvePaths = (): string[] => [\n        ...new Set(\n            [selectedConfigFile, ...knownDependencies]\n                .flatMap((path) => resolveConfigDependencies(path, selectedConfigName, cwd)),\n        ),\n    ];\n\n    return {\n        resolvePaths,\n        reload: async () => {\n            let loaded: LoadedConfig;\n\n            try {\n                loaded = await loadConfig(cwd, { ...options, configFile: selectedConfigFile });\n            } catch (error) {\n                knownDependencies = [...new Set([...knownDependencies, ...configDependenciesFor(error)])];\n                throw error;\n            }\n\n            knownDependencies = configDependenciesFor(loaded);\n\n            return loaded;\n        },\n    };\n};\n\nexport { createConfigReloader };\n"]}

package/dist/config-source.d.ts

@@ -0,0 +1,7 @@
+type ConfigResolutionOptions = {
+    configFile?: string | undefined;
+    cwd?: string | undefined;
+};
+declare const localConfigSourcePath: (source: string, options: ConfigResolutionOptions) => string | undefined;
+export { localConfigSourcePath, type ConfigResolutionOptions };
+//# sourceMappingURL=config-source.d.ts.map

package/dist/config-source.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-source.d.ts","sourceRoot":"","sources":["../src/config-source.ts"],"names":[],"mappings":"AAEA,KAAK,uBAAuB,GAAG;IAAE,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,CAAC;AAU7F,QAAA,MAAM,qBAAqB,GAAI,QAAQ,MAAM,EAAE,SAAS,uBAAuB,KAAG,MAAM,GAAG,SAU1F,CAAC;AAEF,OAAO,EAAE,qBAAqB,EAAE,KAAK,uBAAuB,EAAE,CAAC"}

package/dist/config-source.js

@@ -0,0 +1,17 @@
+import { basename, extname, isAbsolute, resolve } from "node:path";
+const isLocalConfigSource = (source) => source.startsWith(".") || isAbsolute(source);
+const isDirectoryConfigSource = (source) => {
+    const extension = extname(source);
+    return extension.length === 0 || extension === basename(source);
+};
+const localConfigSourcePath = (source, options) => {
+    if (source === "." || !isLocalConfigSource(source)) {
+        return undefined;
+    }
+    const cwd = options.cwd ?? process.cwd();
+    return isDirectoryConfigSource(source)
+        ? resolve(cwd, source, options.configFile ?? "gtkx.config")
+        : resolve(cwd, source);
+};
+export { localConfigSourcePath };
+//# sourceMappingURL=config-source.js.map

package/dist/config-source.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-source.js","sourceRoot":"","sources":["../src/config-source.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAInE,MAAM,mBAAmB,GAAG,CAAC,MAAc,EAAW,EAAE,CAAC,MAAM,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,UAAU,CAAC,MAAM,CAAC,CAAC;AAEtG,MAAM,uBAAuB,GAAG,CAAC,MAAc,EAAW,EAAE;IACxD,MAAM,SAAS,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAElC,OAAO,SAAS,CAAC,MAAM,KAAK,CAAC,IAAI,SAAS,KAAK,QAAQ,CAAC,MAAM,CAAC,CAAC;AACpE,CAAC,CAAC;AAEF,MAAM,qBAAqB,GAAG,CAAC,MAAc,EAAE,OAAgC,EAAsB,EAAE;IACnG,IAAI,MAAM,KAAK,GAAG,IAAI,CAAC,mBAAmB,CAAC,MAAM,CAAC,EAAE,CAAC;QACjD,OAAO,SAAS,CAAC;IACrB,CAAC;IAED,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;IAEzC,OAAO,uBAAuB,CAAC,MAAM,CAAC;QAClC,CAAC,CAAC,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,UAAU,IAAI,aAAa,CAAC;QAC3D,CAAC,CAAC,OAAO,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;AAC/B,CAAC,CAAC;AAEF,OAAO,EAAE,qBAAqB,EAAgC,CAAC","sourcesContent":["import { basename, extname, isAbsolute, resolve } from \"node:path\";\n\ntype ConfigResolutionOptions = { configFile?: string | undefined; cwd?: string | undefined };\n\nconst isLocalConfigSource = (source: string): boolean => source.startsWith(\".\") || isAbsolute(source);\n\nconst isDirectoryConfigSource = (source: string): boolean => {\n    const extension = extname(source);\n\n    return extension.length === 0 || extension === basename(source);\n};\n\nconst localConfigSourcePath = (source: string, options: ConfigResolutionOptions): string | undefined => {\n    if (source === \".\" || !isLocalConfigSource(source)) {\n        return undefined;\n    }\n\n    const cwd = options.cwd ?? process.cwd();\n\n    return isDirectoryConfigSource(source)\n        ? resolve(cwd, source, options.configFile ?? \"gtkx.config\")\n        : resolve(cwd, source);\n};\n\nexport { localConfigSourcePath, type ConfigResolutionOptions };\n"]}

package/dist/config.d.ts

@@ -16,13 +16,11 @@ type ResolvedReactCompilerOptions = ReactCompilerOptions & {
     target: "19";
 };
 /**
- * User-facing configuration for a GTKX project, as authored in `gtkx.config.ts`: the GIR libraries
- * to bind and where to find them, the GApplication id, per-element configuration, the React
- * Compiler, codegen, and user event signal settings, and the `agents` and `mcp` blocks controlling
- * what coding agents are given.
+ * GTKX project configuration authored in `gtkx.config.ts` and validated when loaded.
  */
 type Config = z.infer<typeof configSchema>;
 type ModuleExport = z.infer<typeof moduleExportSchema>;
+type ElementPropsExport = z.infer<typeof elementPropsSchema>;
 type McpSettings = {
     tools: string[];
     isReadOnly: boolean;
@@ -51,7 +49,16 @@ declare const PANIC_THRESHOLDS: readonly ["none", "critical_errors", "all_errors
 declare const moduleExportSchema: z.ZodObject<{
     module: z.ZodString;
     export: z.ZodString;
-}, z.core.$strip>;
+}, z.core.$strict>;
+declare const elementPropsSchema: z.ZodObject<{
+    module: z.ZodString;
+    export: z.ZodString;
+    composition: z.ZodOptional<z.ZodEnum<{
+        intersection: "intersection";
+        factory: "factory";
+    }>>;
+    constructOnly: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strict>;
 /** Schema every `gtkx.config.ts` is validated against, and the source of the {@link Config} type. */
 declare const configSchema: z.ZodObject<{
     libraries: z.ZodOptional<z.ZodArray<z.ZodString>>;
@@ -69,7 +76,7 @@ declare const configSchema: z.ZodObject<{
             critical_errors: "critical_errors";
             all_errors: "all_errors";
         }>>;
-    }, z.core.$strip>]>>;
+    }, z.core.$strict>]>>;
     codegen: z.ZodOptional<z.ZodBoolean>;
     userEventSignals: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodString>>>;
     elements: z.ZodOptional<z.ZodObject<{
@@ -78,15 +85,21 @@ declare const configSchema: z.ZodObject<{
             component: z.ZodOptional<z.ZodObject<{
                 module: z.ZodString;
                 export: z.ZodString;
-            }, z.core.$strip>>;
+            }, z.core.$strict>>;
             props: z.ZodOptional<z.ZodObject<{
                 module: z.ZodString;
                 export: z.ZodString;
-            }, z.core.$strip>>;
+                composition: z.ZodOptional<z.ZodEnum<{
+                    intersection: "intersection";
+                    factory: "factory";
+                }>>;
+                constructOnly: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            }, z.core.$strict>>;
             isLazy: z.ZodOptional<z.ZodBoolean>;
+            acceptedChildTypes: z.ZodOptional<z.ZodArray<z.ZodString>>;
             omittedProps: z.ZodOptional<z.ZodArray<z.ZodString>>;
-        }, z.core.$strip>>>;
-    }, z.core.$strip>>;
+        }, z.core.$strict>>>;
+    }, z.core.$strict>>;
     applicationIcon: z.ZodOptional<z.ZodString>;
     deploy: z.ZodOptional<z.ZodObject<{
         targets: z.ZodOptional<z.ZodArray<z.ZodEnum<{
@@ -254,11 +267,7 @@ declare const configSchema: z.ZodObject<{
         }, z.core.$strict>>;
         appimage: z.ZodOptional<z.ZodObject<{
             fileName: z.ZodOptional<z.ZodString>;
-            compression: z.ZodOptional<z.ZodEnum<{
-                gzip: "gzip";
-                xz: "xz";
-                zstd: "zstd";
-            }>>;
+            compression: z.ZodOptional<z.ZodLiteral<"zstd">>;
             updateInformation: z.ZodOptional<z.ZodString>;
             runtimeFile: z.ZodOptional<z.ZodString>;
         }, z.core.$strict>>;
@@ -268,9 +277,9 @@ declare const configSchema: z.ZodObject<{
             priority: z.ZodOptional<z.ZodString>;
             compression: z.ZodOptional<z.ZodEnum<{
                 gzip: "gzip";
+                none: "none";
                 xz: "xz";
                 zstd: "zstd";
-                none: "none";
             }>>;
             fields: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
         }, z.core.$strict>>;
@@ -322,15 +331,15 @@ declare const configSchema: z.ZodObject<{
     agents: z.ZodOptional<z.ZodObject<{
         rules: z.ZodOptional<z.ZodBoolean>;
         reference: z.ZodOptional<z.ZodBoolean>;
-    }, z.core.$strip>>;
+    }, z.core.$strict>>;
     mcp: z.ZodOptional<z.ZodObject<{
         tools: z.ZodOptional<z.ZodArray<z.ZodString>>;
         readOnly: z.ZodOptional<z.ZodBoolean>;
-    }, z.core.$strip>>;
+    }, z.core.$strict>>;
     deprecations: z.ZodOptional<z.ZodObject<{
         silence: z.ZodOptional<z.ZodArray<z.ZodNever>>;
-    }, z.core.$strip>>;
-}, z.core.$strip>;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
 /**
  * Returns the given configuration unchanged, typed as {@link Config}, so `gtkx.config.ts` gets
  * autocompletion and type checking.
@@ -346,11 +355,12 @@ declare const graduatedFutureKeys: (config: unknown) => string[];
 declare const mergeConfig: (base: Config, override: Config) => Config;
 declare const resolveLazyElements: (elements: Config["elements"]) => string[];
 declare const resolveElementComponents: (elements: Config["elements"]) => Record<string, ModuleExport>;
-declare const resolveElementProps: (elements: Config["elements"]) => Record<string, ModuleExport>;
+declare const resolveElementProps: (elements: Config["elements"]) => Record<string, ElementPropsExport>;
+declare const resolveAcceptedChildTypes: (elements: Config["elements"]) => Record<string, string[]>;
 declare const resolveOmittedProps: (elements: Config["elements"]) => Record<string, string[]>;
 declare const isAgentRulesEnabled: (config: Config) => boolean;
 declare const isAgentReferenceEnabled: (config: Config) => boolean;
 declare const resolveMcpSettings: (config: Config) => McpSettings;
 declare const resolveConfig: (config: Config, root?: string) => ResolvedConfig;
-export { APPLICATION_ID_MAX_LENGTH, defineConfig, isAgentReferenceEnabled, isAgentRulesEnabled, isValidApplicationId, graduatedFutureKeys, validateConfig, mergeConfig, resolveLazyElements, resolveElementComponents, resolveElementProps, resolveMcpSettings, resolveOmittedProps, resolveConfig, type McpSettings, type ResolvedReactCompilerOptions, type Config, type ResolvedConfig, };
+export { APPLICATION_ID_MAX_LENGTH, defineConfig, isAgentReferenceEnabled, isAgentRulesEnabled, isValidApplicationId, graduatedFutureKeys, validateConfig, mergeConfig, resolveLazyElements, resolveElementComponents, resolveElementProps, resolveAcceptedChildTypes, resolveMcpSettings, resolveOmittedProps, resolveConfig, type McpSettings, type ResolvedReactCompilerOptions, type Config, type ResolvedConfig, };
 //# 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":"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"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"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"}

package/dist/config.js

@@ -26,7 +26,7 @@ const applicationIdSchema = z
 });
 const reactCompilerSchema = z.union([
     z.boolean(),
-    z.object({
+    z.strictObject({
         compilationMode: z.enum(COMPILATION_MODES).optional(),
         panicThreshold: z.enum(PANIC_THRESHOLDS).optional(),
     }),
@@ -34,32 +34,37 @@ const reactCompilerSchema = z.union([
 const userEventSignalsSchema = z.record(z.string(), z.array(z.string({ error: "must be a non-empty signal name" }).min(1, { error: "must be a non-empty signal name" }), {
     error: "must be an array of signal names",
 }), { error: "must be a record of GLib type names to signal name arrays" });
-const moduleExportSchema = z.object({
+const moduleExportSchema = z.strictObject({
     module: z.string({ error: "must be a module specifier" }).min(1, { error: "must be a module specifier" }),
     export: z.string({ error: "must be an export name" }).min(1, { error: "must be an export name" }),
 }, { error: "must be a { module, export } object" });
-const elementConfigSchema = z.object({
+const elementPropsSchema = moduleExportSchema.extend({
+    composition: z.enum(["factory", "intersection"]).optional(),
+    constructOnly: z.array(z.string()).optional(),
+});
+const elementConfigSchema = z.strictObject({
     component: moduleExportSchema.optional(),
-    props: moduleExportSchema.optional(),
+    props: elementPropsSchema.optional(),
     isLazy: z.boolean({ error: "must be a boolean" }).optional(),
+    acceptedChildTypes: z.array(z.string()).optional(),
     omittedProps: z
         .array(z.string({ error: "must be a non-empty property name" }).min(1, {
         error: "must be a non-empty property name",
     }), { error: "must be an array of property names" })
         .optional(),
 });
-const elementsSchema = z.object({
+const elementsSchema = z.strictObject({
     behaviors: z
         .string({ error: "must be a path to a module exporting element behaviors" })
         .min(1, { error: "must be a path to a module exporting element behaviors" })
         .optional(),
     config: z.record(z.string(), elementConfigSchema).optional(),
 });
-const agentsSchema = z.object({
+const agentsSchema = z.strictObject({
     rules: z.boolean({ error: "must be a boolean" }).optional(),
     reference: z.boolean({ error: "must be a boolean" }).optional(),
 });
-const mcpSchema = z.object({
+const mcpSchema = z.strictObject({
     tools: z
         .array(z.string({ error: "must be a tool name pattern" }).min(1, { error: "must be a tool name pattern" }), {
         error: "must be an array of tool name patterns",
@@ -78,7 +83,7 @@ const graduatedFutureSchema = z
     v2TreeShaking: z.literal(true, { error: "can only be true; remove the flag" }).optional(),
 })
     .strict();
-const deprecationsSchema = z.object({
+const deprecationsSchema = z.strictObject({
     silence: z
         .array(z.never({ error: "does not name a current deprecation" }), {
         error: "must be an array of current deprecation ids",
@@ -86,7 +91,7 @@ const deprecationsSchema = z.object({
         .optional(),
 });
 /** Schema every `gtkx.config.ts` is validated against, and the source of the {@link Config} type. */
-const configSchema = z.object({
+const configSchema = z.strictObject({
     libraries: librariesSchema.optional(),
     girPath: z.array(z.string(), { error: "must be an array of strings if provided" }).optional(),
     applicationId: applicationIdSchema,
@@ -150,6 +155,7 @@ const elementEntryValues = (elements, pick) => Object.fromEntries(Object.entries
 }));
 const resolveElementComponents = (elements) => elementEntryValues(elements, (entry) => entry.component);
 const resolveElementProps = (elements) => elementEntryValues(elements, (entry) => entry.props);
+const resolveAcceptedChildTypes = (elements) => elementEntryValues(elements, (entry) => entry.acceptedChildTypes);
 const resolveOmittedProps = (elements) => elementEntryValues(elements, (entry) => entry.omittedProps);
 const isAgentRulesEnabled = (config) => config.agents?.rules !== false;
 const isAgentReferenceEnabled = (config) => config.agents?.reference !== false;
@@ -164,5 +170,5 @@ const resolveConfig = (config, root) => ({
     elements: resolveElementsModule(config.elements?.behaviors, root),
     lazyElements: resolveLazyElements(config.elements),
 });
-export { APPLICATION_ID_MAX_LENGTH, defineConfig, isAgentReferenceEnabled, isAgentRulesEnabled, isValidApplicationId, graduatedFutureKeys, validateConfig, mergeConfig, resolveLazyElements, resolveElementComponents, resolveElementProps, resolveMcpSettings, resolveOmittedProps, resolveConfig, };
+export { APPLICATION_ID_MAX_LENGTH, defineConfig, isAgentReferenceEnabled, isAgentRulesEnabled, isValidApplicationId, graduatedFutureKeys, validateConfig, mergeConfig, resolveLazyElements, resolveElementComponents, resolveElementProps, resolveAcceptedChildTypes, resolveMcpSettings, resolveOmittedProps, resolveConfig, };
 //# sourceMappingURL=config.js.map