@gtkx/config 1.0.0-rc.3 → 1.0.0

package/README.md

@@ -6,7 +6,8 @@
 
 <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.
+  Write native Linux applications with React and TypeScript.
+  Built on the GNOME stack and standard web tooling.
 </p>
 
 <p align="center">
@@ -20,15 +21,13 @@
 
 <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://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>
 
 ---
 
-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.
-
 <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>
@@ -109,7 +108,7 @@ React Native and similar frameworks hide the native toolkit so one API can run e
 
 ### 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 the comparison in full.
+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.
 
@@ -122,10 +121,10 @@ GTKX is Linux-only and needs Node.js 24 or later. See [Requirements](#requiremen
 Scaffold a new app with the `create-gtkx` initializer:
 
 ```sh
-npm create gtkx@rc
+npm create gtkx
 ```
 
-The same command works with other package managers: `pnpm create gtkx@rc` or `yarn create gtkx@rc`.
+The same command works with other package managers: `pnpm create gtkx` or `yarn create gtkx`.
 
 Then run your new app:
 
@@ -146,7 +145,7 @@ The documentation at **[gtkx.dev](https://gtkx.dev)** includes a step-by-step tu
 
 GTKX is Linux-only. You need:
 
-- Linux with the GTK4 (4.20 or later), Adwaita (1.8 or later), and GLib development libraries
+- Linux with the GTK4 (4.20 or later) and GLib development libraries, plus Adwaita (1.8 or later) once your project binds `Adw-1`
 - 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.
@@ -162,7 +161,7 @@ Explore the [example apps](https://github.com/gtkx-org/gtkx/tree/main/examples):
 
 ## Status
 
-GTKX 1.0 is at the release candidate stage.
+GTKX 1.0 is released.
 
 ## Contributing
 

package/dist/config.d.ts

@@ -1,48 +1,53 @@
 import { type DefineConfig } from "c12";
 import { z } from "zod";
+/** Accepted `reactCompiler.compilationMode` values, choosing which functions the compiler processes. */
 type ReactCompilerCompilationMode = (typeof COMPILATION_MODES)[number];
+/** Accepted `reactCompiler.panicThreshold` values, choosing which compiler diagnostics fail the build. */
 type ReactCompilerPanicThreshold = (typeof PANIC_THRESHOLDS)[number];
+/** Object form of the `reactCompiler` config key, forwarded as-is to `babel-plugin-react-compiler`. */
 type ReactCompilerOptions = {
+    /** Which functions the compiler processes; left to the compiler's own default when omitted. */
     compilationMode?: ReactCompilerCompilationMode;
+    /** Which compiler diagnostics fail the build; left to the compiler's own default when omitted. */
     panicThreshold?: ReactCompilerPanicThreshold;
 };
 /**
- * React Compiler options resolved for the build, with the compilation target
- * fixed to React 19.
+ * The React Compiler options the build hands to `babel-plugin-react-compiler`, with the React version
+ * GTKX targets filled in.
  */
 type ResolvedReactCompilerOptions = ReactCompilerOptions & {
+    /** React major version the compiler emits for. */
     target: "19";
 };
 /**
- * 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,
- * a module of per-element configuration (lazy flags and custom behaviors),
- * per-element component wrappers and omitted props keyed by GLib type name, the
- * React Compiler and codegen settings, additional user event signals to suppress
- * during React commits, and extra GIR records to treat as class structs.
+ * 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, and the React
+ * Compiler, codegen, and user event signal settings.
  */
 type Config = z.infer<typeof configSchema>;
-/** A `{ module, export }` reference to a named export, as element config entries carry it. */
 type ModuleExport = z.infer<typeof moduleExportSchema>;
-/**
- * Configuration reduced to the values needed at runtime: the GApplication
- * identifier, the resolved React Compiler options (`null` when disabled), the
- * user event signals suppressed while a React commit is in progress, and the
- * module path holding per-element configuration (`null` when unset).
- */
+/** Configuration reduced to the values the app runtime and the build need, with paths already resolved. */
 type ResolvedConfig = {
+    /** The GApplication identifier the app registers under. */
     applicationId: string;
+    /** React Compiler options for the build, or `null` when the compiler is disabled. */
     reactCompiler: ResolvedReactCompilerOptions | null;
+    /** Signal names, keyed by GLib type name, that stay suppressed while a React commit runs. */
     userEventSignals: Record<string, string[]>;
+    /** Path of the module exporting per-element configs, or `null` when none is configured. */
     elements: string | null;
+    /** GLib type names of the elements marked `isLazy`, whose GObject their parent container creates. */
     lazyElements: string[];
 };
+/** Compilation modes `babel-plugin-react-compiler` accepts. */
 declare const COMPILATION_MODES: readonly ["infer", "syntax", "annotation", "all"];
+/** Panic thresholds `babel-plugin-react-compiler` accepts. */
 declare const PANIC_THRESHOLDS: readonly ["none", "critical_errors", "all_errors"];
 declare const moduleExportSchema: z.ZodObject<{
     module: z.ZodString;
     export: z.ZodString;
 }, z.core.$strip>;
+/** 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.ZodCustom<string[] | "*", string[] | "*">>;
     girPath: z.ZodOptional<z.ZodArray<z.ZodString>>;
@@ -61,29 +66,28 @@ declare const configSchema: z.ZodObject<{
                 module: z.ZodString;
                 export: z.ZodString;
             }, z.core.$strip>>;
-            lazy: z.ZodOptional<z.ZodBoolean>;
-            omitProps: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            isLazy: z.ZodOptional<z.ZodBoolean>;
+            omittedProps: z.ZodOptional<z.ZodArray<z.ZodString>>;
         }, z.core.$strip>>>;
     }, z.core.$strip>>;
 }, z.core.$strip>;
 /**
- * Identity helper that returns the given configuration typed as {@link Config},
- * enabling editor autocompletion and type checking in `gtkx.config.ts`.
+ * 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 resolveReactCompilerOptions: (setting: Config["reactCompiler"]) => ResolvedReactCompilerOptions | null;
 declare const validateConfig: (config: Config) => void;
 /**
- * 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.
+ * Deep-merges two configurations. `override` wins over `base` on conflicting scalar and object keys, while
+ * arrays are concatenated with the `override` entries first.
  */
 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 resolveOmitProps: (elements: Config["elements"]) => Record<string, string[]>;
+declare const resolveOmittedProps: (elements: Config["elements"]) => Record<string, string[]>;
 declare const resolveConfig: (config: Config, root?: string) => ResolvedConfig;
-export { defineConfig, isValidApplicationId, resolveReactCompilerOptions, validateConfig, mergeConfig, resolveLazyElements, resolveElementComponents, resolveElementProps, resolveOmitProps, resolveConfig, type ResolvedReactCompilerOptions, type Config, type ModuleExport, type ResolvedConfig, };
+export { defineConfig, isValidApplicationId, resolveReactCompilerOptions, validateConfig, mergeConfig, resolveLazyElements, resolveElementComponents, resolveElementProps, resolveOmittedProps, resolveConfig, 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":"AAAA,OAAO,EAAsB,KAAK,YAAY,EAAE,MAAM,KAAK,CAAC;AAG5D,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,KAAK,4BAA4B,GAAG,CAAC,OAAO,iBAAiB,CAAC,CAAC,MAAM,CAAC,CAAC;AACvE,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,KAAK,4BAA4B,GAAG,oBAAoB,GAAG;IACvD,MAAM,EAAE,IAAI,CAAC;CAChB,CAAC;AAEF;;;;;;;GAOG;AACH,KAAK,MAAM,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC;AAC3C,8FAA8F;AAC9F,KAAK,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAGvD;;;;;GAKG;AACH,KAAK,cAAc,GAAG;IAClB,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,4BAA4B,GAAG,IAAI,CAAC;IACnD,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IAC3C,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,YAAY,EAAE,MAAM,EAAE,CAAC;CAC1B,CAAC;AAMF,QAAA,MAAM,iBAAiB,mDAAoD,CAAC;AAC5E,QAAA,MAAM,gBAAgB,oDAAqD,CAAC;AA4F5E,QAAA,MAAM,kBAAkB;;;iBAMvB,CAAC;AAwBF,QAAA,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;iBAQhB,CAAC;AAEH;;;GAGG;AACH,QAAA,MAAM,YAAY,EAAE,YAAY,CAAC,MAAM,CAAgC,CAAC;AAsBxE,QAAA,MAAM,oBAAoB,GAAI,eAAe,MAAM,KAAG,OAMrD,CAAC;AAEF,QAAA,MAAM,2BAA2B,GAAI,SAAS,MAAM,CAAC,eAAe,CAAC,KAAG,4BAA4B,GAAG,IAQtG,CAAC;AAKF,QAAA,MAAM,cAAc,GAAI,QAAQ,MAAM,KAAG,IAMxC,CAAC;AAEF;;;;GAIG;AACH,QAAA,MAAM,WAAW,GAAI,MAAM,MAAM,EAAE,UAAU,MAAM,KAAG,MAA8B,CAAC;AAUrF,QAAA,MAAM,mBAAmB,GAAI,UAAU,MAAM,CAAC,UAAU,CAAC,KAAG,MAAM,EAGpC,CAAC;AAc/B,QAAA,MAAM,wBAAwB,GAAI,UAAU,MAAM,CAAC,UAAU,CAAC,KAAG,MAAM,CAAC,MAAM,EAAE,YAAY,CAChC,CAAC;AAE7D,QAAA,MAAM,mBAAmB,GAAI,UAAU,MAAM,CAAC,UAAU,CAAC,KAAG,MAAM,CAAC,MAAM,EAAE,YAAY,CAC/B,CAAC;AAEzD,QAAA,MAAM,gBAAgB,GAAI,UAAU,MAAM,CAAC,UAAU,CAAC,KAAG,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CACpB,CAAC;AAE7D,QAAA,MAAM,aAAa,GAAI,QAAQ,MAAM,EAAE,OAAO,MAAM,KAAG,cAMrD,CAAC;AAEH,OAAO,EACH,YAAY,EACZ,oBAAoB,EACpB,2BAA2B,EAC3B,cAAc,EACd,WAAW,EACX,mBAAmB,EACnB,wBAAwB,EACxB,mBAAmB,EACnB,gBAAgB,EAChB,aAAa,EACb,KAAK,4BAA4B,EACjC,KAAK,MAAM,EACX,KAAK,YAAY,EACjB,KAAK,cAAc,GACtB,CAAC"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"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"}

package/dist/config.js

@@ -8,7 +8,9 @@ const LIBRARIES_WILDCARD = "*";
 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;
+/** Compilation modes `babel-plugin-react-compiler` accepts. */
 const COMPILATION_MODES = ["infer", "syntax", "annotation", "all"];
+/** Panic thresholds `babel-plugin-react-compiler` accepts. */
 const PANIC_THRESHOLDS = ["none", "critical_errors", "all_errors"];
 const REACT_COMPILER_TARGET = "19";
 const COMPILATION_MODE_SET = new Set(COMPILATION_MODES);
@@ -63,8 +65,8 @@ const moduleExportSchema = z.object({
 const elementConfigSchema = z.object({
     component: moduleExportSchema.optional(),
     props: moduleExportSchema.optional(),
-    lazy: z.boolean({ error: "must be a boolean" }).optional(),
-    omitProps: z
+    isLazy: z.boolean({ error: "must be a boolean" }).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" })
@@ -77,6 +79,7 @@ const elementsSchema = z.object({
         .optional(),
     config: z.record(z.string(), elementConfigSchema).optional(),
 });
+/** Schema every `gtkx.config.ts` is validated against, and the source of the {@link Config} type. */
 const configSchema = z.object({
     libraries: librariesSchema.optional(),
     girPath: z.array(z.string(), { error: "must be an array of strings if provided" }).optional(),
@@ -87,8 +90,8 @@ const configSchema = z.object({
     elements: elementsSchema.optional(),
 });
 /**
- * Identity helper that returns the given configuration typed as {@link Config},
- * enabling editor autocompletion and type checking in `gtkx.config.ts`.
+ * Returns the given configuration unchanged, typed as {@link Config}, so `gtkx.config.ts` gets
+ * autocompletion and type checking.
  */
 const defineConfig = createDefineConfig();
 const libraryEntryIssues = (value, index, entry) => {
@@ -125,9 +128,8 @@ const validateConfig = (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.
+ * Deep-merges two configurations. `override` wins over `base` on conflicting scalar and object keys, while
+ * arrays are concatenated with the `override` entries first.
  */
 const mergeConfig = (base, override) => defu(override, base);
 const resolveElementsModule = (behaviors, root) => {
@@ -137,7 +139,7 @@ const resolveElementsModule = (behaviors, root) => {
     return root === undefined ? behaviors : resolve(root, behaviors);
 };
 const resolveLazyElements = (elements) => Object.entries(elements?.config ?? {})
-    .filter(([, entry]) => entry.lazy === true)
+    .filter(([, entry]) => entry.isLazy === true)
     .map(([type]) => type);
 const elementEntryValues = (elements, pick) => Object.fromEntries(Object.entries(elements?.config ?? {}).flatMap(([type, entry]) => {
     const value = pick(entry);
@@ -145,7 +147,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 resolveOmitProps = (elements) => elementEntryValues(elements, (entry) => entry.omitProps);
+const resolveOmittedProps = (elements) => elementEntryValues(elements, (entry) => entry.omittedProps);
 const resolveConfig = (config, root) => ({
     applicationId: config.applicationId,
     reactCompiler: resolveReactCompilerOptions(config.reactCompiler),
@@ -153,5 +155,5 @@ const resolveConfig = (config, root) => ({
     elements: resolveElementsModule(config.elements?.behaviors, root),
     lazyElements: resolveLazyElements(config.elements),
 });
-export { defineConfig, isValidApplicationId, resolveReactCompilerOptions, validateConfig, mergeConfig, resolveLazyElements, resolveElementComponents, resolveElementProps, resolveOmitProps, resolveConfig, };
+export { defineConfig, isValidApplicationId, resolveReactCompilerOptions, validateConfig, mergeConfig, resolveLazyElements, resolveElementComponents, resolveElementProps, resolveOmittedProps, resolveConfig, };
 //# 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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","sourcesContent":["import { createDefineConfig, type DefineConfig } from \"c12\";\nimport { defu } from \"defu\";\nimport { resolve } from \"node:path\";\nimport { z } from \"zod\";\nimport { configError, isRecord, rawIssue } from \"./config-error.js\";\nimport { resolveUserEventSignals } from \"./user-event-signals.js\";\n\ntype ReactCompilerCompilationMode = (typeof COMPILATION_MODES)[number];\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 */\ntype ResolvedReactCompilerOptions = ReactCompilerOptions & {\n    target: \"19\";\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 * a module of per-element configuration (lazy flags and custom behaviors),\n * per-element component wrappers and omitted props keyed by GLib type name, the\n * React Compiler and codegen settings, additional user event signals to suppress\n * during React commits, and extra GIR records to treat as class structs.\n */\ntype Config = z.infer<typeof configSchema>;\n/** A `{ module, export }` reference to a named export, as element config entries carry it. */\ntype ModuleExport = z.infer<typeof moduleExportSchema>;\ntype ElementConfigEntry = z.infer<typeof elementConfigSchema>;\n\n/**\n * Configuration reduced to the values needed at runtime: the GApplication\n * identifier, the resolved React Compiler options (`null` when disabled), the\n * user event signals suppressed while a React commit is in progress, and the\n * module path holding per-element configuration (`null` when unset).\n */\ntype ResolvedConfig = {\n    applicationId: string;\n    reactCompiler: ResolvedReactCompilerOptions | null;\n    userEventSignals: Record<string, string[]>;\n    elements: string | null;\n    lazyElements: string[];\n};\n\nconst LIBRARIES_WILDCARD = \"*\";\nconst GIR_LIBRARY_PATTERN = /^[A-Za-z][A-Za-z0-9]*-\\d+(?:\\.\\d+)*$/;\nconst APPLICATION_ID_PATTERN = /^[A-Za-z_][A-Za-z0-9_-]*(\\.[A-Za-z_][A-Za-z0-9_-]*)+$/;\nconst APPLICATION_ID_MAX_LENGTH = 255;\nconst COMPILATION_MODES = [\"infer\", \"syntax\", \"annotation\", \"all\"] as const;\nconst PANIC_THRESHOLDS = [\"none\", \"critical_errors\", \"all_errors\"] as const;\nconst REACT_COMPILER_TARGET = \"19\";\nconst COMPILATION_MODE_SET: Set<string> = new Set(COMPILATION_MODES);\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\n    if (value === LIBRARIES_WILDCARD) {\n        return;\n    }\n\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\n        return;\n    }\n\n    for (const [index, entry] of value.entries()) {\n        ctx.issues.push(...libraryEntryIssues(value, index, entry));\n    }\n});\n\nconst applicationIdSchema = z.custom<string>().check((ctx) => {\n    const value = ctx.value;\n\n    if (typeof value !== \"string\" || !isValidApplicationId(value)) {\n        ctx.issues.push(\n            rawIssue(\n                value,\n                [],\n                `invalid \\`applicationId\\` \"${value}\", must satisfy g_application_id_is_valid ` +\n                '(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\n    if (typeof value === \"boolean\") {\n        return;\n    }\n\n    if (!isRecord(value)) {\n        ctx.issues.push(rawIssue(value, [], \"must be a boolean or an options object\"));\n\n        return;\n    }\n\n    const compilationMode = value.compilationMode;\n\n    if (!isValidReactCompilerOption(compilationMode, COMPILATION_MODE_SET)) {\n        ctx.issues.push(\n            rawIssue(\n                value,\n                [],\n                `invalid \\`reactCompiler.compilationMode\\` \"${String(compilationMode)}\", ` +\n                `must be one of ${COMPILATION_MODES.join(\", \")}`,\n                true,\n            ),\n        );\n    }\n\n    const panicThreshold = value.panicThreshold;\n\n    if (!isValidReactCompilerOption(panicThreshold, PANIC_THRESHOLD_SET)) {\n        ctx.issues.push(\n            rawIssue(\n                value,\n                [],\n                `invalid \\`reactCompiler.panicThreshold\\` \"${String(panicThreshold)}\", ` +\n                `must be one of ${PANIC_THRESHOLDS.join(\", \")}`,\n                true,\n            ),\n        );\n    }\n});\n\nconst userEventSignalsSchema = z.record(\n    z.string(),\n    z.array(\n        z.string({ error: \"must be a non-empty signal name\" }).min(1, { error: \"must be a non-empty signal name\" }),\n        {\n            error: \"must be an array of signal names\",\n        },\n    ),\n    { error: \"must be a record of GLib type names to signal name arrays\" },\n);\n\nconst moduleExportSchema = z.object(\n    {\n        module: z.string({ error: \"must be a module specifier\" }).min(1, { error: \"must be a module specifier\" }),\n        export: z.string({ error: \"must be an export name\" }).min(1, { error: \"must be an export name\" }),\n    },\n    { error: \"must be a { module, export } object\" },\n);\n\nconst elementConfigSchema = z.object({\n    component: moduleExportSchema.optional(),\n    props: moduleExportSchema.optional(),\n    lazy: z.boolean({ error: \"must be a boolean\" }).optional(),\n    omitProps: z\n        .array(\n            z.string({ error: \"must be a non-empty property name\" }).min(1, {\n                error: \"must be a non-empty property name\",\n            }),\n            { error: \"must be an array of property names\" },\n        )\n        .optional(),\n});\n\nconst elementsSchema = z.object({\n    behaviors: z\n        .string({ error: \"must be a path to a module exporting element behaviors\" })\n        .min(1, { error: \"must be a path to a module exporting element behaviors\" })\n        .optional(),\n    config: z.record(z.string(), elementConfigSchema).optional(),\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    reactCompiler: reactCompilerSchema.optional(),\n    codegen: z.boolean({ error: \"must be a boolean\" }).optional(),\n    userEventSignals: userEventSignalsSchema.optional(),\n    elements: elementsSchema.optional(),\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 */\nconst defineConfig: DefineConfig<Config> = createDefineConfig<Config>();\n\nconst libraryEntryIssues = (value: unknown[], index: number, entry: unknown): ReturnType<typeof rawIssue>[] => {\n    if (typeof entry === \"string\" && GIR_LIBRARY_PATTERN.test(entry)) {\n        return [];\n    }\n\n    if (entry === LIBRARIES_WILDCARD) {\n        const message =\n            `to generate every library, set \\`libraries: \"${LIBRARIES_WILDCARD}\"\\` as a bare string, ` +\n            \"not an array entry\";\n\n        return [rawIssue(value, [index], message, true)];\n    }\n\n    const message =\n        `invalid library identifier \"${String(entry)}\", must be of the form \"Name-Version\" ` +\n        '(e.g. \"Gtk-4.0\")';\n\n    return [rawIssue(value, [index], message, true)];\n};\n\nconst isValidApplicationId = (applicationId: string): boolean => {\n    if (applicationId.length === 0 || applicationId.length > APPLICATION_ID_MAX_LENGTH) {\n        return false;\n    }\n\n    return APPLICATION_ID_PATTERN.test(applicationId);\n};\n\nconst resolveReactCompilerOptions = (setting: Config[\"reactCompiler\"]): ResolvedReactCompilerOptions | null => {\n    if (setting === false) {\n        return null;\n    }\n\n    const overrides = setting === undefined || setting === true ? {} : setting;\n\n    return { ...overrides, target: REACT_COMPILER_TARGET };\n};\n\nconst isValidReactCompilerOption = (value: unknown, allowed: Set<string>): boolean =>\n    value === undefined || (typeof value === \"string\" && allowed.has(value));\n\nconst validateConfig = (config: Config): void => {\n    const result = configSchema.safeParse(config);\n\n    if (!result.success) {\n        throw configError(result.error);\n    }\n};\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 */\nconst mergeConfig = (base: Config, override: Config): Config => defu(override, base);\n\nconst resolveElementsModule = (behaviors: string | undefined, root: string | undefined): string | null => {\n    if (behaviors === undefined) {\n        return null;\n    }\n\n    return root === undefined ? behaviors : resolve(root, behaviors);\n};\n\nconst resolveLazyElements = (elements: Config[\"elements\"]): string[] =>\n    Object.entries(elements?.config ?? {})\n        .filter(([, entry]) => entry.lazy === true)\n        .map(([type]) => type);\n\nconst elementEntryValues = <T>(\n    elements: Config[\"elements\"],\n    pick: (entry: ElementConfigEntry) => T | undefined,\n): Record<string, T> =>\n    Object.fromEntries(\n        Object.entries(elements?.config ?? {}).flatMap(([type, entry]) => {\n            const value = pick(entry);\n\n            return value === undefined ? [] : [[type, value] as const];\n        }),\n    );\n\nconst resolveElementComponents = (elements: Config[\"elements\"]): Record<string, ModuleExport> =>\n    elementEntryValues(elements, (entry) => entry.component);\n\nconst resolveElementProps = (elements: Config[\"elements\"]): Record<string, ModuleExport> =>\n    elementEntryValues(elements, (entry) => entry.props);\n\nconst resolveOmitProps = (elements: Config[\"elements\"]): Record<string, string[]> =>\n    elementEntryValues(elements, (entry) => entry.omitProps);\n\nconst resolveConfig = (config: Config, root?: string): ResolvedConfig => ({\n    applicationId: config.applicationId,\n    reactCompiler: resolveReactCompilerOptions(config.reactCompiler),\n    userEventSignals: resolveUserEventSignals(config.userEventSignals),\n    elements: resolveElementsModule(config.elements?.behaviors, root),\n    lazyElements: resolveLazyElements(config.elements),\n});\n\nexport {\n    defineConfig,\n    isValidApplicationId,\n    resolveReactCompilerOptions,\n    validateConfig,\n    mergeConfig,\n    resolveLazyElements,\n    resolveElementComponents,\n    resolveElementProps,\n    resolveOmitProps,\n    resolveConfig,\n    type ResolvedReactCompilerOptions,\n    type Config,\n    type ModuleExport,\n    type ResolvedConfig,\n};\n"]}
+{"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 { resolve } from \"node:path\";\nimport { z } from \"zod\";\nimport { configError, isRecord, rawIssue } from \"./config-error.ts\";\nimport { resolveUserEventSignals } from \"./user-event-signals.ts\";\n\n/** Accepted `reactCompiler.compilationMode` values, choosing which functions the compiler processes. */\ntype ReactCompilerCompilationMode = (typeof COMPILATION_MODES)[number];\n/** Accepted `reactCompiler.panicThreshold` values, choosing which compiler diagnostics fail the build. */\ntype ReactCompilerPanicThreshold = (typeof PANIC_THRESHOLDS)[number];\n\n/** Object form of the `reactCompiler` config key, forwarded as-is to `babel-plugin-react-compiler`. */\ntype ReactCompilerOptions = {\n    /** Which functions the compiler processes; left to the compiler's own default when omitted. */\n    compilationMode?: ReactCompilerCompilationMode;\n    /** Which compiler diagnostics fail the build; left to the compiler's own default when omitted. */\n    panicThreshold?: ReactCompilerPanicThreshold;\n};\n\n/**\n * The React Compiler options the build hands to `babel-plugin-react-compiler`, with the React version\n * GTKX targets filled in.\n */\ntype ResolvedReactCompilerOptions = ReactCompilerOptions & {\n    /** React major version the compiler emits for. */\n    target: \"19\";\n};\n\n/**\n * User-facing configuration for a GTKX project, as authored in `gtkx.config.ts`: the GIR libraries\n * to bind and where to find them, the GApplication id, per-element configuration, and the React\n * Compiler, codegen, and user event signal settings.\n */\ntype Config = z.infer<typeof configSchema>;\ntype ModuleExport = z.infer<typeof moduleExportSchema>;\ntype ElementConfigEntry = z.infer<typeof elementConfigSchema>;\n\n/** Configuration reduced to the values the app runtime and the build need, with paths already resolved. */\ntype ResolvedConfig = {\n    /** The GApplication identifier the app registers under. */\n    applicationId: string;\n    /** React Compiler options for the build, or `null` when the compiler is disabled. */\n    reactCompiler: ResolvedReactCompilerOptions | null;\n    /** Signal names, keyed by GLib type name, that stay suppressed while a React commit runs. */\n    userEventSignals: Record<string, string[]>;\n    /** Path of the module exporting per-element configs, or `null` when none is configured. */\n    elements: string | null;\n    /** GLib type names of the elements marked `isLazy`, whose GObject their parent container creates. */\n    lazyElements: string[];\n};\n\nconst LIBRARIES_WILDCARD = \"*\";\nconst GIR_LIBRARY_PATTERN = /^[A-Za-z][A-Za-z0-9]*-\\d+(?:\\.\\d+)*$/;\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/** Compilation modes `babel-plugin-react-compiler` accepts. */\nconst COMPILATION_MODES = [\"infer\", \"syntax\", \"annotation\", \"all\"] as const;\n/** Panic thresholds `babel-plugin-react-compiler` accepts. */\nconst PANIC_THRESHOLDS = [\"none\", \"critical_errors\", \"all_errors\"] as const;\nconst REACT_COMPILER_TARGET = \"19\";\nconst COMPILATION_MODE_SET: Set<string> = new Set(COMPILATION_MODES);\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\n    if (value === LIBRARIES_WILDCARD) {\n        return;\n    }\n\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\n        return;\n    }\n\n    for (const [index, entry] of value.entries()) {\n        ctx.issues.push(...libraryEntryIssues(value, index, entry));\n    }\n});\n\nconst applicationIdSchema = z.custom<string>().check((ctx) => {\n    const value = ctx.value;\n\n    if (typeof value !== \"string\" || !isValidApplicationId(value)) {\n        ctx.issues.push(\n            rawIssue(\n                value,\n                [],\n                `invalid \\`applicationId\\` \"${value}\", must satisfy g_application_id_is_valid ` +\n                '(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\n    if (typeof value === \"boolean\") {\n        return;\n    }\n\n    if (!isRecord(value)) {\n        ctx.issues.push(rawIssue(value, [], \"must be a boolean or an options object\"));\n\n        return;\n    }\n\n    const compilationMode = value.compilationMode;\n\n    if (!isValidReactCompilerOption(compilationMode, COMPILATION_MODE_SET)) {\n        ctx.issues.push(\n            rawIssue(\n                value,\n                [],\n                `invalid \\`reactCompiler.compilationMode\\` \"${String(compilationMode)}\", ` +\n                `must be one of ${COMPILATION_MODES.join(\", \")}`,\n                true,\n            ),\n        );\n    }\n\n    const panicThreshold = value.panicThreshold;\n\n    if (!isValidReactCompilerOption(panicThreshold, PANIC_THRESHOLD_SET)) {\n        ctx.issues.push(\n            rawIssue(\n                value,\n                [],\n                `invalid \\`reactCompiler.panicThreshold\\` \"${String(panicThreshold)}\", ` +\n                `must be one of ${PANIC_THRESHOLDS.join(\", \")}`,\n                true,\n            ),\n        );\n    }\n});\n\nconst userEventSignalsSchema = z.record(\n    z.string(),\n    z.array(\n        z.string({ error: \"must be a non-empty signal name\" }).min(1, { error: \"must be a non-empty signal name\" }),\n        {\n            error: \"must be an array of signal names\",\n        },\n    ),\n    { error: \"must be a record of GLib type names to signal name arrays\" },\n);\n\nconst moduleExportSchema = z.object(\n    {\n        module: z.string({ error: \"must be a module specifier\" }).min(1, { error: \"must be a module specifier\" }),\n        export: z.string({ error: \"must be an export name\" }).min(1, { error: \"must be an export name\" }),\n    },\n    { error: \"must be a { module, export } object\" },\n);\n\nconst elementConfigSchema = z.object({\n    component: moduleExportSchema.optional(),\n    props: moduleExportSchema.optional(),\n    isLazy: z.boolean({ error: \"must be a boolean\" }).optional(),\n    omittedProps: z\n        .array(\n            z.string({ error: \"must be a non-empty property name\" }).min(1, {\n                error: \"must be a non-empty property name\",\n            }),\n            { error: \"must be an array of property names\" },\n        )\n        .optional(),\n});\n\nconst elementsSchema = z.object({\n    behaviors: z\n        .string({ error: \"must be a path to a module exporting element behaviors\" })\n        .min(1, { error: \"must be a path to a module exporting element behaviors\" })\n        .optional(),\n    config: z.record(z.string(), elementConfigSchema).optional(),\n});\n\n/** Schema every `gtkx.config.ts` is validated against, and the source of the {@link Config} type. */\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    reactCompiler: reactCompilerSchema.optional(),\n    codegen: z.boolean({ error: \"must be a boolean\" }).optional(),\n    userEventSignals: userEventSignalsSchema.optional(),\n    elements: elementsSchema.optional(),\n});\n\n/**\n * Returns the given configuration unchanged, typed as {@link Config}, so `gtkx.config.ts` gets\n * autocompletion and type checking.\n */\nconst defineConfig: DefineConfig<Config> = createDefineConfig<Config>();\n\nconst libraryEntryIssues = (value: unknown[], index: number, entry: unknown): ReturnType<typeof rawIssue>[] => {\n    if (typeof entry === \"string\" && GIR_LIBRARY_PATTERN.test(entry)) {\n        return [];\n    }\n\n    if (entry === LIBRARIES_WILDCARD) {\n        const message =\n            `to generate every library, set \\`libraries: \"${LIBRARIES_WILDCARD}\"\\` as a bare string, ` +\n            \"not an array entry\";\n\n        return [rawIssue(value, [index], message, true)];\n    }\n\n    const message =\n        `invalid library identifier \"${String(entry)}\", must be of the form \"Name-Version\" ` +\n        '(e.g. \"Gtk-4.0\")';\n\n    return [rawIssue(value, [index], message, true)];\n};\n\nconst isValidApplicationId = (applicationId: string): boolean => {\n    if (applicationId.length === 0 || applicationId.length > APPLICATION_ID_MAX_LENGTH) {\n        return false;\n    }\n\n    return APPLICATION_ID_PATTERN.test(applicationId);\n};\n\nconst resolveReactCompilerOptions = (setting: Config[\"reactCompiler\"]): ResolvedReactCompilerOptions | null => {\n    if (setting === false) {\n        return null;\n    }\n\n    const overrides = setting === undefined || setting === true ? {} : setting;\n\n    return { ...overrides, target: REACT_COMPILER_TARGET };\n};\n\nconst isValidReactCompilerOption = (value: unknown, allowed: Set<string>): boolean =>\n    value === undefined || (typeof value === \"string\" && allowed.has(value));\n\nconst validateConfig = (config: Config): void => {\n    const result = configSchema.safeParse(config);\n\n    if (!result.success) {\n        throw configError(result.error);\n    }\n};\n\n/**\n * Deep-merges two configurations. `override` wins over `base` on conflicting scalar and object keys, while\n * arrays are concatenated with the `override` entries first.\n */\nconst mergeConfig = (base: Config, override: Config): Config => defu(override, base);\n\nconst resolveElementsModule = (behaviors: string | undefined, root: string | undefined): string | null => {\n    if (behaviors === undefined) {\n        return null;\n    }\n\n    return root === undefined ? behaviors : resolve(root, behaviors);\n};\n\nconst resolveLazyElements = (elements: Config[\"elements\"]): string[] =>\n    Object.entries(elements?.config ?? {})\n        .filter(([, entry]) => entry.isLazy === true)\n        .map(([type]) => type);\n\nconst elementEntryValues = <T>(\n    elements: Config[\"elements\"],\n    pick: (entry: ElementConfigEntry) => T | undefined,\n): Record<string, T> =>\n    Object.fromEntries(\n        Object.entries(elements?.config ?? {}).flatMap(([type, entry]) => {\n            const value = pick(entry);\n\n            return value === undefined ? [] : [[type, value] as const];\n        }),\n    );\n\nconst resolveElementComponents = (elements: Config[\"elements\"]): Record<string, ModuleExport> =>\n    elementEntryValues(elements, (entry) => entry.component);\n\nconst resolveElementProps = (elements: Config[\"elements\"]): Record<string, ModuleExport> =>\n    elementEntryValues(elements, (entry) => entry.props);\n\nconst resolveOmittedProps = (elements: Config[\"elements\"]): Record<string, string[]> =>\n    elementEntryValues(elements, (entry) => entry.omittedProps);\n\nconst resolveConfig = (config: Config, root?: string): ResolvedConfig => ({\n    applicationId: config.applicationId,\n    reactCompiler: resolveReactCompilerOptions(config.reactCompiler),\n    userEventSignals: resolveUserEventSignals(config.userEventSignals),\n    elements: resolveElementsModule(config.elements?.behaviors, root),\n    lazyElements: resolveLazyElements(config.elements),\n});\n\nexport {\n    defineConfig,\n    isValidApplicationId,\n    resolveReactCompilerOptions,\n    validateConfig,\n    mergeConfig,\n    resolveLazyElements,\n    resolveElementComponents,\n    resolveElementProps,\n    resolveOmittedProps,\n    resolveConfig,\n    type ResolvedReactCompilerOptions,\n    type Config,\n    type ResolvedConfig,\n};\n"]}

package/dist/index.d.ts

@@ -1,3 +1,5 @@
-export { type Config, defineConfig, mergeConfig, type ResolvedConfig, type ResolvedReactCompilerOptions, } from "./config.js";
-export { type LoadedConfig, loadConfig } from "./loader.js";
+/** @public */
+export { type Config, defineConfig, mergeConfig, type ResolvedConfig } from "./config.ts";
+/** @public */
+export { type ConfigLoader, type LoadedConfig, loadConfig } from "./loader.ts";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACH,KAAK,MAAM,EACX,YAAY,EACZ,WAAW,EACX,KAAK,cAAc,EACnB,KAAK,4BAA4B,GACpC,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,KAAK,YAAY,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc;AACd,OAAO,EAAE,KAAK,MAAM,EAAE,YAAY,EAAE,WAAW,EAAE,KAAK,cAAc,EAAE,MAAM,aAAa,CAAC;AAC1F,cAAc;AACd,OAAO,EAAE,KAAK,YAAY,EAAE,KAAK,YAAY,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC"}

package/dist/index.js

@@ -1,3 +1,5 @@
-export { defineConfig, mergeConfig, } from "./config.js";
+/** @public */
+export { defineConfig, mergeConfig } from "./config.js";
+/** @public */
 export { loadConfig } from "./loader.js";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAEH,YAAY,EACZ,WAAW,GAGd,MAAM,aAAa,CAAC;AACrB,OAAO,EAAqB,UAAU,EAAE,MAAM,aAAa,CAAC","sourcesContent":["export {\n    type Config,\n    defineConfig,\n    mergeConfig,\n    type ResolvedConfig,\n    type ResolvedReactCompilerOptions,\n} from \"./config.js\";\nexport { type LoadedConfig, loadConfig } from \"./loader.js\";\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc;AACd,OAAO,EAAe,YAAY,EAAE,WAAW,EAAuB,MAAM,aAAa,CAAC;AAC1F,cAAc;AACd,OAAO,EAAwC,UAAU,EAAE,MAAM,aAAa,CAAC","sourcesContent":["/** @public */\nexport { type Config, defineConfig, mergeConfig, type ResolvedConfig } from \"./config.ts\";\n/** @public */\nexport { type ConfigLoader, type LoadedConfig, loadConfig } from \"./loader.ts\";\n"]}

package/dist/internal.d.ts

@@ -1,3 +1,4 @@
-export { isValidApplicationId, resolveElementComponents, resolveElementProps, resolveLazyElements, resolveOmitProps, } from "./config.js";
-export { type ConfigLoader, createConfigLoader } from "./loader.js";
+export type { ResolvedReactCompilerOptions } from "./config.ts";
+export { isValidApplicationId, resolveElementComponents, resolveElementProps, resolveLazyElements, resolveOmittedProps, } from "./config.ts";
+export { createConfigLoader } from "./loader.ts";
 //# sourceMappingURL=internal.d.ts.map

package/dist/internal.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"internal.d.ts","sourceRoot":"","sources":["../src/internal.ts"],"names":[],"mappings":"AAAA,OAAO,EACH,oBAAoB,EACpB,wBAAwB,EACxB,mBAAmB,EACnB,mBAAmB,EACnB,gBAAgB,GACnB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,KAAK,YAAY,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC"}
+{"version":3,"file":"internal.d.ts","sourceRoot":"","sources":["../src/internal.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,4BAA4B,EAAE,MAAM,aAAa,CAAC;AAChE,OAAO,EACH,oBAAoB,EACpB,wBAAwB,EACxB,mBAAmB,EACnB,mBAAmB,EACnB,mBAAmB,GACtB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC"}

package/dist/internal.js

@@ -1,3 +1,3 @@
-export { isValidApplicationId, resolveElementComponents, resolveElementProps, resolveLazyElements, resolveOmitProps, } from "./config.js";
+export { isValidApplicationId, resolveElementComponents, resolveElementProps, resolveLazyElements, resolveOmittedProps, } from "./config.js";
 export { createConfigLoader } from "./loader.js";
 //# sourceMappingURL=internal.js.map

package/dist/internal.js.map

@@ -1 +1 @@
-{"version":3,"file":"internal.js","sourceRoot":"","sources":["../src/internal.ts"],"names":[],"mappings":"AAAA,OAAO,EACH,oBAAoB,EACpB,wBAAwB,EACxB,mBAAmB,EACnB,mBAAmB,EACnB,gBAAgB,GACnB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAqB,kBAAkB,EAAE,MAAM,aAAa,CAAC","sourcesContent":["export {\n    isValidApplicationId,\n    resolveElementComponents,\n    resolveElementProps,\n    resolveLazyElements,\n    resolveOmitProps,\n} from \"./config.js\";\nexport { type ConfigLoader, createConfigLoader } from \"./loader.js\";\n"]}
+{"version":3,"file":"internal.js","sourceRoot":"","sources":["../src/internal.ts"],"names":[],"mappings":"AACA,OAAO,EACH,oBAAoB,EACpB,wBAAwB,EACxB,mBAAmB,EACnB,mBAAmB,EACnB,mBAAmB,GACtB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC","sourcesContent":["export type { ResolvedReactCompilerOptions } from \"./config.ts\";\nexport {\n    isValidApplicationId,\n    resolveElementComponents,\n    resolveElementProps,\n    resolveLazyElements,\n    resolveOmittedProps,\n} from \"./config.ts\";\nexport { createConfigLoader } from \"./loader.ts\";\n"]}

package/dist/loader.d.ts

@@ -1,31 +1,35 @@
-import { type Config, type ResolvedConfig } from "./config.js";
-/**
- * Result of loading a `gtkx.config.ts` file: the parsed configuration, the
- * resolved config file path, and the project root it was loaded from.
- */
+import { type Config, type ResolvedConfig } from "./config.ts";
+/** Result of loading a project's `gtkx.config.ts` file. */
 type LoadedConfig = {
+    /** The parsed and validated configuration. */
     config: Config;
+    /** Absolute path of the configuration file that was loaded. */
     configFile: string;
+    /** Absolute path of the project root the configuration was resolved against. */
     root: string;
 };
+/** How a configuration file is read, shared by {@link loadConfig} and `createConfigLoader`. */
 type LoadConfigOptions = {
+    /**
+     * Environment name such as `development`: the config's matching `$<mode>` block is layered over the
+     * top-level values, and the name is passed to a config authored as a function.
+     */
     mode?: string | undefined;
 };
-/**
- * Caching accessor for a project's configuration: `load` yields the validated authored config together with
- * its file path, and `resolve` yields the projection an app needs at runtime.
- */
+/** Reads a project's configuration once per directory, caching what it loads and what it resolves. */
 type ConfigLoader = {
+    /** Loads the configuration file the given directory resolves to, as {@link loadConfig} does. */
     load: (cwd: string) => Promise<LoadedConfig>;
+    /** Loads the configuration for the given directory and reduces it to what the build and the app need. */
     resolve: (cwd: string) => Promise<ResolvedConfig>;
 };
 /**
- * Loads and validates the `gtkx.config.ts` file for a project, returning the
- * parsed configuration together with the config file path and project root.
- * @param cwd Directory from which to search for the configuration file.
- * @param options Loading options, such as the environment mode.
+ * Loads and validates the `gtkx.config.ts` file for a project.
+ * @param cwd Directory the configuration file is looked up in.
+ * @param options Loading options, such as the environment mode whose overrides are applied.
+ * @throws When the configuration fails validation, or when no configuration file is found.
  */
 declare const loadConfig: (cwd: string, options?: LoadConfigOptions) => Promise<LoadedConfig>;
 declare const createConfigLoader: (options?: LoadConfigOptions) => ConfigLoader;
-export { loadConfig, createConfigLoader, type LoadedConfig, type LoadConfigOptions, type ConfigLoader };
+export { loadConfig, createConfigLoader, type LoadedConfig, type ConfigLoader };
 //# sourceMappingURL=loader.d.ts.map

package/dist/loader.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../src/loader.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,KAAK,MAAM,EAAiB,KAAK,cAAc,EAAkB,MAAM,aAAa,CAAC;AAE9F;;;GAGG;AACH,KAAK,YAAY,GAAG;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,KAAK,iBAAiB,GAAG;IACrB,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC7B,CAAC;AAEF;;;GAGG;AACH,KAAK,YAAY,GAAG;IAChB,IAAI,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,YAAY,CAAC,CAAC;IAC7C,OAAO,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,cAAc,CAAC,CAAC;CACrD,CAAC;AAEF;;;;;GAKG;AACH,QAAA,MAAM,UAAU,GAAU,KAAK,MAAM,EAAE,UAAS,iBAAsB,KAAG,OAAO,CAAC,YAAY,CAwB5F,CAAC;AAEF,QAAA,MAAM,kBAAkB,GAAI,UAAS,iBAAsB,KAAG,YAiB7D,CAAC;AAEF,OAAO,EAAE,UAAU,EAAE,kBAAkB,EAAE,KAAK,YAAY,EAAE,KAAK,iBAAiB,EAAE,KAAK,YAAY,EAAE,CAAC"}
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../src/loader.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,KAAK,MAAM,EAAiB,KAAK,cAAc,EAAkB,MAAM,aAAa,CAAC;AAE9F,2DAA2D;AAC3D,KAAK,YAAY,GAAG;IAChB,8CAA8C;IAC9C,MAAM,EAAE,MAAM,CAAC;IACf,+DAA+D;IAC/D,UAAU,EAAE,MAAM,CAAC;IACnB,gFAAgF;IAChF,IAAI,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,+FAA+F;AAC/F,KAAK,iBAAiB,GAAG;IACrB;;;OAGG;IACH,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC7B,CAAC;AAEF,sGAAsG;AACtG,KAAK,YAAY,GAAG;IAChB,gGAAgG;IAChG,IAAI,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,YAAY,CAAC,CAAC;IAC7C,yGAAyG;IACzG,OAAO,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,cAAc,CAAC,CAAC;CACrD,CAAC;AAEF;;;;;GAKG;AACH,QAAA,MAAM,UAAU,GAAU,KAAK,MAAM,EAAE,UAAS,iBAAsB,KAAG,OAAO,CAAC,YAAY,CAwB5F,CAAC;AAEF,QAAA,MAAM,kBAAkB,GAAI,UAAS,iBAAsB,KAAG,YAiB7D,CAAC;AAEF,OAAO,EAAE,UAAU,EAAE,kBAAkB,EAAE,KAAK,YAAY,EAAE,KAAK,YAAY,EAAE,CAAC"}

package/dist/loader.js

@@ -4,10 +4,10 @@ import { existsSync } from "node:fs";
 import { resolve } from "node:path";
 import { resolveConfig, validateConfig } from "./config.js";
 /**
- * Loads and validates the `gtkx.config.ts` file for a project, returning the
- * parsed configuration together with the config file path and project root.
- * @param cwd Directory from which to search for the configuration file.
- * @param options Loading options, such as the environment mode.
+ * Loads and validates the `gtkx.config.ts` file for a project.
+ * @param cwd Directory the configuration file is looked up in.
+ * @param options Loading options, such as the environment mode whose overrides are applied.
+ * @throws When the configuration fails validation, or when no configuration file is found.
  */
 const loadConfig = async (cwd, options = {}) => {
     const result = await loadConfigFile({

package/dist/loader.js.map

@@ -1 +1 @@
-{"version":3,"file":"loader.js","sourceRoot":"","sources":["../src/loader.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,UAAU,IAAI,cAAc,EAAE,MAAM,KAAK,CAAC;AACnD,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAe,aAAa,EAAuB,cAAc,EAAE,MAAM,aAAa,CAAC;AAyB9F;;;;;GAKG;AACH,MAAM,UAAU,GAAG,KAAK,EAAE,GAAW,EAAE,UAA6B,EAAE,EAAyB,EAAE;IAC7F,MAAM,MAAM,GAAG,MAAM,cAAc,CAAS;QACxC,IAAI,EAAE,MAAM;QACZ,GAAG;QACH,MAAM,EAAE,KAAK;QACb,QAAQ,EAAE,KAAK;QACf,WAAW,EAAE,KAAK;QAClB,OAAO,EAAE,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE;QAC/B,GAAG,CAAC,CAAC,OAAO,CAAC,IAAI,KAAK,SAAS,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,CAAC,IAAI,EAAE,CAAC;KACjE,CAAC,CAAC;IAEH,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;IAC7B,MAAM,UAAU,GAAG,MAAM,CAAC,UAAU,CAAC;IACrC,cAAc,CAAC,MAAM,CAAC,CAAC;IAEvB,IAAI,UAAU,KAAK,SAAS,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,GAAG,EAAE,UAAU,CAAC,CAAC,EAAE,CAAC;QACpE,MAAM,IAAI,KAAK,CAAC,wDAAwD,GAAG,EAAE,CAAC,CAAC;IACnF,CAAC;IAED,OAAO;QACH,MAAM;QACN,UAAU;QACV,IAAI,EAAE,MAAM,CAAC,GAAG,IAAI,GAAG;KAC1B,CAAC;AACN,CAAC,CAAC;AAEF,MAAM,kBAAkB,GAAG,CAAC,UAA6B,EAAE,EAAgB,EAAE;IACzE,MAAM,MAAM,GAAuC,IAAI,GAAG,EAAE,CAAC;IAC7D,MAAM,QAAQ,GAAyC,IAAI,GAAG,EAAE,CAAC;IAEjE,MAAM,IAAI,GAAG,CAAC,GAAW,EAAyB,EAAE,CAChD,WAAW,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,UAAU,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC;IAE3E,MAAM,SAAS,GAAG,KAAK,EAAE,IAAY,EAA2B,EAAE;QAC9D,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,EAAE,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,CAAC;QAEtD,OAAO,aAAa,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IAC7C,CAAC,CAAC;IAEF,OAAO;QACH,IAAI;QACJ,OAAO,EAAE,CAAC,GAAW,EAA2B,EAAE,CAAC,WAAW,CAAC,QAAQ,EAAE,OAAO,CAAC,GAAG,CAAC,EAAE,SAAS,CAAC;KACpG,CAAC;AACN,CAAC,CAAC;AAEF,OAAO,EAAE,UAAU,EAAE,kBAAkB,EAAgE,CAAC","sourcesContent":["import { getOrInsert } from \"@gtkx/utils\";\nimport { loadConfig as loadConfigFile } from \"c12\";\nimport { existsSync } from \"node:fs\";\nimport { resolve } from \"node:path\";\nimport { type Config, resolveConfig, type ResolvedConfig, validateConfig } from \"./config.js\";\n\n/**\n * Result of loading a `gtkx.config.ts` file: the parsed configuration, the\n * resolved config file path, and the project root it was loaded from.\n */\ntype LoadedConfig = {\n    config: Config;\n    configFile: string;\n    root: string;\n};\n\ntype LoadConfigOptions = {\n    mode?: string | undefined;\n};\n\n/**\n * Caching accessor for a project's configuration: `load` yields the validated authored config together with\n * its file path, and `resolve` yields the projection an app needs at runtime.\n */\ntype ConfigLoader = {\n    load: (cwd: string) => Promise<LoadedConfig>;\n    resolve: (cwd: string) => Promise<ResolvedConfig>;\n};\n\n/**\n * Loads and validates the `gtkx.config.ts` file for a project, returning the\n * parsed configuration together with the config file path and project root.\n * @param cwd Directory from which to search for the configuration file.\n * @param options Loading options, such as the environment mode.\n */\nconst loadConfig = async (cwd: string, options: LoadConfigOptions = {}): Promise<LoadedConfig> => {\n    const result = await loadConfigFile<Config>({\n        name: \"gtkx\",\n        cwd,\n        rcFile: false,\n        globalRc: false,\n        packageJson: false,\n        context: { mode: options.mode },\n        ...((options.mode !== undefined) && { envName: options.mode }),\n    });\n\n    const config = result.config;\n    const configFile = result.configFile;\n    validateConfig(config);\n\n    if (configFile === undefined || !existsSync(resolve(cwd, configFile))) {\n        throw new Error(`gtkx.config.ts: no configuration file was found from ${cwd}`);\n    }\n\n    return {\n        config,\n        configFile,\n        root: result.cwd ?? cwd,\n    };\n};\n\nconst createConfigLoader = (options: LoadConfigOptions = {}): ConfigLoader => {\n    const loaded: Map<string, Promise<LoadedConfig>> = new Map();\n    const resolved: Map<string, Promise<ResolvedConfig>> = new Map();\n\n    const load = (cwd: string): Promise<LoadedConfig> =>\n        getOrInsert(loaded, resolve(cwd), (root) => loadConfig(root, options));\n\n    const resolveAt = async (root: string): Promise<ResolvedConfig> => {\n        const { config, root: configRoot } = await load(root);\n\n        return resolveConfig(config, configRoot);\n    };\n\n    return {\n        load,\n        resolve: (cwd: string): Promise<ResolvedConfig> => getOrInsert(resolved, resolve(cwd), resolveAt),\n    };\n};\n\nexport { loadConfig, createConfigLoader, type LoadedConfig, type LoadConfigOptions, type ConfigLoader };\n"]}
+{"version":3,"file":"loader.js","sourceRoot":"","sources":["../src/loader.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,UAAU,IAAI,cAAc,EAAE,MAAM,KAAK,CAAC;AACnD,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAe,aAAa,EAAuB,cAAc,EAAE,MAAM,aAAa,CAAC;AA6B9F;;;;;GAKG;AACH,MAAM,UAAU,GAAG,KAAK,EAAE,GAAW,EAAE,UAA6B,EAAE,EAAyB,EAAE;IAC7F,MAAM,MAAM,GAAG,MAAM,cAAc,CAAS;QACxC,IAAI,EAAE,MAAM;QACZ,GAAG;QACH,MAAM,EAAE,KAAK;QACb,QAAQ,EAAE,KAAK;QACf,WAAW,EAAE,KAAK;QAClB,OAAO,EAAE,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE;QAC/B,GAAG,CAAC,CAAC,OAAO,CAAC,IAAI,KAAK,SAAS,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,CAAC,IAAI,EAAE,CAAC;KACjE,CAAC,CAAC;IAEH,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;IAC7B,MAAM,UAAU,GAAG,MAAM,CAAC,UAAU,CAAC;IACrC,cAAc,CAAC,MAAM,CAAC,CAAC;IAEvB,IAAI,UAAU,KAAK,SAAS,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,GAAG,EAAE,UAAU,CAAC,CAAC,EAAE,CAAC;QACpE,MAAM,IAAI,KAAK,CAAC,wDAAwD,GAAG,EAAE,CAAC,CAAC;IACnF,CAAC;IAED,OAAO;QACH,MAAM;QACN,UAAU;QACV,IAAI,EAAE,MAAM,CAAC,GAAG,IAAI,GAAG;KAC1B,CAAC;AACN,CAAC,CAAC;AAEF,MAAM,kBAAkB,GAAG,CAAC,UAA6B,EAAE,EAAgB,EAAE;IACzE,MAAM,MAAM,GAAuC,IAAI,GAAG,EAAE,CAAC;IAC7D,MAAM,QAAQ,GAAyC,IAAI,GAAG,EAAE,CAAC;IAEjE,MAAM,IAAI,GAAG,CAAC,GAAW,EAAyB,EAAE,CAChD,WAAW,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,UAAU,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC;IAE3E,MAAM,SAAS,GAAG,KAAK,EAAE,IAAY,EAA2B,EAAE;QAC9D,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,EAAE,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,CAAC;QAEtD,OAAO,aAAa,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IAC7C,CAAC,CAAC;IAEF,OAAO;QACH,IAAI;QACJ,OAAO,EAAE,CAAC,GAAW,EAA2B,EAAE,CAAC,WAAW,CAAC,QAAQ,EAAE,OAAO,CAAC,GAAG,CAAC,EAAE,SAAS,CAAC;KACpG,CAAC;AACN,CAAC,CAAC;AAEF,OAAO,EAAE,UAAU,EAAE,kBAAkB,EAAwC,CAAC","sourcesContent":["import { getOrInsert } from \"@gtkx/utils\";\nimport { loadConfig as loadConfigFile } from \"c12\";\nimport { existsSync } from \"node:fs\";\nimport { resolve } from \"node:path\";\nimport { type Config, resolveConfig, type ResolvedConfig, validateConfig } from \"./config.ts\";\n\n/** Result of loading a project's `gtkx.config.ts` file. */\ntype LoadedConfig = {\n    /** The parsed and validated configuration. */\n    config: Config;\n    /** Absolute path of the configuration file that was loaded. */\n    configFile: string;\n    /** Absolute path of the project root the configuration was resolved against. */\n    root: string;\n};\n\n/** How a configuration file is read, shared by {@link loadConfig} and `createConfigLoader`. */\ntype LoadConfigOptions = {\n    /**\n     * Environment name such as `development`: the config's matching `$<mode>` block is layered over the\n     * top-level values, and the name is passed to a config authored as a function.\n     */\n    mode?: string | undefined;\n};\n\n/** Reads a project's configuration once per directory, caching what it loads and what it resolves. */\ntype ConfigLoader = {\n    /** Loads the configuration file the given directory resolves to, as {@link loadConfig} does. */\n    load: (cwd: string) => Promise<LoadedConfig>;\n    /** Loads the configuration for the given directory and reduces it to what the build and the app need. */\n    resolve: (cwd: string) => Promise<ResolvedConfig>;\n};\n\n/**\n * Loads and validates the `gtkx.config.ts` file for a project.\n * @param cwd Directory the configuration file is looked up in.\n * @param options Loading options, such as the environment mode whose overrides are applied.\n * @throws When the configuration fails validation, or when no configuration file is found.\n */\nconst loadConfig = async (cwd: string, options: LoadConfigOptions = {}): Promise<LoadedConfig> => {\n    const result = await loadConfigFile<Config>({\n        name: \"gtkx\",\n        cwd,\n        rcFile: false,\n        globalRc: false,\n        packageJson: false,\n        context: { mode: options.mode },\n        ...((options.mode !== undefined) && { envName: options.mode }),\n    });\n\n    const config = result.config;\n    const configFile = result.configFile;\n    validateConfig(config);\n\n    if (configFile === undefined || !existsSync(resolve(cwd, configFile))) {\n        throw new Error(`gtkx.config.ts: no configuration file was found from ${cwd}`);\n    }\n\n    return {\n        config,\n        configFile,\n        root: result.cwd ?? cwd,\n    };\n};\n\nconst createConfigLoader = (options: LoadConfigOptions = {}): ConfigLoader => {\n    const loaded: Map<string, Promise<LoadedConfig>> = new Map();\n    const resolved: Map<string, Promise<ResolvedConfig>> = new Map();\n\n    const load = (cwd: string): Promise<LoadedConfig> =>\n        getOrInsert(loaded, resolve(cwd), (root) => loadConfig(root, options));\n\n    const resolveAt = async (root: string): Promise<ResolvedConfig> => {\n        const { config, root: configRoot } = await load(root);\n\n        return resolveConfig(config, configRoot);\n    };\n\n    return {\n        load,\n        resolve: (cwd: string): Promise<ResolvedConfig> => getOrInsert(resolved, resolve(cwd), resolveAt),\n    };\n};\n\nexport { loadConfig, createConfigLoader, type LoadedConfig, type ConfigLoader };\n"]}

package/dist/user-event-signals.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"user-event-signals.d.ts","sourceRoot":"","sources":["../src/user-event-signals.ts"],"names":[],"mappings":"AAAA,QAAA,MAAM,0BAA0B,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CA2CxD,CAAC;AAEF,QAAA,MAAM,uBAAuB,GAAI,WAAW,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,GAAG,SAAS,KAAG,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CASzG,CAAC;AAEF,OAAO,EAAE,0BAA0B,EAAE,uBAAuB,EAAE,CAAC"}
+{"version":3,"file":"user-event-signals.d.ts","sourceRoot":"","sources":["../src/user-event-signals.ts"],"names":[],"mappings":"AAAA,QAAA,MAAM,0BAA0B,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAqCxD,CAAC;AAEF,QAAA,MAAM,uBAAuB,GAAI,WAAW,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,GAAG,SAAS,KAAG,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CASzG,CAAC;AAEF,OAAO,EAAE,0BAA0B,EAAE,uBAAuB,EAAE,CAAC"}

package/dist/user-event-signals.js

@@ -6,15 +6,11 @@ const DEFAULT_USER_EVENT_SIGNALS = {
     AdwTabView: ["close-page", "page-attached", "page-detached", "page-reordered"],
     GObject: ["notify"],
     GtkAdjustment: ["changed", "value-changed"],
-    GtkAppChooserButton: ["changed"],
-    GtkAppChooserWidget: ["application-selected"],
     GtkCalendar: ["day-selected"],
     GtkCheckButton: ["toggled"],
-    GtkComboBox: ["changed"],
     GtkEditable: ["changed", "delete-text", "insert-text"],
     GtkEntryBuffer: ["deleted-text", "inserted-text"],
     GtkFlowBox: ["selected-children-changed"],
-    GtkIconView: ["selection-changed"],
     GtkListBox: ["row-selected", "selected-rows-changed"],
     GtkNotebook: ["page-added", "page-removed", "page-reordered", "switch-page"],
     GtkPopover: ["closed"],
@@ -38,8 +34,6 @@ const DEFAULT_USER_EVENT_SIGNALS = {
         "remove-tag",
     ],
     GtkToggleButton: ["toggled"],
-    GtkTreeSelection: ["changed"],
-    GtkTreeView: ["columns-changed", "cursor-changed", "row-collapsed", "row-expanded"],
     GtkWidget: ["state-flags-changed"],
 };
 const resolveUserEventSignals = (overrides) => {

package/dist/user-event-signals.js.map

@@ -1 +1 @@
-{"version":3,"file":"user-event-signals.js","sourceRoot":"","sources":["../src/user-event-signals.ts"],"names":[],"mappings":"AAAA,MAAM,0BAA0B,GAA6B;IACzD,cAAc,EAAE,CAAC,UAAU,CAAC;IAC5B,WAAW,EAAE,CAAC,cAAc,CAAC;IAC7B,SAAS,EAAE,CAAC,QAAQ,CAAC;IACrB,iBAAiB,EAAE,CAAC,QAAQ,CAAC;IAC7B,UAAU,EAAE,CAAC,YAAY,EAAE,eAAe,EAAE,eAAe,EAAE,gBAAgB,CAAC;IAC9E,OAAO,EAAE,CAAC,QAAQ,CAAC;IACnB,aAAa,EAAE,CAAC,SAAS,EAAE,eAAe,CAAC;IAC3C,mBAAmB,EAAE,CAAC,SAAS,CAAC;IAChC,mBAAmB,EAAE,CAAC,sBAAsB,CAAC;IAC7C,WAAW,EAAE,CAAC,cAAc,CAAC;IAC7B,cAAc,EAAE,CAAC,SAAS,CAAC;IAC3B,WAAW,EAAE,CAAC,SAAS,CAAC;IACxB,WAAW,EAAE,CAAC,SAAS,EAAE,aAAa,EAAE,aAAa,CAAC;IACtD,cAAc,EAAE,CAAC,cAAc,EAAE,eAAe,CAAC;IACjD,UAAU,EAAE,CAAC,2BAA2B,CAAC;IACzC,WAAW,EAAE,CAAC,mBAAmB,CAAC;IAClC,UAAU,EAAE,CAAC,cAAc,EAAE,uBAAuB,CAAC;IACrD,WAAW,EAAE,CAAC,YAAY,EAAE,cAAc,EAAE,gBAAgB,EAAE,aAAa,CAAC;IAC5E,UAAU,EAAE,CAAC,QAAQ,CAAC;IACtB,QAAQ,EAAE,CAAC,eAAe,CAAC;IAC3B,cAAc,EAAE,CAAC,eAAe,CAAC;IACjC,iBAAiB,EAAE,CAAC,cAAc,CAAC;IACnC,cAAc,EAAE,CAAC,gBAAgB,CAAC;IAClC,iBAAiB,EAAE,CAAC,mBAAmB,CAAC;IACxC,aAAa,EAAE,CAAC,eAAe,CAAC;IAChC,SAAS,EAAE,CAAC,WAAW,CAAC;IACxB,aAAa,EAAE;QACX,WAAW;QACX,SAAS;QACT,cAAc;QACd,qBAAqB;QACrB,kBAAkB;QAClB,aAAa;QACb,cAAc;QACd,UAAU;QACV,kBAAkB;QAClB,YAAY;KACf;IACD,eAAe,EAAE,CAAC,SAAS,CAAC;IAC5B,gBAAgB,EAAE,CAAC,SAAS,CAAC;IAC7B,WAAW,EAAE,CAAC,iBAAiB,EAAE,gBAAgB,EAAE,eAAe,EAAE,cAAc,CAAC;IACnF,SAAS,EAAE,CAAC,qBAAqB,CAAC;CACrC,CAAC;AAEF,MAAM,uBAAuB,GAAG,CAAC,SAA+C,EAA4B,EAAE;IAC1G,MAAM,QAAQ,GAA6B,EAAE,GAAG,0BAA0B,EAAE,CAAC;IAC7E,MAAM,eAAe,GAAG,MAAM,CAAC,OAAO,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC;IAExD,KAAK,MAAM,CAAC,QAAQ,EAAE,OAAO,CAAC,IAAI,eAAe,EAAE,CAAC;QAChD,QAAQ,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,EAAE,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IACnF,CAAC;IAED,OAAO,QAAQ,CAAC;AACpB,CAAC,CAAC;AAEF,OAAO,EAAE,0BAA0B,EAAE,uBAAuB,EAAE,CAAC","sourcesContent":["const DEFAULT_USER_EVENT_SIGNALS: Record<string, string[]> = {\n    AdwAlertDialog: [\"response\"],\n    AdwCarousel: [\"page-changed\"],\n    AdwDialog: [\"closed\"],\n    AdwNavigationView: [\"pushed\"],\n    AdwTabView: [\"close-page\", \"page-attached\", \"page-detached\", \"page-reordered\"],\n    GObject: [\"notify\"],\n    GtkAdjustment: [\"changed\", \"value-changed\"],\n    GtkAppChooserButton: [\"changed\"],\n    GtkAppChooserWidget: [\"application-selected\"],\n    GtkCalendar: [\"day-selected\"],\n    GtkCheckButton: [\"toggled\"],\n    GtkComboBox: [\"changed\"],\n    GtkEditable: [\"changed\", \"delete-text\", \"insert-text\"],\n    GtkEntryBuffer: [\"deleted-text\", \"inserted-text\"],\n    GtkFlowBox: [\"selected-children-changed\"],\n    GtkIconView: [\"selection-changed\"],\n    GtkListBox: [\"row-selected\", \"selected-rows-changed\"],\n    GtkNotebook: [\"page-added\", \"page-removed\", \"page-reordered\", \"switch-page\"],\n    GtkPopover: [\"closed\"],\n    GtkRange: [\"value-changed\"],\n    GtkScaleButton: [\"value-changed\"],\n    GtkScrolledWindow: [\"edge-reached\"],\n    GtkSearchEntry: [\"search-changed\"],\n    GtkSelectionModel: [\"selection-changed\"],\n    GtkSpinButton: [\"value-changed\"],\n    GtkSwitch: [\"state-set\"],\n    GtkTextBuffer: [\n        \"apply-tag\",\n        \"changed\",\n        \"delete-range\",\n        \"insert-child-anchor\",\n        \"insert-paintable\",\n        \"insert-text\",\n        \"mark-deleted\",\n        \"mark-set\",\n        \"modified-changed\",\n        \"remove-tag\",\n    ],\n    GtkToggleButton: [\"toggled\"],\n    GtkTreeSelection: [\"changed\"],\n    GtkTreeView: [\"columns-changed\", \"cursor-changed\", \"row-collapsed\", \"row-expanded\"],\n    GtkWidget: [\"state-flags-changed\"],\n};\n\nconst resolveUserEventSignals = (overrides: Record<string, string[]> | undefined): Record<string, string[]> => {\n    const resolved: Record<string, string[]> = { ...DEFAULT_USER_EVENT_SIGNALS };\n    const overrideEntries = Object.entries(overrides ?? {});\n\n    for (const [typeName, signals] of overrideEntries) {\n        resolved[typeName] = [...new Set([...(resolved[typeName] ?? []), ...signals])];\n    }\n\n    return resolved;\n};\n\nexport { DEFAULT_USER_EVENT_SIGNALS, resolveUserEventSignals };\n"]}
+{"version":3,"file":"user-event-signals.js","sourceRoot":"","sources":["../src/user-event-signals.ts"],"names":[],"mappings":"AAAA,MAAM,0BAA0B,GAA6B;IACzD,cAAc,EAAE,CAAC,UAAU,CAAC;IAC5B,WAAW,EAAE,CAAC,cAAc,CAAC;IAC7B,SAAS,EAAE,CAAC,QAAQ,CAAC;IACrB,iBAAiB,EAAE,CAAC,QAAQ,CAAC;IAC7B,UAAU,EAAE,CAAC,YAAY,EAAE,eAAe,EAAE,eAAe,EAAE,gBAAgB,CAAC;IAC9E,OAAO,EAAE,CAAC,QAAQ,CAAC;IACnB,aAAa,EAAE,CAAC,SAAS,EAAE,eAAe,CAAC;IAC3C,WAAW,EAAE,CAAC,cAAc,CAAC;IAC7B,cAAc,EAAE,CAAC,SAAS,CAAC;IAC3B,WAAW,EAAE,CAAC,SAAS,EAAE,aAAa,EAAE,aAAa,CAAC;IACtD,cAAc,EAAE,CAAC,cAAc,EAAE,eAAe,CAAC;IACjD,UAAU,EAAE,CAAC,2BAA2B,CAAC;IACzC,UAAU,EAAE,CAAC,cAAc,EAAE,uBAAuB,CAAC;IACrD,WAAW,EAAE,CAAC,YAAY,EAAE,cAAc,EAAE,gBAAgB,EAAE,aAAa,CAAC;IAC5E,UAAU,EAAE,CAAC,QAAQ,CAAC;IACtB,QAAQ,EAAE,CAAC,eAAe,CAAC;IAC3B,cAAc,EAAE,CAAC,eAAe,CAAC;IACjC,iBAAiB,EAAE,CAAC,cAAc,CAAC;IACnC,cAAc,EAAE,CAAC,gBAAgB,CAAC;IAClC,iBAAiB,EAAE,CAAC,mBAAmB,CAAC;IACxC,aAAa,EAAE,CAAC,eAAe,CAAC;IAChC,SAAS,EAAE,CAAC,WAAW,CAAC;IACxB,aAAa,EAAE;QACX,WAAW;QACX,SAAS;QACT,cAAc;QACd,qBAAqB;QACrB,kBAAkB;QAClB,aAAa;QACb,cAAc;QACd,UAAU;QACV,kBAAkB;QAClB,YAAY;KACf;IACD,eAAe,EAAE,CAAC,SAAS,CAAC;IAC5B,SAAS,EAAE,CAAC,qBAAqB,CAAC;CACrC,CAAC;AAEF,MAAM,uBAAuB,GAAG,CAAC,SAA+C,EAA4B,EAAE;IAC1G,MAAM,QAAQ,GAA6B,EAAE,GAAG,0BAA0B,EAAE,CAAC;IAC7E,MAAM,eAAe,GAAG,MAAM,CAAC,OAAO,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC;IAExD,KAAK,MAAM,CAAC,QAAQ,EAAE,OAAO,CAAC,IAAI,eAAe,EAAE,CAAC;QAChD,QAAQ,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,EAAE,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IACnF,CAAC;IAED,OAAO,QAAQ,CAAC;AACpB,CAAC,CAAC;AAEF,OAAO,EAAE,0BAA0B,EAAE,uBAAuB,EAAE,CAAC","sourcesContent":["const DEFAULT_USER_EVENT_SIGNALS: Record<string, string[]> = {\n    AdwAlertDialog: [\"response\"],\n    AdwCarousel: [\"page-changed\"],\n    AdwDialog: [\"closed\"],\n    AdwNavigationView: [\"pushed\"],\n    AdwTabView: [\"close-page\", \"page-attached\", \"page-detached\", \"page-reordered\"],\n    GObject: [\"notify\"],\n    GtkAdjustment: [\"changed\", \"value-changed\"],\n    GtkCalendar: [\"day-selected\"],\n    GtkCheckButton: [\"toggled\"],\n    GtkEditable: [\"changed\", \"delete-text\", \"insert-text\"],\n    GtkEntryBuffer: [\"deleted-text\", \"inserted-text\"],\n    GtkFlowBox: [\"selected-children-changed\"],\n    GtkListBox: [\"row-selected\", \"selected-rows-changed\"],\n    GtkNotebook: [\"page-added\", \"page-removed\", \"page-reordered\", \"switch-page\"],\n    GtkPopover: [\"closed\"],\n    GtkRange: [\"value-changed\"],\n    GtkScaleButton: [\"value-changed\"],\n    GtkScrolledWindow: [\"edge-reached\"],\n    GtkSearchEntry: [\"search-changed\"],\n    GtkSelectionModel: [\"selection-changed\"],\n    GtkSpinButton: [\"value-changed\"],\n    GtkSwitch: [\"state-set\"],\n    GtkTextBuffer: [\n        \"apply-tag\",\n        \"changed\",\n        \"delete-range\",\n        \"insert-child-anchor\",\n        \"insert-paintable\",\n        \"insert-text\",\n        \"mark-deleted\",\n        \"mark-set\",\n        \"modified-changed\",\n        \"remove-tag\",\n    ],\n    GtkToggleButton: [\"toggled\"],\n    GtkWidget: [\"state-flags-changed\"],\n};\n\nconst resolveUserEventSignals = (overrides: Record<string, string[]> | undefined): Record<string, string[]> => {\n    const resolved: Record<string, string[]> = { ...DEFAULT_USER_EVENT_SIGNALS };\n    const overrideEntries = Object.entries(overrides ?? {});\n\n    for (const [typeName, signals] of overrideEntries) {\n        resolved[typeName] = [...new Set([...(resolved[typeName] ?? []), ...signals])];\n    }\n\n    return resolved;\n};\n\nexport { DEFAULT_USER_EVENT_SIGNALS, resolveUserEventSignals };\n"]}

package/dist/virtual.d.ts

@@ -1,10 +1,6 @@
-import type { ResolvedConfig } from "./config.js";
+import type { ResolvedConfig } from "./config.ts";
 declare const GTKX_CONFIG_VIRTUAL_ID = "virtual:gtkx-config";
 declare const RESOLVED_GTKX_CONFIG_VIRTUAL_ID = "\0virtual:gtkx-config";
-/**
- * The runtime element config is the app's static per-element config (currently its lazy flags) merged
- * with its behaviors module, so a single `elements` map is registered.
- */
 declare const renderConfigModule: (config: ResolvedConfig) => string;
 export { GTKX_CONFIG_VIRTUAL_ID, RESOLVED_GTKX_CONFIG_VIRTUAL_ID, renderConfigModule };
 //# sourceMappingURL=virtual.d.ts.map

package/dist/virtual.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"virtual.d.ts","sourceRoot":"","sources":["../src/virtual.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAElD,QAAA,MAAM,sBAAsB,wBAAwB,CAAC;AACrD,QAAA,MAAM,+BAA+B,0BAAgC,CAAC;AAMtE;;;GAGG;AACH,QAAA,MAAM,kBAAkB,GAAI,QAAQ,cAAc,KAAG,MAoBpD,CAAC;AAEF,OAAO,EAAE,sBAAsB,EAAE,+BAA+B,EAAE,kBAAkB,EAAE,CAAC"}
+{"version":3,"file":"virtual.d.ts","sourceRoot":"","sources":["../src/virtual.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAElD,QAAA,MAAM,sBAAsB,wBAAwB,CAAC;AACrD,QAAA,MAAM,+BAA+B,0BAAgC,CAAC;AAMtE,QAAA,MAAM,kBAAkB,GAAI,QAAQ,cAAc,KAAG,MAoBpD,CAAC;AAEF,OAAO,EAAE,sBAAsB,EAAE,+BAA+B,EAAE,kBAAkB,EAAE,CAAC"}

package/dist/virtual.js

@@ -1,11 +1,7 @@
 const GTKX_CONFIG_VIRTUAL_ID = "virtual:gtkx-config";
 const RESOLVED_GTKX_CONFIG_VIRTUAL_ID = `\0${GTKX_CONFIG_VIRTUAL_ID}`;
 const METADATA_SPECIFIER = "@gtkx/jsx/metadata";
-const lazyElementConfig = (lazyElements) => Object.fromEntries(lazyElements.map((type) => [type, { lazy: true }]));
-/**
- * The runtime element config is the app's static per-element config (currently its lazy flags) merged
- * with its behaviors module, so a single `elements` map is registered.
- */
+const lazyElementConfig = (lazyElements) => Object.fromEntries(lazyElements.map((type) => [type, { isLazy: true }]));
 const renderConfigModule = (config) => {
     const lazyJson = JSON.stringify(lazyElementConfig(config.lazyElements));
     const behaviorImports = config.elements === null

package/dist/virtual.js.map

@@ -1 +1 @@
-{"version":3,"file":"virtual.js","sourceRoot":"","sources":["../src/virtual.ts"],"names":[],"mappings":"AAEA,MAAM,sBAAsB,GAAG,qBAAqB,CAAC;AACrD,MAAM,+BAA+B,GAAG,KAAK,sBAAsB,EAAE,CAAC;AACtE,MAAM,kBAAkB,GAAG,oBAAoB,CAAC;AAEhD,MAAM,iBAAiB,GAAG,CAAC,YAAsB,EAAkC,EAAE,CACjF,MAAM,CAAC,WAAW,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;AAE3E;;;GAGG;AACH,MAAM,kBAAkB,GAAG,CAAC,MAAsB,EAAU,EAAE;IAC1D,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC,iBAAiB,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC,CAAC;IAExE,MAAM,eAAe,GACjB,MAAM,CAAC,QAAQ,KAAK,IAAI;QACpB,CAAC,CAAC,EAAE;QACJ,CAAC,CAAC;YACM,6DAA6D;YAC7D,kCAAkC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,GAAG;SACvE,CAAC;IAEd,OAAO;QACH,GAAG,eAAe;QAClB,iBAAiB,IAAI,CAAC,SAAS,CAAC,kBAAkB,CAAC,GAAG;QACtD,gCAAgC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,aAAa,CAAC,GAAG;QACvE,mCAAmC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,gBAAgB,CAAC,GAAG;QAC7E,MAAM,CAAC,QAAQ,KAAK,IAAI;YACpB,CAAC,CAAC,2BAA2B,QAAQ,GAAG;YACxC,CAAC,CAAC,mEAAmE,QAAQ,IAAI;KACxF,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACjB,CAAC,CAAC;AAEF,OAAO,EAAE,sBAAsB,EAAE,+BAA+B,EAAE,kBAAkB,EAAE,CAAC","sourcesContent":["import type { ResolvedConfig } from \"./config.js\";\n\nconst GTKX_CONFIG_VIRTUAL_ID = \"virtual:gtkx-config\";\nconst RESOLVED_GTKX_CONFIG_VIRTUAL_ID = `\\0${GTKX_CONFIG_VIRTUAL_ID}`;\nconst METADATA_SPECIFIER = \"@gtkx/jsx/metadata\";\n\nconst lazyElementConfig = (lazyElements: string[]): Record<string, { lazy: true }> =>\n    Object.fromEntries(lazyElements.map((type) => [type, { lazy: true }]));\n\n/**\n * The runtime element config is the app's static per-element config (currently its lazy flags) merged\n * with its behaviors module, so a single `elements` map is registered.\n */\nconst renderConfigModule = (config: ResolvedConfig): string => {\n    const lazyJson = JSON.stringify(lazyElementConfig(config.lazyElements));\n\n    const behaviorImports =\n        config.elements === null\n            ? []\n            : [\n                    \"import { mergeElementConfigs } from \\\"@gtkx/react/config\\\";\",\n                    `import __elementBehaviors from ${JSON.stringify(config.elements)};`,\n                ];\n\n    return [\n        ...behaviorImports,\n        `export * from ${JSON.stringify(METADATA_SPECIFIER)};`,\n        `export const applicationId = ${JSON.stringify(config.applicationId)};`,\n        `export const userEventSignals = ${JSON.stringify(config.userEventSignals)};`,\n        config.elements === null\n            ? `export const elements = ${lazyJson};`\n            : `export const elements = mergeElementConfigs(__elementBehaviors, ${lazyJson});`,\n    ].join(\"\\n\");\n};\n\nexport { GTKX_CONFIG_VIRTUAL_ID, RESOLVED_GTKX_CONFIG_VIRTUAL_ID, renderConfigModule };\n"]}
+{"version":3,"file":"virtual.js","sourceRoot":"","sources":["../src/virtual.ts"],"names":[],"mappings":"AAEA,MAAM,sBAAsB,GAAG,qBAAqB,CAAC;AACrD,MAAM,+BAA+B,GAAG,KAAK,sBAAsB,EAAE,CAAC;AACtE,MAAM,kBAAkB,GAAG,oBAAoB,CAAC;AAEhD,MAAM,iBAAiB,GAAG,CAAC,YAAsB,EAAuC,EAAE,CACtF,MAAM,CAAC,WAAW,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;AAE7E,MAAM,kBAAkB,GAAG,CAAC,MAAsB,EAAU,EAAE;IAC1D,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC,iBAAiB,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC,CAAC;IAExE,MAAM,eAAe,GACjB,MAAM,CAAC,QAAQ,KAAK,IAAI;QACpB,CAAC,CAAC,EAAE;QACJ,CAAC,CAAC;YACM,6DAA6D;YAC7D,kCAAkC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,GAAG;SACvE,CAAC;IAEd,OAAO;QACH,GAAG,eAAe;QAClB,iBAAiB,IAAI,CAAC,SAAS,CAAC,kBAAkB,CAAC,GAAG;QACtD,gCAAgC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,aAAa,CAAC,GAAG;QACvE,mCAAmC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,gBAAgB,CAAC,GAAG;QAC7E,MAAM,CAAC,QAAQ,KAAK,IAAI;YACpB,CAAC,CAAC,2BAA2B,QAAQ,GAAG;YACxC,CAAC,CAAC,mEAAmE,QAAQ,IAAI;KACxF,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACjB,CAAC,CAAC;AAEF,OAAO,EAAE,sBAAsB,EAAE,+BAA+B,EAAE,kBAAkB,EAAE,CAAC","sourcesContent":["import type { ResolvedConfig } from \"./config.ts\";\n\nconst GTKX_CONFIG_VIRTUAL_ID = \"virtual:gtkx-config\";\nconst RESOLVED_GTKX_CONFIG_VIRTUAL_ID = `\\0${GTKX_CONFIG_VIRTUAL_ID}`;\nconst METADATA_SPECIFIER = \"@gtkx/jsx/metadata\";\n\nconst lazyElementConfig = (lazyElements: string[]): Record<string, { isLazy: boolean }> =>\n    Object.fromEntries(lazyElements.map((type) => [type, { isLazy: true }]));\n\nconst renderConfigModule = (config: ResolvedConfig): string => {\n    const lazyJson = JSON.stringify(lazyElementConfig(config.lazyElements));\n\n    const behaviorImports =\n        config.elements === null\n            ? []\n            : [\n                    \"import { mergeElementConfigs } from \\\"@gtkx/react/config\\\";\",\n                    `import __elementBehaviors from ${JSON.stringify(config.elements)};`,\n                ];\n\n    return [\n        ...behaviorImports,\n        `export * from ${JSON.stringify(METADATA_SPECIFIER)};`,\n        `export const applicationId = ${JSON.stringify(config.applicationId)};`,\n        `export const userEventSignals = ${JSON.stringify(config.userEventSignals)};`,\n        config.elements === null\n            ? `export const elements = ${lazyJson};`\n            : `export const elements = mergeElementConfigs(__elementBehaviors, ${lazyJson});`,\n    ].join(\"\\n\");\n};\n\nexport { GTKX_CONFIG_VIRTUAL_ID, RESOLVED_GTKX_CONFIG_VIRTUAL_ID, renderConfigModule };\n"]}

package/dist/vite-plugin.d.ts

@@ -1,15 +1,15 @@
 import type { Plugin, UserConfig } from "vite";
-import { type ConfigLoader } from "./loader.js";
+import { type ConfigLoader } from "./loader.ts";
 /**
- * Creates the Vite plugin that resolves and serves the `virtual:gtkx-config`
- * module, exposing the JSX metadata and the resolved application ID from the
- * project's configuration.
- * @param options Plugin name, an optional custom {@link ConfigLoader}, and an
- * optional hook returning extra Vite user config.
+ * Creates a Vite plugin serving `virtual:gtkx-config`, the module carrying the project's resolved
+ * `gtkx.config.ts`.
  */
 declare const createConfigPlugin: (options: {
+    /** Name the plugin is registered under in Vite. */
     name: string;
+    /** Loader the configuration is resolved through, defaulting to a fresh caching loader. */
     loadConfig?: ConfigLoader;
+    /** Extra Vite configuration contributed from the plugin's `config` hook. */
     config?: () => Omit<UserConfig, "plugins">;
 }) => Plugin;
 export default createConfigPlugin;

package/dist/vite-plugin.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"vite-plugin.d.ts","sourceRoot":"","sources":["../src/vite-plugin.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,MAAM,CAAC;AAC/C,OAAO,EAAE,KAAK,YAAY,EAAsB,MAAM,aAAa,CAAC;AAsBpE;;;;;;GAMG;AACH,QAAA,MAAM,kBAAkB,GAAI,SAAS;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,YAAY,CAAC;IAC1B,MAAM,CAAC,EAAE,MAAM,IAAI,CAAC,UAAU,EAAE,SAAS,CAAC,CAAC;CAC9C,KAAG,MAcH,CAAC;AAEF,eAAe,kBAAkB,CAAC"}
+{"version":3,"file":"vite-plugin.d.ts","sourceRoot":"","sources":["../src/vite-plugin.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,MAAM,CAAC;AAC/C,OAAO,EAAE,KAAK,YAAY,EAAsB,MAAM,aAAa,CAAC;AAwBpE;;;GAGG;AACH,QAAA,MAAM,kBAAkB,GAAI,SAAS;IACjC,mDAAmD;IACnD,IAAI,EAAE,MAAM,CAAC;IACb,0FAA0F;IAC1F,UAAU,CAAC,EAAE,YAAY,CAAC;IAC1B,4EAA4E;IAC5E,MAAM,CAAC,EAAE,MAAM,IAAI,CAAC,UAAU,EAAE,SAAS,CAAC,CAAC;CAC9C,KAAG,MAcH,CAAC;AAEF,eAAe,kBAAkB,CAAC"}

package/dist/vite-plugin.js

@@ -8,11 +8,8 @@ const loadVirtualModule = async (id, loadConfig, state) => {
     return renderConfigModule(await loadConfig.resolve(state.root ?? process.cwd()));
 };
 /**
- * Creates the Vite plugin that resolves and serves the `virtual:gtkx-config`
- * module, exposing the JSX metadata and the resolved application ID from the
- * project's configuration.
- * @param options Plugin name, an optional custom {@link ConfigLoader}, and an
- * optional hook returning extra Vite user config.
+ * Creates a Vite plugin serving `virtual:gtkx-config`, the module carrying the project's resolved
+ * `gtkx.config.ts`.
  */
 const createConfigPlugin = (options) => {
     const loadConfig = options.loadConfig ?? createConfigLoader();

package/dist/vite-plugin.js.map

@@ -1 +1 @@
-{"version":3,"file":"vite-plugin.js","sourceRoot":"","sources":["../src/vite-plugin.ts"],"names":[],"mappings":"AACA,OAAO,EAAqB,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACpE,OAAO,EAAE,sBAAsB,EAAE,kBAAkB,EAAE,+BAA+B,EAAE,MAAM,cAAc,CAAC;AAM3G,MAAM,gBAAgB,GAAG,CAAC,EAAU,EAAiB,EAAE,CACnD,EAAE,KAAK,sBAAsB,CAAC,CAAC,CAAC,+BAA+B,CAAC,CAAC,CAAC,IAAI,CAAC;AAE3E,MAAM,iBAAiB,GAAG,KAAK,EAC3B,EAAU,EACV,UAAwB,EACxB,KAAkB,EACS,EAAE;IAC7B,IAAI,EAAE,KAAK,+BAA+B,EAAE,CAAC;QACzC,OAAO,SAAS,CAAC;IACrB,CAAC;IAED,OAAO,kBAAkB,CAAC,MAAM,UAAU,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;AACrF,CAAC,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,kBAAkB,GAAG,CAAC,OAI3B,EAAU,EAAE;IACT,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,IAAI,kBAAkB,EAAE,CAAC;IAC9D,MAAM,KAAK,GAAgB,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;IAE/C,OAAO;QACH,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,MAAM,CAAC,MAAkB;YACrB,KAAK,CAAC,IAAI,GAAG,MAAM,CAAC,IAAI,IAAI,KAAK,CAAC,IAAI,CAAC;YAEvC,OAAO,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC;QAC9B,CAAC;QACD,SAAS,EAAE,CAAC,EAAU,EAAE,EAAE,CAAC,gBAAgB,CAAC,EAAE,CAAC;QAC/C,IAAI,EAAE,CAAC,EAAU,EAAE,EAAE,CAAC,iBAAiB,CAAC,EAAE,EAAE,UAAU,EAAE,KAAK,CAAC;KACjE,CAAC;AACN,CAAC,CAAC;AAEF,eAAe,kBAAkB,CAAC","sourcesContent":["import type { Plugin, UserConfig } from \"vite\";\nimport { type ConfigLoader, createConfigLoader } from \"./loader.js\";\nimport { GTKX_CONFIG_VIRTUAL_ID, renderConfigModule, RESOLVED_GTKX_CONFIG_VIRTUAL_ID } from \"./virtual.js\";\n\ntype PluginState = {\n    root: string | undefined;\n};\n\nconst resolveVirtualId = (id: string): string | null =>\n    id === GTKX_CONFIG_VIRTUAL_ID ? RESOLVED_GTKX_CONFIG_VIRTUAL_ID : null;\n\nconst loadVirtualModule = async (\n    id: string,\n    loadConfig: ConfigLoader,\n    state: PluginState,\n): Promise<string | undefined> => {\n    if (id !== RESOLVED_GTKX_CONFIG_VIRTUAL_ID) {\n        return undefined;\n    }\n\n    return renderConfigModule(await loadConfig.resolve(state.root ?? process.cwd()));\n};\n\n/**\n * Creates the Vite plugin that resolves and serves the `virtual:gtkx-config`\n * module, exposing the JSX metadata and the resolved application ID from the\n * project's configuration.\n * @param options Plugin name, an optional custom {@link ConfigLoader}, and an\n * optional hook returning extra Vite user config.\n */\nconst createConfigPlugin = (options: {\n    name: string;\n    loadConfig?: ConfigLoader;\n    config?: () => Omit<UserConfig, \"plugins\">;\n}): Plugin => {\n    const loadConfig = options.loadConfig ?? createConfigLoader();\n    const state: PluginState = { root: undefined };\n\n    return {\n        name: options.name,\n        config(config: UserConfig) {\n            state.root = config.root ?? state.root;\n\n            return options.config?.();\n        },\n        resolveId: (id: string) => resolveVirtualId(id),\n        load: (id: string) => loadVirtualModule(id, loadConfig, state),\n    };\n};\n\nexport default createConfigPlugin;\n"]}
+{"version":3,"file":"vite-plugin.js","sourceRoot":"","sources":["../src/vite-plugin.ts"],"names":[],"mappings":"AACA,OAAO,EAAqB,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACpE,OAAO,EAAE,sBAAsB,EAAE,kBAAkB,EAAE,+BAA+B,EAAE,MAAM,cAAc,CAAC;AAQ3G,MAAM,gBAAgB,GAAG,CAAC,EAAU,EAAiB,EAAE,CACnD,EAAE,KAAK,sBAAsB,CAAC,CAAC,CAAC,+BAA+B,CAAC,CAAC,CAAC,IAAI,CAAC;AAE3E,MAAM,iBAAiB,GAAG,KAAK,EAC3B,EAAU,EACV,UAAwB,EACxB,KAAkB,EACS,EAAE;IAC7B,IAAI,EAAE,KAAK,+BAA+B,EAAE,CAAC;QACzC,OAAO,SAAS,CAAC;IACrB,CAAC;IAED,OAAO,kBAAkB,CAAC,MAAM,UAAU,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;AACrF,CAAC,CAAC;AAEF;;;GAGG;AACH,MAAM,kBAAkB,GAAG,CAAC,OAO3B,EAAU,EAAE;IACT,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,IAAI,kBAAkB,EAAE,CAAC;IAC9D,MAAM,KAAK,GAAgB,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;IAE/C,OAAO;QACH,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,MAAM,CAAC,MAAkB;YACrB,KAAK,CAAC,IAAI,GAAG,MAAM,CAAC,IAAI,IAAI,KAAK,CAAC,IAAI,CAAC;YAEvC,OAAO,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC;QAC9B,CAAC;QACD,SAAS,EAAE,CAAC,EAAU,EAAE,EAAE,CAAC,gBAAgB,CAAC,EAAE,CAAC;QAC/C,IAAI,EAAE,CAAC,EAAU,EAAE,EAAE,CAAC,iBAAiB,CAAC,EAAE,EAAE,UAAU,EAAE,KAAK,CAAC;KACjE,CAAC;AACN,CAAC,CAAC;AAEF,eAAe,kBAAkB,CAAC","sourcesContent":["import type { Plugin, UserConfig } from \"vite\";\nimport { type ConfigLoader, createConfigLoader } from \"./loader.ts\";\nimport { GTKX_CONFIG_VIRTUAL_ID, renderConfigModule, RESOLVED_GTKX_CONFIG_VIRTUAL_ID } from \"./virtual.ts\";\n\n/** State the plugin carries from Vite's `config` hook to the virtual module it serves. */\ntype PluginState = {\n    /** Project root taken from Vite's `config` hook, undefined when the user config leaves it unset. */\n    root: string | undefined;\n};\n\nconst resolveVirtualId = (id: string): string | null =>\n    id === GTKX_CONFIG_VIRTUAL_ID ? RESOLVED_GTKX_CONFIG_VIRTUAL_ID : null;\n\nconst loadVirtualModule = async (\n    id: string,\n    loadConfig: ConfigLoader,\n    state: PluginState,\n): Promise<string | undefined> => {\n    if (id !== RESOLVED_GTKX_CONFIG_VIRTUAL_ID) {\n        return undefined;\n    }\n\n    return renderConfigModule(await loadConfig.resolve(state.root ?? process.cwd()));\n};\n\n/**\n * Creates a Vite plugin serving `virtual:gtkx-config`, the module carrying the project's resolved\n * `gtkx.config.ts`.\n */\nconst createConfigPlugin = (options: {\n    /** Name the plugin is registered under in Vite. */\n    name: string;\n    /** Loader the configuration is resolved through, defaulting to a fresh caching loader. */\n    loadConfig?: ConfigLoader;\n    /** Extra Vite configuration contributed from the plugin's `config` hook. */\n    config?: () => Omit<UserConfig, \"plugins\">;\n}): Plugin => {\n    const loadConfig = options.loadConfig ?? createConfigLoader();\n    const state: PluginState = { root: undefined };\n\n    return {\n        name: options.name,\n        config(config: UserConfig) {\n            state.root = config.root ?? state.root;\n\n            return options.config?.();\n        },\n        resolveId: (id: string) => resolveVirtualId(id),\n        load: (id: string) => loadVirtualModule(id, loadConfig, state),\n    };\n};\n\nexport default createConfigPlugin;\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gtkx/config",
-  "version": "1.0.0-rc.3",
+  "version": "1.0.0",
   "description": "gtkx.config.ts schema, loader, and the element-prop mapping language shared across the GTKX toolchain",
   "keywords": [
     "gtkx",
@@ -50,9 +50,9 @@
   "dependencies": {
     "c12": "^3.3.4",
     "defu": "^6.1.7",
-    "vite": "^8.1.5",
+    "vite": "^8.2.1",
     "zod": "^4.4.3",
-    "@gtkx/utils": "1.0.0-rc.3"
+    "@gtkx/utils": "1.0.0"
   },
   "scripts": {
     "release": "tsx ../../scripts/release-package.ts"

package/src/config.ts

@@ -2,49 +2,51 @@ import { createDefineConfig, type DefineConfig } from "c12";
 import { defu } from "defu";
 import { resolve } from "node:path";
 import { z } from "zod";
-import { configError, isRecord, rawIssue } from "./config-error.js";
-import { resolveUserEventSignals } from "./user-event-signals.js";
+import { configError, isRecord, rawIssue } from "./config-error.ts";
+import { resolveUserEventSignals } from "./user-event-signals.ts";
 
+/** Accepted `reactCompiler.compilationMode` values, choosing which functions the compiler processes. */
 type ReactCompilerCompilationMode = (typeof COMPILATION_MODES)[number];
+/** Accepted `reactCompiler.panicThreshold` values, choosing which compiler diagnostics fail the build. */
 type ReactCompilerPanicThreshold = (typeof PANIC_THRESHOLDS)[number];
 
+/** Object form of the `reactCompiler` config key, forwarded as-is to `babel-plugin-react-compiler`. */
 type ReactCompilerOptions = {
+    /** Which functions the compiler processes; left to the compiler's own default when omitted. */
     compilationMode?: ReactCompilerCompilationMode;
+    /** Which compiler diagnostics fail the build; left to the compiler's own default when omitted. */
     panicThreshold?: ReactCompilerPanicThreshold;
 };
 
 /**
- * React Compiler options resolved for the build, with the compilation target
- * fixed to React 19.
+ * The React Compiler options the build hands to `babel-plugin-react-compiler`, with the React version
+ * GTKX targets filled in.
  */
 type ResolvedReactCompilerOptions = ReactCompilerOptions & {
+    /** React major version the compiler emits for. */
     target: "19";
 };
 
 /**
- * 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,
- * a module of per-element configuration (lazy flags and custom behaviors),
- * per-element component wrappers and omitted props keyed by GLib type name, the
- * React Compiler and codegen settings, additional user event signals to suppress
- * during React commits, and extra GIR records to treat as class structs.
+ * 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, and the React
+ * Compiler, codegen, and user event signal settings.
  */
 type Config = z.infer<typeof configSchema>;
-/** A `{ module, export }` reference to a named export, as element config entries carry it. */
 type ModuleExport = z.infer<typeof moduleExportSchema>;
 type ElementConfigEntry = z.infer<typeof elementConfigSchema>;
 
-/**
- * Configuration reduced to the values needed at runtime: the GApplication
- * identifier, the resolved React Compiler options (`null` when disabled), the
- * user event signals suppressed while a React commit is in progress, and the
- * module path holding per-element configuration (`null` when unset).
- */
+/** Configuration reduced to the values the app runtime and the build need, with paths already resolved. */
 type ResolvedConfig = {
+    /** The GApplication identifier the app registers under. */
     applicationId: string;
+    /** React Compiler options for the build, or `null` when the compiler is disabled. */
     reactCompiler: ResolvedReactCompilerOptions | null;
+    /** Signal names, keyed by GLib type name, that stay suppressed while a React commit runs. */
     userEventSignals: Record<string, string[]>;
+    /** Path of the module exporting per-element configs, or `null` when none is configured. */
     elements: string | null;
+    /** GLib type names of the elements marked `isLazy`, whose GObject their parent container creates. */
     lazyElements: string[];
 };
 
@@ -52,7 +54,9 @@ const LIBRARIES_WILDCARD = "*";
 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;
+/** Compilation modes `babel-plugin-react-compiler` accepts. */
 const COMPILATION_MODES = ["infer", "syntax", "annotation", "all"] as const;
+/** Panic thresholds `babel-plugin-react-compiler` accepts. */
 const PANIC_THRESHOLDS = ["none", "critical_errors", "all_errors"] as const;
 const REACT_COMPILER_TARGET = "19";
 const COMPILATION_MODE_SET: Set<string> = new Set(COMPILATION_MODES);
@@ -156,8 +160,8 @@ const moduleExportSchema = z.object(
 const elementConfigSchema = z.object({
     component: moduleExportSchema.optional(),
     props: moduleExportSchema.optional(),
-    lazy: z.boolean({ error: "must be a boolean" }).optional(),
-    omitProps: z
+    isLazy: z.boolean({ error: "must be a boolean" }).optional(),
+    omittedProps: z
         .array(
             z.string({ error: "must be a non-empty property name" }).min(1, {
                 error: "must be a non-empty property name",
@@ -175,6 +179,7 @@ const elementsSchema = z.object({
     config: z.record(z.string(), elementConfigSchema).optional(),
 });
 
+/** Schema every `gtkx.config.ts` is validated against, and the source of the {@link Config} type. */
 const configSchema = z.object({
     libraries: librariesSchema.optional(),
     girPath: z.array(z.string(), { error: "must be an array of strings if provided" }).optional(),
@@ -186,8 +191,8 @@ const configSchema = z.object({
 });
 
 /**
- * Identity helper that returns the given configuration typed as {@link Config},
- * enabling editor autocompletion and type checking in `gtkx.config.ts`.
+ * Returns the given configuration unchanged, typed as {@link Config}, so `gtkx.config.ts` gets
+ * autocompletion and type checking.
  */
 const defineConfig: DefineConfig<Config> = createDefineConfig<Config>();
 
@@ -241,9 +246,8 @@ const validateConfig = (config: Config): void => {
 };
 
 /**
- * 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.
+ * Deep-merges two configurations. `override` wins over `base` on conflicting scalar and object keys, while
+ * arrays are concatenated with the `override` entries first.
  */
 const mergeConfig = (base: Config, override: Config): Config => defu(override, base);
 
@@ -257,7 +261,7 @@ const resolveElementsModule = (behaviors: string | undefined, root: string | und
 
 const resolveLazyElements = (elements: Config["elements"]): string[] =>
     Object.entries(elements?.config ?? {})
-        .filter(([, entry]) => entry.lazy === true)
+        .filter(([, entry]) => entry.isLazy === true)
         .map(([type]) => type);
 
 const elementEntryValues = <T>(
@@ -278,8 +282,8 @@ const resolveElementComponents = (elements: Config["elements"]): Record<string,
 const resolveElementProps = (elements: Config["elements"]): Record<string, ModuleExport> =>
     elementEntryValues(elements, (entry) => entry.props);
 
-const resolveOmitProps = (elements: Config["elements"]): Record<string, string[]> =>
-    elementEntryValues(elements, (entry) => entry.omitProps);
+const resolveOmittedProps = (elements: Config["elements"]): Record<string, string[]> =>
+    elementEntryValues(elements, (entry) => entry.omittedProps);
 
 const resolveConfig = (config: Config, root?: string): ResolvedConfig => ({
     applicationId: config.applicationId,
@@ -298,10 +302,9 @@ export {
     resolveLazyElements,
     resolveElementComponents,
     resolveElementProps,
-    resolveOmitProps,
+    resolveOmittedProps,
     resolveConfig,
     type ResolvedReactCompilerOptions,
     type Config,
-    type ModuleExport,
     type ResolvedConfig,
 };

package/src/index.ts

@@ -1,8 +1,4 @@
-export {
-    type Config,
-    defineConfig,
-    mergeConfig,
-    type ResolvedConfig,
-    type ResolvedReactCompilerOptions,
-} from "./config.js";
-export { type LoadedConfig, loadConfig } from "./loader.js";
+/** @public */
+export { type Config, defineConfig, mergeConfig, type ResolvedConfig } from "./config.ts";
+/** @public */
+export { type ConfigLoader, type LoadedConfig, loadConfig } from "./loader.ts";

package/src/internal.ts

@@ -1,8 +1,9 @@
+export type { ResolvedReactCompilerOptions } from "./config.ts";
 export {
     isValidApplicationId,
     resolveElementComponents,
     resolveElementProps,
     resolveLazyElements,
-    resolveOmitProps,
-} from "./config.js";
-export { type ConfigLoader, createConfigLoader } from "./loader.js";
+    resolveOmittedProps,
+} from "./config.ts";
+export { createConfigLoader } from "./loader.ts";

package/src/loader.ts

@@ -2,36 +2,40 @@ import { getOrInsert } from "@gtkx/utils";
 import { loadConfig as loadConfigFile } from "c12";
 import { existsSync } from "node:fs";
 import { resolve } from "node:path";
-import { type Config, resolveConfig, type ResolvedConfig, validateConfig } from "./config.js";
+import { type Config, resolveConfig, type ResolvedConfig, validateConfig } from "./config.ts";
 
-/**
- * Result of loading a `gtkx.config.ts` file: the parsed configuration, the
- * resolved config file path, and the project root it was loaded from.
- */
+/** Result of loading a project's `gtkx.config.ts` file. */
 type LoadedConfig = {
+    /** The parsed and validated configuration. */
     config: Config;
+    /** Absolute path of the configuration file that was loaded. */
     configFile: string;
+    /** Absolute path of the project root the configuration was resolved against. */
     root: string;
 };
 
+/** How a configuration file is read, shared by {@link loadConfig} and `createConfigLoader`. */
 type LoadConfigOptions = {
+    /**
+     * Environment name such as `development`: the config's matching `$<mode>` block is layered over the
+     * top-level values, and the name is passed to a config authored as a function.
+     */
     mode?: string | undefined;
 };
 
-/**
- * Caching accessor for a project's configuration: `load` yields the validated authored config together with
- * its file path, and `resolve` yields the projection an app needs at runtime.
- */
+/** Reads a project's configuration once per directory, caching what it loads and what it resolves. */
 type ConfigLoader = {
+    /** Loads the configuration file the given directory resolves to, as {@link loadConfig} does. */
     load: (cwd: string) => Promise<LoadedConfig>;
+    /** Loads the configuration for the given directory and reduces it to what the build and the app need. */
     resolve: (cwd: string) => Promise<ResolvedConfig>;
 };
 
 /**
- * Loads and validates the `gtkx.config.ts` file for a project, returning the
- * parsed configuration together with the config file path and project root.
- * @param cwd Directory from which to search for the configuration file.
- * @param options Loading options, such as the environment mode.
+ * Loads and validates the `gtkx.config.ts` file for a project.
+ * @param cwd Directory the configuration file is looked up in.
+ * @param options Loading options, such as the environment mode whose overrides are applied.
+ * @throws When the configuration fails validation, or when no configuration file is found.
  */
 const loadConfig = async (cwd: string, options: LoadConfigOptions = {}): Promise<LoadedConfig> => {
     const result = await loadConfigFile<Config>({
@@ -78,4 +82,4 @@ const createConfigLoader = (options: LoadConfigOptions = {}): ConfigLoader => {
     };
 };
 
-export { loadConfig, createConfigLoader, type LoadedConfig, type LoadConfigOptions, type ConfigLoader };
+export { loadConfig, createConfigLoader, type LoadedConfig, type ConfigLoader };

package/src/user-event-signals.ts

@@ -6,15 +6,11 @@ const DEFAULT_USER_EVENT_SIGNALS: Record<string, string[]> = {
     AdwTabView: ["close-page", "page-attached", "page-detached", "page-reordered"],
     GObject: ["notify"],
     GtkAdjustment: ["changed", "value-changed"],
-    GtkAppChooserButton: ["changed"],
-    GtkAppChooserWidget: ["application-selected"],
     GtkCalendar: ["day-selected"],
     GtkCheckButton: ["toggled"],
-    GtkComboBox: ["changed"],
     GtkEditable: ["changed", "delete-text", "insert-text"],
     GtkEntryBuffer: ["deleted-text", "inserted-text"],
     GtkFlowBox: ["selected-children-changed"],
-    GtkIconView: ["selection-changed"],
     GtkListBox: ["row-selected", "selected-rows-changed"],
     GtkNotebook: ["page-added", "page-removed", "page-reordered", "switch-page"],
     GtkPopover: ["closed"],
@@ -38,8 +34,6 @@ const DEFAULT_USER_EVENT_SIGNALS: Record<string, string[]> = {
         "remove-tag",
     ],
     GtkToggleButton: ["toggled"],
-    GtkTreeSelection: ["changed"],
-    GtkTreeView: ["columns-changed", "cursor-changed", "row-collapsed", "row-expanded"],
     GtkWidget: ["state-flags-changed"],
 };
 

package/src/virtual.ts

@@ -1,16 +1,12 @@
-import type { ResolvedConfig } from "./config.js";
+import type { ResolvedConfig } from "./config.ts";
 
 const GTKX_CONFIG_VIRTUAL_ID = "virtual:gtkx-config";
 const RESOLVED_GTKX_CONFIG_VIRTUAL_ID = `\0${GTKX_CONFIG_VIRTUAL_ID}`;
 const METADATA_SPECIFIER = "@gtkx/jsx/metadata";
 
-const lazyElementConfig = (lazyElements: string[]): Record<string, { lazy: true }> =>
-    Object.fromEntries(lazyElements.map((type) => [type, { lazy: true }]));
+const lazyElementConfig = (lazyElements: string[]): Record<string, { isLazy: boolean }> =>
+    Object.fromEntries(lazyElements.map((type) => [type, { isLazy: true }]));
 
-/**
- * The runtime element config is the app's static per-element config (currently its lazy flags) merged
- * with its behaviors module, so a single `elements` map is registered.
- */
 const renderConfigModule = (config: ResolvedConfig): string => {
     const lazyJson = JSON.stringify(lazyElementConfig(config.lazyElements));
 

package/src/vite-plugin.ts

@@ -1,8 +1,10 @@
 import type { Plugin, UserConfig } from "vite";
-import { type ConfigLoader, createConfigLoader } from "./loader.js";
-import { GTKX_CONFIG_VIRTUAL_ID, renderConfigModule, RESOLVED_GTKX_CONFIG_VIRTUAL_ID } from "./virtual.js";
+import { type ConfigLoader, createConfigLoader } from "./loader.ts";
+import { GTKX_CONFIG_VIRTUAL_ID, renderConfigModule, RESOLVED_GTKX_CONFIG_VIRTUAL_ID } from "./virtual.ts";
 
+/** State the plugin carries from Vite's `config` hook to the virtual module it serves. */
 type PluginState = {
+    /** Project root taken from Vite's `config` hook, undefined when the user config leaves it unset. */
     root: string | undefined;
 };
 
@@ -22,15 +24,15 @@ const loadVirtualModule = async (
 };
 
 /**
- * Creates the Vite plugin that resolves and serves the `virtual:gtkx-config`
- * module, exposing the JSX metadata and the resolved application ID from the
- * project's configuration.
- * @param options Plugin name, an optional custom {@link ConfigLoader}, and an
- * optional hook returning extra Vite user config.
+ * Creates a Vite plugin serving `virtual:gtkx-config`, the module carrying the project's resolved
+ * `gtkx.config.ts`.
  */
 const createConfigPlugin = (options: {
+    /** Name the plugin is registered under in Vite. */
     name: string;
+    /** Loader the configuration is resolved through, defaulting to a fresh caching loader. */
     loadConfig?: ConfigLoader;
+    /** Extra Vite configuration contributed from the plugin's `config` hook. */
     config?: () => Omit<UserConfig, "plugins">;
 }): Plugin => {
     const loadConfig = options.loadConfig ?? createConfigLoader();