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

package/dist/config-error.d.ts

@@ -0,0 +1,16 @@
+import type { z } from "zod";
+type IssuePath = (string | number)[];
+declare const isRecord: (value: unknown) => value is Record<string, unknown>;
+declare const rawIssue: (input: unknown, path: IssuePath, message: string, isStandalone?: boolean) => {
+    params?: {
+        standalone: boolean;
+    };
+    code: "custom";
+    input: unknown;
+    path: IssuePath;
+    message: string;
+    continue: true;
+};
+declare const configError: (error: z.ZodError) => Error;
+export { isRecord, rawIssue, configError };
+//# sourceMappingURL=config-error.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"config-error.d.ts","sourceRoot":"","sources":["../src/config-error.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAE7B,KAAK,SAAS,GAAG,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,CAAC;AAIrC,QAAA,MAAM,QAAQ,GAAI,OAAO,OAAO,KAAG,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CACM,CAAC;AAEzE,QAAA,MAAM,QAAQ,GAAI,OAAO,OAAO,EAAE,MAAM,SAAS,EAAE,SAAS,MAAM,EAAE,sBAAoB;;;;;;;;;CAOtF,CAAC;AAwCH,QAAA,MAAM,WAAW,GAAI,OAAO,CAAC,CAAC,QAAQ,KAAG,KAQxC,CAAC;AAEF,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,WAAW,EAAE,CAAC"}

package/dist/config-error.js

@@ -0,0 +1,45 @@
+const CONFIG_PREFIX = "gtkx.config.ts:";
+const isRecord = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
+const rawIssue = (input, path, message, isStandalone = false) => ({
+    code: "custom",
+    input,
+    path,
+    message,
+    continue: true,
+    ...(isStandalone && { params: { standalone: true } }),
+});
+const appendSegment = (path, segment) => {
+    if (typeof segment === "number") {
+        return `${path}[${String(segment)}]`;
+    }
+    return path === "" ? String(segment) : `${path}.${String(segment)}`;
+};
+const dottedPath = (segments) => {
+    let path = "";
+    for (const segment of segments) {
+        path = appendSegment(path, segment);
+    }
+    return path;
+};
+const isStandaloneIssue = (issue) => "params" in issue && isRecord(issue.params) && issue.params.standalone === true;
+const formatIssue = (issue, fullPath) => {
+    if (issue.code === "unrecognized_keys") {
+        const [key] = issue.keys;
+        const path = dottedPath(key === undefined ? fullPath : [...fullPath, key]);
+        return `${CONFIG_PREFIX} \`${path}\` is not a recognized key`;
+    }
+    if (isStandaloneIssue(issue)) {
+        return `${CONFIG_PREFIX} ${issue.message}`;
+    }
+    const path = dottedPath(fullPath);
+    return path === "" ? `${CONFIG_PREFIX} ${issue.message}` : `${CONFIG_PREFIX} \`${path}\` ${issue.message}`;
+};
+const configError = (error) => {
+    const issue = error.issues[0];
+    if (issue === undefined) {
+        return new Error(`${CONFIG_PREFIX} invalid configuration`);
+    }
+    return new Error(formatIssue(issue, issue.path));
+};
+export { isRecord, rawIssue, configError };
+//# sourceMappingURL=config-error.js.map

package/dist/config-error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-error.js","sourceRoot":"","sources":["../src/config-error.ts"],"names":[],"mappings":"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","sourcesContent":["import type { z } from \"zod\";\n\ntype IssuePath = (string | number)[];\n\nconst CONFIG_PREFIX = \"gtkx.config.ts:\";\n\nconst isRecord = (value: unknown): value is Record<string, unknown> =>\n    typeof value === \"object\" && value !== null && !Array.isArray(value);\n\nconst rawIssue = (input: unknown, path: IssuePath, message: string, isStandalone = false) => ({\n    code: \"custom\" as const,\n    input,\n    path,\n    message,\n    continue: true as const,\n    ...(isStandalone && { params: { standalone: true } }),\n});\n\nconst appendSegment = (path: string, segment: PropertyKey): string => {\n    if (typeof segment === \"number\") {\n        return `${path}[${String(segment)}]`;\n    }\n\n    return path === \"\" ? String(segment) : `${path}.${String(segment)}`;\n};\n\nconst dottedPath = (segments: PropertyKey[]): string => {\n    let path = \"\";\n\n    for (const segment of segments) {\n        path = appendSegment(path, segment);\n    }\n\n    return path;\n};\n\nconst isStandaloneIssue = (issue: z.core.$ZodIssue): boolean =>\n    \"params\" in issue && isRecord(issue.params) && issue.params.standalone === true;\n\nconst formatIssue = (issue: z.core.$ZodIssue, fullPath: PropertyKey[]): string => {\n    if (issue.code === \"unrecognized_keys\") {\n        const [key] = issue.keys;\n        const path = dottedPath(key === undefined ? fullPath : [...fullPath, key]);\n\n        return `${CONFIG_PREFIX} \\`${path}\\` is not a recognized key`;\n    }\n\n    if (isStandaloneIssue(issue)) {\n        return `${CONFIG_PREFIX} ${issue.message}`;\n    }\n\n    const path = dottedPath(fullPath);\n\n    return path === \"\" ? `${CONFIG_PREFIX} ${issue.message}` : `${CONFIG_PREFIX} \\`${path}\\` ${issue.message}`;\n};\n\nconst configError = (error: z.ZodError): Error => {\n    const issue = error.issues[0];\n\n    if (issue === undefined) {\n        return new Error(`${CONFIG_PREFIX} invalid configuration`);\n    }\n\n    return new Error(formatIssue(issue, issue.path));\n};\n\nexport { isRecord, rawIssue, configError };\n"]}

