@gtkx/config 1.0.0-rc.3 → 1.0.0-rc.4

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 the comparison in full.
 
 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.
 

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. */
+/** A named export referenced as plain data, so codegen can emit an import for it without loading the module. */
 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[];
 };
 declare const COMPILATION_MODES: readonly ["infer", "syntax", "annotation", "all"];
 declare const PANIC_THRESHOLDS: readonly ["none", "critical_errors", "all_errors"];
+/** Validates a `{ module, export }` reference to a named export. */
 declare const moduleExportSchema: z.ZodObject<{
     module: z.ZodString;
     export: z.ZodString;
 }, z.core.$strip>;
+/** The shape 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 ModuleExport, 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

@@ -13,6 +13,7 @@ const PANIC_THRESHOLDS = ["none", "critical_errors", "all_errors"];
 const REACT_COMPILER_TARGET = "19";
 const COMPILATION_MODE_SET = new Set(COMPILATION_MODES);
 const PANIC_THRESHOLD_SET = new Set(PANIC_THRESHOLDS);
+/** Validates `libraries`: the `"*"` wildcard on its own, or a non-empty array of `Name-Version` identifiers. */
 const librariesSchema = z.custom().check((ctx) => {
     const value = ctx.value;
     if (value === LIBRARIES_WILDCARD) {
@@ -26,6 +27,7 @@ const librariesSchema = z.custom().check((ctx) => {
         ctx.issues.push(...libraryEntryIssues(value, index, entry));
     }
 });
+/** Validates `applicationId` against the reverse-DNS form `g_application_id_is_valid` accepts. */
 const applicationIdSchema = z.custom().check((ctx) => {
     const value = ctx.value;
     if (typeof value !== "string" || !isValidApplicationId(value)) {
@@ -33,6 +35,7 @@ const applicationIdSchema = z.custom().check((ctx) => {
             '(e.g. "org.example.MyApp")', true));
     }
 });
+/** Validates `reactCompiler`: a boolean, or an options object whose mode and threshold are known values. */
 const reactCompilerSchema = z.custom().check((ctx) => {
     const value = ctx.value;
     if (typeof value === "boolean") {
@@ -53,42 +56,71 @@ const reactCompilerSchema = z.custom().check((ctx) => {
             `must be one of ${PANIC_THRESHOLDS.join(", ")}`, true));
     }
 });
+/** Validates `userEventSignals`: GLib type names mapped to arrays of non-empty signal names. */
 const userEventSignalsSchema = z.record(z.string(), z.array(z.string({ error: "must be a non-empty signal name" }).min(1, { error: "must be a non-empty signal name" }), {
     error: "must be an array of signal names",
 }), { error: "must be a record of GLib type names to signal name arrays" });
+/** Validates a `{ module, export }` reference to a named export. */
 const moduleExportSchema = z.object({
+    /** Specifier the export is imported from. */
     module: z.string({ error: "must be a module specifier" }).min(1, { error: "must be a module specifier" }),
+    /** Identifier the module exports it under. */
     export: z.string({ error: "must be an export name" }).min(1, { error: "must be an export name" }),
 }, { error: "must be a { module, export } object" });
+/** Validates one entry of `elements.config`. */
 const elementConfigSchema = z.object({
+    /** Component that wraps the generated element. */
     component: moduleExportSchema.optional(),
+    /** Base props interface the generated element props extend. */
     props: moduleExportSchema.optional(),
-    lazy: z.boolean({ error: "must be a boolean" }).optional(),
-    omitProps: z
+    /** Marks the element as having no GObject of its own, its parent container creating one instead. */
+    isLazy: z.boolean({ error: "must be a boolean" }).optional(),
+    /** GObject properties to leave out of the generated element props, such as those a behavior fills. */
+    omittedProps: z
         .array(z.string({ error: "must be a non-empty property name" }).min(1, {
         error: "must be a non-empty property name",
     }), { error: "must be an array of property names" })
         .optional(),
 });
+/** Validates `elements`: the behaviors module the app loads at runtime, plus the per-type entries. */
 const elementsSchema = z.object({
+    /**
+     * Path, resolved against the project root, of a module default-exporting element configs keyed by
+     * GLib type name, as `defineElements` returns.
+     */
     behaviors: z
         .string({ error: "must be a path to a module exporting element behaviors" })
         .min(1, { error: "must be a path to a module exporting element behaviors" })
         .optional(),
+    /** Per-element entries, keyed by GLib type name. */
     config: z.record(z.string(), elementConfigSchema).optional(),
 });
+/** The shape every `gtkx.config.ts` is validated against, and the source of the {@link Config} type. */
 const configSchema = z.object({
+    /**
+     * GIR namespaces to bind as `Name-Version`, or `"*"` for every one installed; omitting it gives
+     * `Gtk-4.0`, which is also prepended to any list that names no Gtk version of its own.
+     */
     libraries: librariesSchema.optional(),
+    /** Directories searched for `.gir` files ahead of `GTKX_GIR_PATH` and the system locations. */
     girPath: z.array(z.string(), { error: "must be an array of strings if provided" }).optional(),
+    /** Reverse-DNS GApplication identifier, and the default `applicationId` of the application element. */
     applicationId: applicationIdSchema,
+    /** React Compiler settings; the compiler runs unless this is `false`. */
     reactCompiler: reactCompilerSchema.optional(),
+    /** Whether to generate the binding stores; `false` makes the CLI resolve an already-installed one. */
     codegen: z.boolean({ error: "must be a boolean" }).optional(),
+    /**
+     * Signal names, keyed by GLib type name, that stay suppressed while a React commit applies props, so
+     * their handlers only ever report user interaction. Unioned with the built-in GTK4 and Adwaita table.
+     */
     userEventSignals: userEventSignalsSchema.optional(),
+    /** Per-element customization: where the behaviors module lives and how each type's element is shaped. */
     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 +157,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 +168,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 +176,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 +184,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>;\n/** A named export referenced as plain data, so codegen can emit an import for it without loading the module. */\ntype ModuleExport = z.infer<typeof moduleExportSchema>;\n/** One `elements.config` entry, describing how a single GLib type's generated element is shaped. */\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;\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\n/** Validates `libraries`: the `\"*\"` wildcard on its own, or a non-empty array of `Name-Version` identifiers. */\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\n/** Validates `applicationId` against the reverse-DNS form `g_application_id_is_valid` accepts. */\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\n/** Validates `reactCompiler`: a boolean, or an options object whose mode and threshold are known values. */\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\n/** Validates `userEventSignals`: GLib type names mapped to arrays of non-empty signal names. */\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\n/** Validates a `{ module, export }` reference to a named export. */\nconst moduleExportSchema = z.object(\n    {\n        /** Specifier the export is imported from. */\n        module: z.string({ error: \"must be a module specifier\" }).min(1, { error: \"must be a module specifier\" }),\n        /** Identifier the module exports it under. */\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\n/** Validates one entry of `elements.config`. */\nconst elementConfigSchema = z.object({\n    /** Component that wraps the generated element. */\n    component: moduleExportSchema.optional(),\n    /** Base props interface the generated element props extend. */\n    props: moduleExportSchema.optional(),\n    /** Marks the element as having no GObject of its own, its parent container creating one instead. */\n    isLazy: z.boolean({ error: \"must be a boolean\" }).optional(),\n    /** GObject properties to leave out of the generated element props, such as those a behavior fills. */\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\n/** Validates `elements`: the behaviors module the app loads at runtime, plus the per-type entries. */\nconst elementsSchema = z.object({\n    /**\n     * Path, resolved against the project root, of a module default-exporting element configs keyed by\n     * GLib type name, as `defineElements` returns.\n     */\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    /** Per-element entries, keyed by GLib type name. */\n    config: z.record(z.string(), elementConfigSchema).optional(),\n});\n\n/** The shape every `gtkx.config.ts` is validated against, and the source of the {@link Config} type. */\nconst configSchema = z.object({\n    /**\n     * GIR namespaces to bind as `Name-Version`, or `\"*\"` for every one installed; omitting it gives\n     * `Gtk-4.0`, which is also prepended to any list that names no Gtk version of its own.\n     */\n    libraries: librariesSchema.optional(),\n    /** Directories searched for `.gir` files ahead of `GTKX_GIR_PATH` and the system locations. */\n    girPath: z.array(z.string(), { error: \"must be an array of strings if provided\" }).optional(),\n    /** Reverse-DNS GApplication identifier, and the default `applicationId` of the application element. */\n    applicationId: applicationIdSchema,\n    /** React Compiler settings; the compiler runs unless this is `false`. */\n    reactCompiler: reactCompilerSchema.optional(),\n    /** Whether to generate the binding stores; `false` makes the CLI resolve an already-installed one. */\n    codegen: z.boolean({ error: \"must be a boolean\" }).optional(),\n    /**\n     * Signal names, keyed by GLib type name, that stay suppressed while a React commit applies props, so\n     * their handlers only ever report user interaction. Unioned with the built-in GTK4 and Adwaita table.\n     */\n    userEventSignals: userEventSignalsSchema.optional(),\n    /** Per-element customization: where the behaviors module lives and how each type's element is shaped. */\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 ModuleExport,\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 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,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,EAAqB,UAAU,EAAE,MAAM,aAAa,CAAC","sourcesContent":["/** @public */\nexport { type Config, defineConfig, mergeConfig, type ResolvedConfig } from \"./config.ts\";\n/** @public */\nexport { 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 { type ConfigLoader, 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,KAAK,YAAY,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,EAAqB,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 { type ConfigLoader, createConfigLoader } from \"./loader.ts\";\n"]}

package/dist/loader.d.ts

@@ -1,29 +1,30 @@
-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.
- */
 type ConfigLoader = {
     load: (cwd: string) => Promise<LoadedConfig>;
     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;

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,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"}

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;AA0B9F;;;;;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.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\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.\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 LoadConfigOptions, type ConfigLoader };\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,12 +1,5 @@
 import type { Plugin, UserConfig } from "vite";
-import { type ConfigLoader } from "./loader.js";
-/**
- * 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.
- */
+import { type ConfigLoader } from "./loader.ts";
 declare const createConfigPlugin: (options: {
     name: string;
     loadConfig?: ConfigLoader;

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;AAsBpE,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"}

package/dist/vite-plugin.js

@@ -7,13 +7,6 @@ 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.
- */
 const createConfigPlugin = (options) => {
     const loadConfig = options.loadConfig ?? createConfigLoader();
     const state = { root: undefined };

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;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,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.ts\";\nimport { GTKX_CONFIG_VIRTUAL_ID, renderConfigModule, RESOLVED_GTKX_CONFIG_VIRTUAL_ID } from \"./virtual.ts\";\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\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"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gtkx/config",
-  "version": "1.0.0-rc.3",
+  "version": "1.0.0-rc.4",
   "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.0",
     "zod": "^4.4.3",
-    "@gtkx/utils": "1.0.0-rc.3"
+    "@gtkx/utils": "1.0.0-rc.4"
   },
   "scripts": {
     "release": "tsx ../../scripts/release-package.ts"

package/src/config.ts

@@ -2,49 +2,53 @@ 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. */
+/** A named export referenced as plain data, so codegen can emit an import for it without loading the module. */
 type ModuleExport = z.infer<typeof moduleExportSchema>;
+/** One `elements.config` entry, describing how a single GLib type's generated element is shaped. */
 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[];
 };
 
@@ -58,6 +62,7 @@ const REACT_COMPILER_TARGET = "19";
 const COMPILATION_MODE_SET: Set<string> = new Set(COMPILATION_MODES);
 const PANIC_THRESHOLD_SET: Set<string> = new Set(PANIC_THRESHOLDS);
 
+/** Validates `libraries`: the `"*"` wildcard on its own, or a non-empty array of `Name-Version` identifiers. */
 const librariesSchema = z.custom<typeof LIBRARIES_WILDCARD | string[]>().check((ctx) => {
     const value = ctx.value;
 
@@ -76,6 +81,7 @@ const librariesSchema = z.custom<typeof LIBRARIES_WILDCARD | string[]>().check((
     }
 });
 
+/** Validates `applicationId` against the reverse-DNS form `g_application_id_is_valid` accepts. */
 const applicationIdSchema = z.custom<string>().check((ctx) => {
     const value = ctx.value;
 
@@ -92,6 +98,7 @@ const applicationIdSchema = z.custom<string>().check((ctx) => {
     }
 });
 
+/** Validates `reactCompiler`: a boolean, or an options object whose mode and threshold are known values. */
 const reactCompilerSchema = z.custom<boolean | ReactCompilerOptions>().check((ctx) => {
     const value = ctx.value;
 
@@ -134,6 +141,7 @@ const reactCompilerSchema = z.custom<boolean | ReactCompilerOptions>().check((ct
     }
 });
 
+/** Validates `userEventSignals`: GLib type names mapped to arrays of non-empty signal names. */
 const userEventSignalsSchema = z.record(
     z.string(),
     z.array(
@@ -145,19 +153,27 @@ const userEventSignalsSchema = z.record(
     { error: "must be a record of GLib type names to signal name arrays" },
 );
 
+/** Validates a `{ module, export }` reference to a named export. */
 const moduleExportSchema = z.object(
     {
+        /** Specifier the export is imported from. */
         module: z.string({ error: "must be a module specifier" }).min(1, { error: "must be a module specifier" }),
+        /** Identifier the module exports it under. */
         export: z.string({ error: "must be an export name" }).min(1, { error: "must be an export name" }),
     },
     { error: "must be a { module, export } object" },
 );
 
+/** Validates one entry of `elements.config`. */
 const elementConfigSchema = z.object({
+    /** Component that wraps the generated element. */
     component: moduleExportSchema.optional(),
+    /** Base props interface the generated element props extend. */
     props: moduleExportSchema.optional(),
-    lazy: z.boolean({ error: "must be a boolean" }).optional(),
-    omitProps: z
+    /** Marks the element as having no GObject of its own, its parent container creating one instead. */
+    isLazy: z.boolean({ error: "must be a boolean" }).optional(),
+    /** GObject properties to leave out of the generated element props, such as those a behavior fills. */
+    omittedProps: z
         .array(
             z.string({ error: "must be a non-empty property name" }).min(1, {
                 error: "must be a non-empty property name",
@@ -167,27 +183,47 @@ const elementConfigSchema = z.object({
         .optional(),
 });
 
+/** Validates `elements`: the behaviors module the app loads at runtime, plus the per-type entries. */
 const elementsSchema = z.object({
+    /**
+     * Path, resolved against the project root, of a module default-exporting element configs keyed by
+     * GLib type name, as `defineElements` returns.
+     */
     behaviors: z
         .string({ error: "must be a path to a module exporting element behaviors" })
         .min(1, { error: "must be a path to a module exporting element behaviors" })
         .optional(),
+    /** Per-element entries, keyed by GLib type name. */
     config: z.record(z.string(), elementConfigSchema).optional(),
 });
 
+/** The shape every `gtkx.config.ts` is validated against, and the source of the {@link Config} type. */
 const configSchema = z.object({
+    /**
+     * GIR namespaces to bind as `Name-Version`, or `"*"` for every one installed; omitting it gives
+     * `Gtk-4.0`, which is also prepended to any list that names no Gtk version of its own.
+     */
     libraries: librariesSchema.optional(),
+    /** Directories searched for `.gir` files ahead of `GTKX_GIR_PATH` and the system locations. */
     girPath: z.array(z.string(), { error: "must be an array of strings if provided" }).optional(),
+    /** Reverse-DNS GApplication identifier, and the default `applicationId` of the application element. */
     applicationId: applicationIdSchema,
+    /** React Compiler settings; the compiler runs unless this is `false`. */
     reactCompiler: reactCompilerSchema.optional(),
+    /** Whether to generate the binding stores; `false` makes the CLI resolve an already-installed one. */
     codegen: z.boolean({ error: "must be a boolean" }).optional(),
+    /**
+     * Signal names, keyed by GLib type name, that stay suppressed while a React commit applies props, so
+     * their handlers only ever report user interaction. Unioned with the built-in GTK4 and Adwaita table.
+     */
     userEventSignals: userEventSignalsSchema.optional(),
+    /** Per-element customization: where the behaviors module lives and how each type's element is shaped. */
     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: DefineConfig<Config> = createDefineConfig<Config>();
 
@@ -241,9 +277,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 +292,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 +313,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,7 +333,7 @@ export {
     resolveLazyElements,
     resolveElementComponents,
     resolveElementProps,
-    resolveOmitProps,
+    resolveOmittedProps,
     resolveConfig,
     type ResolvedReactCompilerOptions,
     type Config,

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 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 { type ConfigLoader, createConfigLoader } from "./loader.ts";

package/src/loader.ts

@@ -2,36 +2,37 @@ 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.
- */
 type ConfigLoader = {
     load: (cwd: string) => Promise<LoadedConfig>;
     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>({

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,6 +1,6 @@
 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";
 
 type PluginState = {
     root: string | undefined;
@@ -21,13 +21,6 @@ const loadVirtualModule = async (
     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.
- */
 const createConfigPlugin = (options: {
     name: string;
     loadConfig?: ConfigLoader;