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

package/README.md

@@ -1,174 +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, built on GTK.<br />
-  Write native GTK4 desktop applications with React and TypeScript.
-  Real GTK widgets, the GNOME stack, and 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
-
-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 />);
-```
-
-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
-
-### A declarative layer for the GNOME stack
-
-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:
-
-- 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.
-
-### The full GNOME API surface
-
-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.
-
-### 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 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.
-
-At runtime, the native Rust core calls straight into the system GTK4, Adwaita, 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
+export default defineConfig({
+    applicationId: "com.example.MyApp",
+});
 ```
 
-The same command works with other package managers: `pnpm create gtkx` or `yarn create gtkx`.
-
-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 GTK4 (4.20 or later), Adwaita (1.8 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 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.
-- [`animations`](https://github.com/gtkx-org/gtkx/tree/main/examples/animations): a tour of `@gtkx/animated`, 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

@@ -0,0 +1,11 @@
+import { type TransformOptions, type TransformResult } from "jiti";
+type CapturedConfig<T> = {
+    dependencies: string[];
+    value: T;
+};
+declare const transformConfigModule: (options: TransformOptions) => TransformResult;
+declare const setConfigDependencies: (value: object, dependencies: Iterable<string>) => void;
+declare const configDependenciesFor: (value: unknown) => string[];
+declare const captureConfigDependencies: <T>(operation: () => Promise<T>) => Promise<CapturedConfig<T>>;
+export { captureConfigDependencies, configDependenciesFor, setConfigDependencies, transformConfigModule, };
+//# sourceMappingURL=config-dependencies.d.ts.map

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

@@ -0,0 +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;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

@@ -0,0 +1,84 @@
+import { createJiti } from "jiti";
+import { AsyncLocalStorage } from "node:async_hooks";
+import { createRequire, registerHooks } from "node:module";
+import { extname, sep } from "node:path";
+import { fileURLToPath } from "node:url";
+const captureStorage = new AsyncLocalStorage();
+const dependenciesByValue = new WeakMap();
+const CACHE_BUSTED_EXTENSIONS = new Set([".cjs", ".js", ".json", ".mjs"]);
+const isTrackedPath = (path) => !path.includes(`${sep}node_modules${sep}`);
+const addPath = (path) => {
+    if (isTrackedPath(path)) {
+        captureStorage.getStore()?.dependencies.add(path);
+    }
+};
+const addUrl = (url) => {
+    if (url.startsWith("file:")) {
+        addPath(fileURLToPath(url));
+    }
+};
+const cacheBustedUrl = (url) => {
+    const state = captureStorage.getStore();
+    if (state === undefined || !url.startsWith("file:")) {
+        return url;
+    }
+    const path = fileURLToPath(url);
+    if (!isTrackedPath(path) || !CACHE_BUSTED_EXTENSIONS.has(extname(path))) {
+        return url;
+    }
+    const parsed = new URL(url);
+    parsed.searchParams.set("gtkx-config-load", state.cacheKey);
+    return parsed.href;
+};
+const registerResolutionHook = () => registerHooks({
+    resolve(specifier, context, nextResolve) {
+        const result = nextResolve(specifier, context);
+        addUrl(result.url);
+        return { ...result, url: cacheBustedUrl(result.url) };
+    },
+});
+const clearNativeModuleCache = (dependencies) => {
+    const cache = createRequire(import.meta.url).cache;
+    for (const path of dependencies) {
+        Reflect.deleteProperty(cache, path);
+    }
+};
+const transformConfigModule = (options) => {
+    const state = captureStorage.getStore();
+    if (state === undefined) {
+        throw new Error("Configuration transformation started outside a dependency capture");
+    }
+    if (options.filename !== undefined) {
+        addPath(options.filename);
+    }
+    return { code: state.transformer.transform(options) };
+};
+const setConfigDependencies = (value, dependencies) => {
+    const paths = [...new Set(dependencies)];
+    dependenciesByValue.set(value, paths);
+    clearNativeModuleCache(paths);
+};
+const configDependenciesFor = (value) => typeof value === "object" && value !== null ? dependenciesByValue.get(value) ?? [] : [];
+const captureConfigDependencies = async (operation) => {
+    const state = {
+        cacheKey: process.hrtime.bigint().toString(),
+        dependencies: new Set(),
+        transformer: createJiti(import.meta.url, { fsCache: false, moduleCache: false }),
+    };
+    const hook = registerResolutionHook();
+    try {
+        const value = await captureStorage.run(state, operation);
+        return { dependencies: [...state.dependencies], value };
+    }
+    catch (error) {
+        if (typeof error === "object" && error !== null) {
+            setConfigDependencies(error, state.dependencies);
+        }
+        throw error;
+    }
+    finally {
+        hook.deregister();
+    }
+};
+export { captureConfigDependencies, configDependenciesFor, setConfigDependencies, transformConfigModule, };
+//# sourceMappingURL=config-dependencies.js.map

package/dist/config-dependencies.js.map

@@ -0,0 +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    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-error.d.ts

@@ -1,6 +1,6 @@
 import { z } from "zod";
 declare const isRecord: (value: unknown) => value is Record<string, unknown>;
-declare const missingConfigFileError: (cwd: string) => Error;
-declare const configError: (error: z.ZodError) => Error;
+declare const missingConfigFileError: (cwd: string, configFile?: string) => Error;
+declare const configError: (error: z.ZodError, configFile?: string) => Error;
 export { isRecord, missingConfigFileError, configError };
 //# sourceMappingURL=config-error.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"config-error.d.ts","sourceRoot":"","sources":["../src/config-error.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,QAAA,MAAM,QAAQ,GAAI,OAAO,OAAO,KAAG,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CACM,CAAC;AAEzE,QAAA,MAAM,sBAAsB,GAAI,KAAK,MAAM,KAAG,KACyB,CAAC;AAExE,QAAA,MAAM,WAAW,GAAI,OAAO,CAAC,CAAC,QAAQ,KAAG,KAAiE,CAAC;AAE3G,OAAO,EAAE,QAAQ,EAAE,sBAAsB,EAAE,WAAW,EAAE,CAAC"}
+{"version":3,"file":"config-error.d.ts","sourceRoot":"","sources":["../src/config-error.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,QAAA,MAAM,QAAQ,GAAI,OAAO,OAAO,KAAG,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CACM,CAAC;AAIzE,QAAA,MAAM,sBAAsB,GAAI,KAAK,MAAM,EAAE,aAAa,MAAM,KAAG,KAGW,CAAC;AAE/E,QAAA,MAAM,WAAW,GAAI,OAAO,CAAC,CAAC,QAAQ,EAAE,mBAAgC,KAAG,KACJ,CAAC;AAExE,OAAO,EAAE,QAAQ,EAAE,sBAAsB,EAAE,WAAW,EAAE,CAAC"}

package/dist/config-error.js

@@ -1,7 +1,10 @@
 import { z } from "zod";
-const CONFIG_PREFIX = "gtkx.config.ts:";
+const DEFAULT_CONFIG_FILE = "gtkx.config.*";
 const isRecord = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
-const missingConfigFileError = (cwd) => new Error(`${CONFIG_PREFIX} no configuration file found in ${cwd}`);
-const configError = (error) => new Error(`${CONFIG_PREFIX}\n${z.prettifyError(error)}`);
+const configPrefix = (configFile) => `${configFile}:`;
+const missingConfigFileError = (cwd, configFile) => new Error(configFile === undefined
+    ? `${configPrefix(DEFAULT_CONFIG_FILE)} no configuration file found in ${cwd}`
+    : `${configPrefix(configFile)} no configuration file found in ${cwd}`);
+const configError = (error, configFile = DEFAULT_CONFIG_FILE) => new Error(`${configPrefix(configFile)}\n${z.prettifyError(error)}`);
 export { isRecord, missingConfigFileError, configError };
 //# sourceMappingURL=config-error.js.map

package/dist/config-error.js.map

@@ -1 +1 @@
-{"version":3,"file":"config-error.js","sourceRoot":"","sources":["../src/config-error.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,aAAa,GAAG,iBAAiB,CAAC;AAExC,MAAM,QAAQ,GAAG,CAAC,KAAc,EAAoC,EAAE,CAClE,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAEzE,MAAM,sBAAsB,GAAG,CAAC,GAAW,EAAS,EAAE,CAClD,IAAI,KAAK,CAAC,GAAG,aAAa,mCAAmC,GAAG,EAAE,CAAC,CAAC;AAExE,MAAM,WAAW,GAAG,CAAC,KAAiB,EAAS,EAAE,CAAC,IAAI,KAAK,CAAC,GAAG,aAAa,KAAK,CAAC,CAAC,aAAa,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;AAE3G,OAAO,EAAE,QAAQ,EAAE,sBAAsB,EAAE,WAAW,EAAE,CAAC","sourcesContent":["import { z } from \"zod\";\n\nconst CONFIG_PREFIX = \"gtkx.config.ts:\";\n\nconst isRecord = (value: unknown): value is Record<string, unknown> =>\n    typeof value === \"object\" && value !== null && !Array.isArray(value);\n\nconst missingConfigFileError = (cwd: string): Error =>\n    new Error(`${CONFIG_PREFIX} no configuration file found in ${cwd}`);\n\nconst configError = (error: z.ZodError): Error => new Error(`${CONFIG_PREFIX}\\n${z.prettifyError(error)}`);\n\nexport { isRecord, missingConfigFileError, configError };\n"]}
+{"version":3,"file":"config-error.js","sourceRoot":"","sources":["../src/config-error.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,mBAAmB,GAAG,eAAe,CAAC;AAE5C,MAAM,QAAQ,GAAG,CAAC,KAAc,EAAoC,EAAE,CAClE,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAEzE,MAAM,YAAY,GAAG,CAAC,UAAkB,EAAU,EAAE,CAAC,GAAG,UAAU,GAAG,CAAC;AAEtE,MAAM,sBAAsB,GAAG,CAAC,GAAW,EAAE,UAAmB,EAAS,EAAE,CACvE,IAAI,KAAK,CAAC,UAAU,KAAK,SAAS;IAC9B,CAAC,CAAC,GAAG,YAAY,CAAC,mBAAmB,CAAC,mCAAmC,GAAG,EAAE;IAC9E,CAAC,CAAC,GAAG,YAAY,CAAC,UAAU,CAAC,mCAAmC,GAAG,EAAE,CAAC,CAAC;AAE/E,MAAM,WAAW,GAAG,CAAC,KAAiB,EAAE,UAAU,GAAG,mBAAmB,EAAS,EAAE,CAC/E,IAAI,KAAK,CAAC,GAAG,YAAY,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,aAAa,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;AAExE,OAAO,EAAE,QAAQ,EAAE,sBAAsB,EAAE,WAAW,EAAE,CAAC","sourcesContent":["import { z } from \"zod\";\n\nconst DEFAULT_CONFIG_FILE = \"gtkx.config.*\";\n\nconst isRecord = (value: unknown): value is Record<string, unknown> =>\n    typeof value === \"object\" && value !== null && !Array.isArray(value);\n\nconst configPrefix = (configFile: string): string => `${configFile}:`;\n\nconst missingConfigFileError = (cwd: string, configFile?: string): Error =>\n    new Error(configFile === undefined\n        ? `${configPrefix(DEFAULT_CONFIG_FILE)} no configuration file found in ${cwd}`\n        : `${configPrefix(configFile)} no configuration file found in ${cwd}`);\n\nconst configError = (error: z.ZodError, configFile = DEFAULT_CONFIG_FILE): Error =>\n    new Error(`${configPrefix(configFile)}\\n${z.prettifyError(error)}`);\n\nexport { isRecord, missingConfigFileError, configError };\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<{
@@ -95,6 +108,10 @@ declare const configSchema: z.ZodObject<{
             flatpak: "flatpak";
             rpm: "rpm";
         }>>>;
+        architectures: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+            arm64: "arm64";
+            x64: "x64";
+        }>>>;
         outDir: z.ZodOptional<z.ZodString>;
         name: z.ZodOptional<z.ZodString>;
         genericName: z.ZodOptional<z.ZodString>;
@@ -162,6 +179,8 @@ declare const configSchema: z.ZodObject<{
             url: z.ZodOptional<z.ZodURL>;
         }, z.core.$strict>>>;
         execArgs: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        launcherEnv: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        nodeFlags: z.ZodOptional<z.ZodArray<z.ZodString>>;
         fileAssociations: z.ZodOptional<z.ZodArray<z.ZodObject<{
             extension: z.ZodString;
             mimeType: z.ZodString;
@@ -174,11 +193,9 @@ declare const configSchema: z.ZodObject<{
             icon: z.ZodOptional<z.ZodString>;
         }, z.core.$strict>>>;
         desktopEntry: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        metainfoExtra: z.ZodOptional<z.ZodArray<z.ZodString>>;
         isDbusActivatable: z.ZodOptional<z.ZodBoolean>;
-        extraFiles: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
-            source: z.ZodString;
-            mode: z.ZodOptional<z.ZodString>;
-        }, z.core.$strict>]>>>;
+        extraFiles: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodType<import("./deploy.ts").DeployExtraFileOptions, unknown, z.core.$ZodTypeInternals<import("./deploy.ts").DeployExtraFileOptions, unknown>>]>>>;
         minimumLibraryVersions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
         depends: z.ZodOptional<z.ZodObject<{
             deb: z.ZodOptional<z.ZodArray<z.ZodString>>;
@@ -220,17 +237,7 @@ declare const configSchema: z.ZodObject<{
             preRemove: z.ZodOptional<z.ZodString>;
             postRemove: z.ZodOptional<z.ZodString>;
         }, z.core.$strict>>;
-        node: z.ZodOptional<z.ZodObject<{
-            source: z.ZodOptional<z.ZodEnum<{
-                path: "path";
-                download: "download";
-                host: "host";
-            }>>;
-            version: z.ZodOptional<z.ZodString>;
-            path: z.ZodOptional<z.ZodString>;
-            shouldStrip: z.ZodOptional<z.ZodBoolean>;
-            shouldUseCompileCache: z.ZodOptional<z.ZodBoolean>;
-        }, z.core.$strict>>;
+        node: z.ZodOptional<z.ZodType<import("./deploy.ts").DeployNodeOptions, unknown, z.core.$ZodTypeInternals<import("./deploy.ts").DeployNodeOptions, unknown>>>;
         signing: z.ZodOptional<z.ZodObject<{
             appimage: z.ZodOptional<z.ZodObject<{
                 gpgKeyId: z.ZodString;
@@ -260,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>>;
@@ -274,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>>;
@@ -328,22 +331,22 @@ 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.
  */
 declare const defineConfig: DefineConfig<Config>;
 declare const isValidApplicationId: (applicationId: string) => boolean;
-declare const validateConfig: (config: unknown) => void;
+declare const validateConfig: (config: unknown, configFile?: string) => void;
 declare const graduatedFutureKeys: (config: unknown) => string[];
 /**
  * Deep-merges a configuration over a base. `override` wins over `base` on conflicting scalar and object keys, while
@@ -352,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