package/dist/config.d.ts

@@ -1,10 +1,5 @@
 import { type DefineConfig } from "c12";
 import { z } from "zod";
-export declare const LIBRARIES_WILDCARD = "*";
-export declare const GIR_LIBRARY_PATTERN: RegExp;
-export declare const isValidApplicationId: (applicationId: string) => boolean;
-declare const COMPILATION_MODES: readonly ["infer", "syntax", "annotation", "all"];
-declare const PANIC_THRESHOLDS: readonly ["none", "critical_errors", "all_errors"];
 type ReactCompilerCompilationMode = (typeof COMPILATION_MODES)[number];
 type ReactCompilerPanicThreshold = (typeof PANIC_THRESHOLDS)[number];
 type ReactCompilerOptions = {
@@ -15,72 +10,80 @@ type ReactCompilerOptions = {
  * React Compiler options resolved for the build, with the compilation target
  * fixed to React 19.
  */
-export type ResolvedReactCompilerOptions = ReactCompilerOptions & {
+type ResolvedReactCompilerOptions = ReactCompilerOptions & {
     target: "19";
 };
-export declare const resolveReactCompilerOptions: (setting: Config["reactCompiler"]) => ResolvedReactCompilerOptions | null;
+/**
+ * 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.
+ */
+type Config = z.infer<typeof configSchema>;
+/** A `{ module, export }` reference to a named export, as element config entries carry it. */
+type ModuleExport = z.infer<typeof moduleExportSchema>;
+/**
+ * Configuration reduced to the values needed at runtime: the GApplication
+ * identifier, the resolved React Compiler options (`null` when disabled), the
+ * user event signals suppressed while a React commit is in progress, and the
+ * module path holding per-element configuration (`null` when unset).
+ */
+type ResolvedConfig = {
+    applicationId: string;
+    reactCompiler: ResolvedReactCompilerOptions | null;
+    userEventSignals: Record<string, string[]>;
+    elements: string | null;
+    lazyElements: string[];
+};
+declare const COMPILATION_MODES: readonly ["infer", "syntax", "annotation", "all"];
+declare const PANIC_THRESHOLDS: readonly ["none", "critical_errors", "all_errors"];
+declare const moduleExportSchema: z.ZodObject<{
+    module: z.ZodString;
+    export: z.ZodString;
+}, z.core.$strip>;
 declare const configSchema: z.ZodObject<{
-    libraries: z.ZodOptional<z.ZodCustom<"*" | string[], "*" | string[]>>;
+    libraries: z.ZodOptional<z.ZodCustom<string[] | "*", string[] | "*">>;
     girPath: z.ZodOptional<z.ZodArray<z.ZodString>>;
     applicationId: z.ZodCustom<string, string>;
-    elementProps: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
-        kind: z.ZodLiteral<"container">;
-        prop: z.ZodString;
-        child: z.ZodString;
-        append: z.ZodOptional<z.ZodCustom<import("./element-props.js").Call, import("./element-props.js").Call>>;
-        remove: z.ZodOptional<z.ZodCustom<import("./element-props.js").Call, import("./element-props.js").Call>>;
-        insert: z.ZodOptional<z.ZodCustom<import("./element-props.js").Call, import("./element-props.js").Call>>;
-        reorder: z.ZodOptional<z.ZodCustom<import("./element-props.js").Call, import("./element-props.js").Call>>;
-        autowrap: z.ZodOptional<z.ZodString>;
-        adopt: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<true>, z.ZodString]>>;
-    }, z.core.$strict>, z.ZodObject<{
-        kind: z.ZodLiteral<"value">;
-        prop: z.ZodString;
-        call: z.ZodCustom<import("./element-props.js").Call, import("./element-props.js").Call>;
-        after: z.ZodOptional<z.ZodString>;
-    }, z.core.$strict>, z.ZodObject<{
-        kind: z.ZodLiteral<"controlled-text">;
-        prop: z.ZodString;
-    }, z.core.$strict>, z.ZodObject<{
-        kind: z.ZodLiteral<"lazy">;
-        prop: z.ZodString;
-        lookup: z.ZodOptional<z.ZodString>;
-    }, z.core.$strict>, z.ZodObject<{
-        kind: z.ZodLiteral<"list">;
-        prop: z.ZodString;
-        add: z.ZodUnion<readonly [z.ZodCustom<import("./element-props.js").Call, import("./element-props.js").Call>, z.ZodArray<z.ZodCustom<import("./element-props.js").Call, import("./element-props.js").Call>>]>;
-        remove: z.ZodOptional<z.ZodCustom<import("./element-props.js").Call, import("./element-props.js").Call>>;
-        clear: z.ZodOptional<z.ZodCustom<import("./element-props.js").Call, import("./element-props.js").Call>>;
-    }, z.core.$strict>], "kind">>>>;
     reactCompiler: z.ZodOptional<z.ZodCustom<boolean | ReactCompilerOptions, boolean | ReactCompilerOptions>>;
     codegen: z.ZodOptional<z.ZodBoolean>;
+    userEventSignals: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodString>>>;
+    elements: z.ZodOptional<z.ZodObject<{
+        behaviors: z.ZodOptional<z.ZodString>;
+        config: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+            component: z.ZodOptional<z.ZodObject<{
+                module: z.ZodString;
+                export: z.ZodString;
+            }, z.core.$strip>>;
+            props: z.ZodOptional<z.ZodObject<{
+                module: z.ZodString;
+                export: z.ZodString;
+            }, z.core.$strip>>;
+            lazy: z.ZodOptional<z.ZodBoolean>;
+            omitProps: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        }, z.core.$strip>>>;
+    }, z.core.$strip>>;
 }, z.core.$strip>;
-/**
- * User-facing configuration for a GTKX project, as authored in `gtkx.config.ts`:
- * the GIR libraries to bind, extra `.gir` search paths, the GApplication id,
- * custom element prop mappings, and the React Compiler and codegen settings.
- */
-export type Config = z.infer<typeof configSchema>;
-export declare const validateConfig: (config: Config) => void;
 /**
  * Identity helper that returns the given configuration typed as {@link Config},
  * enabling editor autocompletion and type checking in `gtkx.config.ts`.
  */
-export declare const defineConfig: DefineConfig<Config>;
+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.
  */
-export declare const mergeConfig: (base: Config, override: Config) => Config;
-/**
- * Configuration reduced to the values needed at runtime: the GApplication
- * identifier and the resolved React Compiler options (`null` when disabled).
- */
-export type ResolvedConfig = {
-    applicationId: string;
-    reactCompiler: ResolvedReactCompilerOptions | null;
-};
-export declare const resolveConfig: (config: Config) => ResolvedConfig;
-export {};
+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 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, };
 //# 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;AAE5D,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,eAAO,MAAM,kBAAkB,MAAM,CAAC;AAEtC,eAAO,MAAM,mBAAmB,EAAE,MAA+C,CAAC;AAKlF,eAAO,MAAM,oBAAoB,kBAAmB,MAAM,KAAG,OAK5D,CAAC;AAEF,QAAA,MAAM,iBAAiB,YAAI,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,KAAK,CAAU,CAAC;AAE5E,QAAA,MAAM,gBAAgB,YAAI,MAAM,EAAE,iBAAiB,EAAE,YAAY,CAAU,CAAC;AAE5E,KAAK,4BAA4B,GAAG,CAAC,OAAO,iBAAiB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEvE,KAAK,2BAA2B,GAAG,CAAC,OAAO,gBAAgB,CAAC,CAAC,MAAM,CAAC,CAAC;AAErE,KAAK,oBAAoB,GAAG;IACxB,eAAe,CAAC,EAAE,4BAA4B,CAAC;IAC/C,cAAc,CAAC,EAAE,2BAA2B,CAAC;CAChD,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,4BAA4B,GAAG,oBAAoB,GAAG;IAC9D,MAAM,EAAE,IAAI,CAAC;CAChB,CAAC;AAIF,eAAO,MAAM,2BAA2B,YAAa,MAAM,CAAC,eAAe,CAAC,KAAG,4BAA4B,GAAG,IAI7G,CAAC;AAwFF,QAAA,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAOhB,CAAC;AAEH;;;;GAIG;AACH,MAAM,MAAM,MAAM,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC;AAElD,eAAO,MAAM,cAAc,WAAY,MAAM,KAAG,IAG/C,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,YAAY,EAAE,YAAY,CAAC,MAAM,CAAgC,CAAC;AAE/E;;;;GAIG;AACH,eAAO,MAAM,WAAW,SAAU,MAAM,YAAY,MAAM,KAAG,MAA8B,CAAC;AAE5F;;;GAGG;AACH,MAAM,MAAM,cAAc,GAAG;IACzB,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,4BAA4B,GAAG,IAAI,CAAC;CACtD,CAAC;AAEF,eAAO,MAAM,aAAa,WAAY,MAAM,KAAG,cAG7C,CAAC"}
+{"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"}

package/dist/config.js

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

package/dist/index.d.ts

@@ -1,4 +1,3 @@
 export { type Config, defineConfig, mergeConfig, type ResolvedConfig, type ResolvedReactCompilerOptions, } from "./config.js";
-export type { AppliedProp, Arg, ArgRef, Call, ContainerProp, ControlledTextProp, ElementProp, LazyProp, ListProp, ValueProp, } from "./element-props.js";
 export { type LoadedConfig, loadConfig } from "./loader.js";
 //# 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,YAAY,EACR,WAAW,EACX,GAAG,EACH,MAAM,EACN,IAAI,EACJ,aAAa,EACb,kBAAkB,EAClB,WAAW,EACX,QAAQ,EACR,QAAQ,EACR,SAAS,GACZ,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,KAAK,YAAY,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC"}
+{"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"}

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;AAarB,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 {\n    AppliedProp,\n    Arg,\n    ArgRef,\n    Call,\n    ContainerProp,\n    ControlledTextProp,\n    ElementProp,\n    LazyProp,\n    ListProp,\n    ValueProp,\n} from \"./element-props.js\";\nexport { type LoadedConfig, loadConfig } from \"./loader.js\";\n"]}
+{"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"]}

package/dist/internal.d.ts

@@ -1,3 +1,3 @@
-export { GIR_LIBRARY_PATTERN, isValidApplicationId, LIBRARIES_WILDCARD } from "./config.js";
+export { isValidApplicationId, resolveElementComponents, resolveElementProps, resolveLazyElements, resolveOmitProps, } from "./config.js";
 export { type ConfigLoader, createConfigLoader } from "./loader.js";
 //# 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,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAC5F,OAAO,EAAE,KAAK,YAAY,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC"}
+{"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"}

package/dist/internal.js

@@ -1,3 +1,3 @@
-export { GIR_LIBRARY_PATTERN, isValidApplicationId, LIBRARIES_WILDCARD } from "./config.js";
+export { isValidApplicationId, resolveElementComponents, resolveElementProps, resolveLazyElements, resolveOmitProps, } 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,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAC5F,OAAO,EAAqB,kBAAkB,EAAE,MAAM,aAAa,CAAC","sourcesContent":["export { GIR_LIBRARY_PATTERN, isValidApplicationId, LIBRARIES_WILDCARD } from \"./config.js\";\nexport { type ConfigLoader, createConfigLoader } from \"./loader.js\";\n"]}
+{"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"]}

package/dist/loader.d.ts

@@ -1,24 +1,31 @@
 import { type Config, type ResolvedConfig } from "./config.js";
 /**
  * Result of loading a `gtkx.config.ts` file: the parsed configuration, the
- * resolved config file path (`undefined` when none was found), and the project
- * root it was loaded from.
+ * resolved config file path, and the project root it was loaded from.
  */
-export type LoadedConfig = {
+type LoadedConfig = {
     config: Config;
-    configFile: string | undefined;
+    configFile: string;
     root: string;
 };
-export type LoadConfigOptions = {
+type LoadConfigOptions = {
     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.
  */
-export declare const loadConfig: (cwd: string, options?: LoadConfigOptions) => Promise<LoadedConfig>;
-export type ConfigLoader = (cwd: string) => Promise<ResolvedConfig>;
-export declare const createConfigLoader: (options?: LoadConfigOptions) => ConfigLoader;
+declare const loadConfig: (cwd: string, options?: LoadConfigOptions) => Promise<LoadedConfig>;
+declare const createConfigLoader: (options?: LoadConfigOptions) => ConfigLoader;
+export { loadConfig, createConfigLoader, type LoadedConfig, type LoadConfigOptions, type ConfigLoader };
 //# sourceMappingURL=loader.d.ts.map

package/dist/loader.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../src/loader.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,KAAK,MAAM,EAAE,KAAK,cAAc,EAAiC,MAAM,aAAa,CAAC;AAE9F;;;;GAIG;AACH,MAAM,MAAM,YAAY,GAAG;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B,IAAI,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAC5B,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC7B,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,UAAU,QAAe,MAAM,YAAW,iBAAiB,KAAQ,OAAO,CAAC,YAAY,CAqBnG,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,cAAc,CAAC,CAAC;AAEpE,eAAO,MAAM,kBAAkB,aAAa,iBAAiB,KAAQ,YAgBpE,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;;;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"}