@gtkx/config 1.0.0 → 1.2.0

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

package/dist/schema-text.d.ts

@@ -0,0 +1,10 @@
+import { z } from "zod";
+declare const text: (message: string) => z.ZodString;
+declare const textList: (itemNoun: string, listMessage: string) => z.ZodArray<z.ZodString>;
+declare const url: (message: string) => z.ZodURL;
+declare const flag: (message: string) => z.ZodBoolean;
+declare const textRecord: (valueMessage: string, recordMessage: string) => z.ZodRecord<z.ZodString, z.ZodString>;
+declare const fileExtension: (message: string) => z.ZodString;
+declare const relativePathRecord: (keyMessage: string, valueMessage: string, recordMessage: string) => z.ZodRecord<z.ZodString, z.ZodString>;
+export { fileExtension, flag, relativePathRecord, text, textList, textRecord, url };
+//# sourceMappingURL=schema-text.d.ts.map

package/dist/schema-text.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-text.d.ts","sourceRoot":"","sources":["../src/schema-text.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAaxB,QAAA,MAAM,IAAI,GAAI,SAAS,MAAM,KAAG,CAAC,CAAC,SAAoE,CAAC;AAEvG,QAAA,MAAM,QAAQ,GAAI,UAAU,MAAM,EAAE,aAAa,MAAM,KAAG,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS,CACJ,CAAC;AAE7E,QAAA,MAAM,GAAG,GAAI,SAAS,MAAM,KAAG,CAAC,CAAC,MAAmC,CAAC;AACrE,QAAA,MAAM,IAAI,GAAI,SAAS,MAAM,KAAG,CAAC,CAAC,UAA2C,CAAC;AAE9E,QAAA,MAAM,UAAU,GAAI,cAAc,MAAM,EAAE,eAAe,MAAM,KAAG,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,EAAE,CAAC,CAAC,SAAS,CAChC,CAAC;AAEvE,QAAA,MAAM,aAAa,GAAI,SAAS,MAAM,KAAG,CAAC,CAAC,SACuD,CAAC;AAKnG,QAAA,MAAM,kBAAkB,GACpB,YAAY,MAAM,EAClB,cAAc,MAAM,EACpB,eAAe,MAAM,KACtB,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,EAAE,CAAC,CAAC,SAAS,CAC6C,CAAC;AAErF,OAAO,EAAE,aAAa,EAAE,IAAI,EAAE,kBAAkB,EAAE,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,GAAG,EAAE,CAAC"}

package/dist/schema-text.js

@@ -0,0 +1,19 @@
+import { z } from "zod";
+const FILE_EXTENSION = /^[^\s./\\*?[\]]+(?:\.[^\s./\\*?[\]]+)*$/;
+const SEGMENT_SEPARATOR = /[/\\]/;
+const isRelativePath = (value) => {
+    if (value.length === 0 || value.startsWith("/") || value.includes("\\")) {
+        return false;
+    }
+    return value.split(SEGMENT_SEPARATOR).every((part) => part !== "" && part !== "..");
+};
+const text = (message) => z.string({ error: message }).min(1, { error: message });
+const textList = (itemNoun, listMessage) => z.array(text(`must be a non-empty ${itemNoun}`), { error: listMessage });
+const url = (message) => z.url({ error: message });
+const flag = (message) => z.boolean({ error: message });
+const textRecord = (valueMessage, recordMessage) => z.record(z.string(), text(valueMessage), { error: recordMessage });
+const fileExtension = (message) => z.string({ error: message }).refine((value) => FILE_EXTENSION.test(value), { error: message });
+const relativePath = (message) => z.string({ error: message }).refine((value) => isRelativePath(value), { error: message });
+const relativePathRecord = (keyMessage, valueMessage, recordMessage) => z.record(relativePath(keyMessage), text(valueMessage), { error: recordMessage });
+export { fileExtension, flag, relativePathRecord, text, textList, textRecord, url };
+//# sourceMappingURL=schema-text.js.map

package/dist/schema-text.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-text.js","sourceRoot":"","sources":["../src/schema-text.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,cAAc,GAAG,yCAAyC,CAAC;AACjE,MAAM,iBAAiB,GAAG,OAAO,CAAC;AAElC,MAAM,cAAc,GAAG,CAAC,KAAa,EAAW,EAAE;IAC9C,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,IAAI,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;QACtE,OAAO,KAAK,CAAC;IACjB,CAAC;IAED,OAAO,KAAK,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,KAAK,EAAE,IAAI,IAAI,KAAK,IAAI,CAAC,CAAC;AACxF,CAAC,CAAC;AAEF,MAAM,IAAI,GAAG,CAAC,OAAe,EAAe,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC;AAEvG,MAAM,QAAQ,GAAG,CAAC,QAAgB,EAAE,WAAmB,EAA2B,EAAE,CAChF,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,uBAAuB,QAAQ,EAAE,CAAC,EAAE,EAAE,KAAK,EAAE,WAAW,EAAE,CAAC,CAAC;AAE7E,MAAM,GAAG,GAAG,CAAC,OAAe,EAAY,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC;AACrE,MAAM,IAAI,GAAG,CAAC,OAAe,EAAgB,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC;AAE9E,MAAM,UAAU,GAAG,CAAC,YAAoB,EAAE,aAAqB,EAAyC,EAAE,CACtG,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,IAAI,CAAC,YAAY,CAAC,EAAE,EAAE,KAAK,EAAE,aAAa,EAAE,CAAC,CAAC;AAEvE,MAAM,aAAa,GAAG,CAAC,OAAe,EAAe,EAAE,CACnD,CAAC,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,cAAc,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC;AAEnG,MAAM,YAAY,GAAG,CAAC,OAAe,EAAe,EAAE,CAClD,CAAC,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,cAAc,CAAC,KAAK,CAAC,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC;AAE9F,MAAM,kBAAkB,GAAG,CACvB,UAAkB,EAClB,YAAoB,EACpB,aAAqB,EACgB,EAAE,CACvC,CAAC,CAAC,MAAM,CAAC,YAAY,CAAC,UAAU,CAAC,EAAE,IAAI,CAAC,YAAY,CAAC,EAAE,EAAE,KAAK,EAAE,aAAa,EAAE,CAAC,CAAC;AAErF,OAAO,EAAE,aAAa,EAAE,IAAI,EAAE,kBAAkB,EAAE,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,GAAG,EAAE,CAAC","sourcesContent":["import { z } from \"zod\";\n\nconst FILE_EXTENSION = /^[^\\s./\\\\*?[\\]]+(?:\\.[^\\s./\\\\*?[\\]]+)*$/;\nconst SEGMENT_SEPARATOR = /[/\\\\]/;\n\nconst isRelativePath = (value: string): boolean => {\n    if (value.length === 0 || value.startsWith(\"/\") || value.includes(\"\\\\\")) {\n        return false;\n    }\n\n    return value.split(SEGMENT_SEPARATOR).every((part) => part !== \"\" && part !== \"..\");\n};\n\nconst text = (message: string): z.ZodString => z.string({ error: message }).min(1, { error: message });\n\nconst textList = (itemNoun: string, listMessage: string): z.ZodArray<z.ZodString> =>\n    z.array(text(`must be a non-empty ${itemNoun}`), { error: listMessage });\n\nconst url = (message: string): z.ZodURL => z.url({ error: message });\nconst flag = (message: string): z.ZodBoolean => z.boolean({ error: message });\n\nconst textRecord = (valueMessage: string, recordMessage: string): z.ZodRecord<z.ZodString, z.ZodString> =>\n    z.record(z.string(), text(valueMessage), { error: recordMessage });\n\nconst fileExtension = (message: string): z.ZodString =>\n    z.string({ error: message }).refine((value) => FILE_EXTENSION.test(value), { error: message });\n\nconst relativePath = (message: string): z.ZodString =>\n    z.string({ error: message }).refine((value) => isRelativePath(value), { error: message });\n\nconst relativePathRecord = (\n    keyMessage: string,\n    valueMessage: string,\n    recordMessage: string,\n): z.ZodRecord<z.ZodString, z.ZodString> =>\n    z.record(relativePath(keyMessage), text(valueMessage), { error: recordMessage });\n\nexport { fileExtension, flag, relativePathRecord, text, textList, textRecord, url };\n"]}

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

@@ -1,4 +1,3 @@
-declare const DEFAULT_USER_EVENT_SIGNALS: Record<string, string[]>;
 declare const resolveUserEventSignals: (overrides: Record<string, string[]> | undefined) => Record<string, string[]>;
-export { DEFAULT_USER_EVENT_SIGNALS, resolveUserEventSignals };
+export { resolveUserEventSignals };
 //# sourceMappingURL=user-event-signals.d.ts.map

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

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

package/dist/user-event-signals.js

@@ -44,5 +44,5 @@ const resolveUserEventSignals = (overrides) => {
     }
     return resolved;
 };
-export { DEFAULT_USER_EVENT_SIGNALS, resolveUserEventSignals };
+export { resolveUserEventSignals };
 //# sourceMappingURL=user-event-signals.js.map

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

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

package/dist/vite-plugin.d.ts

@@ -9,8 +9,8 @@ declare const createConfigPlugin: (options: {
     name: string;
     /** Loader the configuration is resolved through, defaulting to a fresh caching loader. */
     loadConfig?: ConfigLoader;
-    /** Extra Vite configuration contributed from the plugin's `config` hook. */
-    config?: () => Omit<UserConfig, "plugins">;
+    /** Extra Vite configuration contributed from the plugin's `config` hook, given the user's own configuration. */
+    config?: (config: UserConfig) => Omit<UserConfig, "plugins">;
 }) => Plugin;
 export default createConfigPlugin;
 //# sourceMappingURL=vite-plugin.d.ts.map

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

package/dist/vite-plugin.js

@@ -18,7 +18,7 @@ const createConfigPlugin = (options) => {
         name: options.name,
         config(config) {
             state.root = config.root ?? state.root;
-            return options.config?.();
+            return options.config?.(config);
         },
         resolveId: (id) => resolveVirtualId(id),
         load: (id) => loadVirtualModule(id, loadConfig, state),

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;AAQ3G,MAAM,gBAAgB,GAAG,CAAC,EAAU,EAAiB,EAAE,CACnD,EAAE,KAAK,sBAAsB,CAAC,CAAC,CAAC,+BAA+B,CAAC,CAAC,CAAC,IAAI,CAAC;AAE3E,MAAM,iBAAiB,GAAG,KAAK,EAC3B,EAAU,EACV,UAAwB,EACxB,KAAkB,EACS,EAAE;IAC7B,IAAI,EAAE,KAAK,+BAA+B,EAAE,CAAC;QACzC,OAAO,SAAS,CAAC;IACrB,CAAC;IAED,OAAO,kBAAkB,CAAC,MAAM,UAAU,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;AACrF,CAAC,CAAC;AAEF;;;GAGG;AACH,MAAM,kBAAkB,GAAG,CAAC,OAO3B,EAAU,EAAE;IACT,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,IAAI,kBAAkB,EAAE,CAAC;IAC9D,MAAM,KAAK,GAAgB,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;IAE/C,OAAO;QACH,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,MAAM,CAAC,MAAkB;YACrB,KAAK,CAAC,IAAI,GAAG,MAAM,CAAC,IAAI,IAAI,KAAK,CAAC,IAAI,CAAC;YAEvC,OAAO,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC;QAC9B,CAAC;QACD,SAAS,EAAE,CAAC,EAAU,EAAE,EAAE,CAAC,gBAAgB,CAAC,EAAE,CAAC;QAC/C,IAAI,EAAE,CAAC,EAAU,EAAE,EAAE,CAAC,iBAAiB,CAAC,EAAE,EAAE,UAAU,EAAE,KAAK,CAAC;KACjE,CAAC;AACN,CAAC,CAAC;AAEF,eAAe,kBAAkB,CAAC","sourcesContent":["import type { Plugin, UserConfig } from \"vite\";\nimport { type ConfigLoader, createConfigLoader } from \"./loader.ts\";\nimport { GTKX_CONFIG_VIRTUAL_ID, renderConfigModule, RESOLVED_GTKX_CONFIG_VIRTUAL_ID } from \"./virtual.ts\";\n\n/** State the plugin carries from Vite's `config` hook to the virtual module it serves. */\ntype PluginState = {\n    /** Project root taken from Vite's `config` hook, undefined when the user config leaves it unset. */\n    root: string | undefined;\n};\n\nconst resolveVirtualId = (id: string): string | null =>\n    id === GTKX_CONFIG_VIRTUAL_ID ? RESOLVED_GTKX_CONFIG_VIRTUAL_ID : null;\n\nconst loadVirtualModule = async (\n    id: string,\n    loadConfig: ConfigLoader,\n    state: PluginState,\n): Promise<string | undefined> => {\n    if (id !== RESOLVED_GTKX_CONFIG_VIRTUAL_ID) {\n        return undefined;\n    }\n\n    return renderConfigModule(await loadConfig.resolve(state.root ?? process.cwd()));\n};\n\n/**\n * Creates a Vite plugin serving `virtual:gtkx-config`, the module carrying the project's resolved\n * `gtkx.config.ts`.\n */\nconst createConfigPlugin = (options: {\n    /** Name the plugin is registered under in Vite. */\n    name: string;\n    /** Loader the configuration is resolved through, defaulting to a fresh caching loader. */\n    loadConfig?: ConfigLoader;\n    /** Extra Vite configuration contributed from the plugin's `config` hook. */\n    config?: () => Omit<UserConfig, \"plugins\">;\n}): Plugin => {\n    const loadConfig = options.loadConfig ?? createConfigLoader();\n    const state: PluginState = { root: undefined };\n\n    return {\n        name: options.name,\n        config(config: UserConfig) {\n            state.root = config.root ?? state.root;\n\n            return options.config?.();\n        },\n        resolveId: (id: string) => resolveVirtualId(id),\n        load: (id: string) => loadVirtualModule(id, loadConfig, state),\n    };\n};\n\nexport default createConfigPlugin;\n"]}
+{"version":3,"file":"vite-plugin.js","sourceRoot":"","sources":["../src/vite-plugin.ts"],"names":[],"mappings":"AACA,OAAO,EAAqB,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACpE,OAAO,EAAE,sBAAsB,EAAE,kBAAkB,EAAE,+BAA+B,EAAE,MAAM,cAAc,CAAC;AAQ3G,MAAM,gBAAgB,GAAG,CAAC,EAAU,EAAiB,EAAE,CACnD,EAAE,KAAK,sBAAsB,CAAC,CAAC,CAAC,+BAA+B,CAAC,CAAC,CAAC,IAAI,CAAC;AAE3E,MAAM,iBAAiB,GAAG,KAAK,EAC3B,EAAU,EACV,UAAwB,EACxB,KAAkB,EACS,EAAE;IAC7B,IAAI,EAAE,KAAK,+BAA+B,EAAE,CAAC;QACzC,OAAO,SAAS,CAAC;IACrB,CAAC;IAED,OAAO,kBAAkB,CAAC,MAAM,UAAU,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;AACrF,CAAC,CAAC;AAEF;;;GAGG;AACH,MAAM,kBAAkB,GAAG,CAAC,OAO3B,EAAU,EAAE;IACT,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,IAAI,kBAAkB,EAAE,CAAC;IAC9D,MAAM,KAAK,GAAgB,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;IAE/C,OAAO;QACH,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,MAAM,CAAC,MAAkB;YACrB,KAAK,CAAC,IAAI,GAAG,MAAM,CAAC,IAAI,IAAI,KAAK,CAAC,IAAI,CAAC;YAEvC,OAAO,OAAO,CAAC,MAAM,EAAE,CAAC,MAAM,CAAC,CAAC;QACpC,CAAC;QACD,SAAS,EAAE,CAAC,EAAU,EAAE,EAAE,CAAC,gBAAgB,CAAC,EAAE,CAAC;QAC/C,IAAI,EAAE,CAAC,EAAU,EAAE,EAAE,CAAC,iBAAiB,CAAC,EAAE,EAAE,UAAU,EAAE,KAAK,CAAC;KACjE,CAAC;AACN,CAAC,CAAC;AAEF,eAAe,kBAAkB,CAAC","sourcesContent":["import type { Plugin, UserConfig } from \"vite\";\nimport { type ConfigLoader, createConfigLoader } from \"./loader.ts\";\nimport { GTKX_CONFIG_VIRTUAL_ID, renderConfigModule, RESOLVED_GTKX_CONFIG_VIRTUAL_ID } from \"./virtual.ts\";\n\n/** State the plugin carries from Vite's `config` hook to the virtual module it serves. */\ntype PluginState = {\n    /** Project root taken from Vite's `config` hook, undefined when the user config leaves it unset. */\n    root: string | undefined;\n};\n\nconst resolveVirtualId = (id: string): string | null =>\n    id === GTKX_CONFIG_VIRTUAL_ID ? RESOLVED_GTKX_CONFIG_VIRTUAL_ID : null;\n\nconst loadVirtualModule = async (\n    id: string,\n    loadConfig: ConfigLoader,\n    state: PluginState,\n): Promise<string | undefined> => {\n    if (id !== RESOLVED_GTKX_CONFIG_VIRTUAL_ID) {\n        return undefined;\n    }\n\n    return renderConfigModule(await loadConfig.resolve(state.root ?? process.cwd()));\n};\n\n/**\n * Creates a Vite plugin serving `virtual:gtkx-config`, the module carrying the project's resolved\n * `gtkx.config.ts`.\n */\nconst createConfigPlugin = (options: {\n    /** Name the plugin is registered under in Vite. */\n    name: string;\n    /** Loader the configuration is resolved through, defaulting to a fresh caching loader. */\n    loadConfig?: ConfigLoader;\n    /** Extra Vite configuration contributed from the plugin's `config` hook, given the user's own configuration. */\n    config?: (config: UserConfig) => 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?.(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",
+  "version": "1.2.0",
   "description": "gtkx.config.ts schema, loader, and the element-prop mapping language shared across the GTKX toolchain",
   "keywords": [
     "gtkx",
@@ -44,6 +44,16 @@
     "dist",
     "src"
   ],
+  "nx": {
+    "targets": {
+      "lint": {
+        "options": {
+          "cwd": ".",
+          "command": "eslint {projectRoot}"
+        }
+      }
+    }
+  },
   "engines": {
     "node": ">=24"
   },
@@ -52,7 +62,7 @@
     "defu": "^6.1.7",
     "vite": "^8.2.1",
     "zod": "^4.4.3",
-    "@gtkx/utils": "1.0.0"
+    "@gtkx/utils": "1.2.0"
   },
   "scripts": {
     "release": "tsx ../../scripts/release-package.ts"

package/src/config-error.ts

@@ -3,6 +3,7 @@ import type { z } from "zod";
 type IssuePath = (string | number)[];
 
 const CONFIG_PREFIX = "gtkx.config.ts:";
+const UNRECOGNIZED_KEY_REASON = "is not a recognized key";
 
 const isRecord = (value: unknown): value is Record<string, unknown> =>
     typeof value === "object" && value !== null && !Array.isArray(value);
@@ -37,12 +38,27 @@ const dottedPath = (segments: PropertyKey[]): string => {
 const isStandaloneIssue = (issue: z.core.$ZodIssue): boolean =>
     "params" in issue && isRecord(issue.params) && issue.params.standalone === true;
 
-const formatIssue = (issue: z.core.$ZodIssue, fullPath: PropertyKey[]): string => {
+const unrecognizedKeyPath = (issue: z.core.$ZodIssue, fullPath: PropertyKey[]): string | undefined => {
     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`;
+        return dottedPath(key === undefined ? fullPath : [...fullPath, key]);
+    }
+
+    return issue.code === "invalid_key" ? dottedPath(fullPath) : undefined;
+};
+
+const keyRejectionReason = (issue: z.core.$ZodIssue): string => {
+    const nested = issue.code === "invalid_key" ? issue.issues[0] : undefined;
+
+    return nested?.code === "custom" ? nested.message : UNRECOGNIZED_KEY_REASON;
+};
+
+const formatIssue = (issue: z.core.$ZodIssue, fullPath: PropertyKey[]): string => {
+    const unrecognized = unrecognizedKeyPath(issue, fullPath);
+
+    if (unrecognized !== undefined) {
+        return `${CONFIG_PREFIX} \`${unrecognized}\` ${keyRejectionReason(issue)}`;
     }
 
     if (isStandaloneIssue(issue)) {
@@ -54,6 +70,9 @@ const formatIssue = (issue: z.core.$ZodIssue, fullPath: PropertyKey[]): string =
     return path === "" ? `${CONFIG_PREFIX} ${issue.message}` : `${CONFIG_PREFIX} \`${path}\` ${issue.message}`;
 };
 
+const missingConfigFileError = (cwd: string): Error =>
+    new Error(`${CONFIG_PREFIX} no configuration file found in ${cwd}`);
+
 const configError = (error: z.ZodError): Error => {
     const issue = error.issues[0];
 
@@ -64,4 +83,4 @@ const configError = (error: z.ZodError): Error => {
     return new Error(formatIssue(issue, issue.path));
 };
 
-export { isRecord, rawIssue, configError };
+export { isRecord, rawIssue, missingConfigFileError, configError };

package/src/config.ts

@@ -3,6 +3,7 @@ import { defu } from "defu";
 import { resolve } from "node:path";
 import { z } from "zod";
 import { configError, isRecord, rawIssue } from "./config-error.ts";
+import { deploySchema } from "./deploy.ts";
 import { resolveUserEventSignals } from "./user-event-signals.ts";
 
 /** Accepted `reactCompiler.compilationMode` values, choosing which functions the compiler processes. */
@@ -29,8 +30,9 @@ type ResolvedReactCompilerOptions = ReactCompilerOptions & {
 
 /**
  * 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.
+ * to bind and where to find them, the GApplication id, per-element configuration, the React
+ * Compiler, codegen, and user event signal settings, and the `future` block opting into behavior
+ * that becomes the default in the next major version.
  */
 type Config = z.infer<typeof configSchema>;
 type ModuleExport = z.infer<typeof moduleExportSchema>;
@@ -179,8 +181,13 @@ const elementsSchema = z.object({
     config: z.record(z.string(), elementConfigSchema).optional(),
 });
 
+const futureSchema = z.object({
+    v2ByteArrays: z.boolean({ error: "must be a boolean" }).optional(),
+});
+
 /** Schema every `gtkx.config.ts` is validated against, and the source of the {@link Config} type. */
 const configSchema = z.object({
+    future: futureSchema.optional(),
     libraries: librariesSchema.optional(),
     girPath: z.array(z.string(), { error: "must be an array of strings if provided" }).optional(),
     applicationId: applicationIdSchema,
@@ -188,6 +195,7 @@ const configSchema = z.object({
     codegen: z.boolean({ error: "must be a boolean" }).optional(),
     userEventSignals: userEventSignalsSchema.optional(),
     elements: elementsSchema.optional(),
+    deploy: deploySchema.optional(),
 });
 
 /**
@@ -294,9 +302,9 @@ const resolveConfig = (config: Config, root?: string): ResolvedConfig => ({
 });
 
 export {
+    APPLICATION_ID_MAX_LENGTH,
     defineConfig,
     isValidApplicationId,
-    resolveReactCompilerOptions,
     validateConfig,
     mergeConfig,
     resolveLazyElements,

package/src/deploy.ts

@@ -0,0 +1,260 @@
+import { z } from "zod";
+import { fileExtension, flag, relativePathRecord, text, textList, textRecord, url } from "./schema-text.ts";
+
+const APPIMAGE_COMPRESSIONS = ["gzip", "xz", "zstd"] as const;
+const DEB_COMPRESSIONS = ["gzip", "none", "xz", "zstd"] as const;
+const DEB_SIGN_METHODS = ["debsign", "dpkg-sig"] as const;
+const DEB_SIGN_TYPES = ["archive", "maint", "origin"] as const;
+const DEPLOY_TARGET_NAMES = ["appimage", "deb", "flatpak", "rpm"] as const;
+const FLATPAK_MODES = ["prebuilt", "source"] as const;
+const NODE_SOURCES = ["download", "host", "path"] as const;
+const OARS_INTENSITIES = ["intense", "mild", "moderate", "none"] as const;
+const PACKAGE_MANAGERS = ["npm", "pnpm", "yarn"] as const;
+const RELEASE_TYPES = ["development", "snapshot", "stable"] as const;
+const RELEASE_URGENCIES = ["critical", "high", "low", "medium"] as const;
+const RPM_COMPRESSIONS = ["gzip", "lzma", "xz", "zstd"] as const;
+
+const URL_KINDS = [
+    "bugtracker",
+    "contact",
+    "contribute",
+    "donation",
+    "faq",
+    "help",
+    "translate",
+    "vcs-browser",
+] as const;
+
+const BOOLEAN_ERROR = "must be a boolean";
+const EPOCH_ERROR = "must be a non-negative integer";
+const HEX_COLOR_ERROR = "must be a #rrggbb color";
+const HEX_COLOR_PATTERN = /^#[\dA-Fa-f]{6}$/;
+const KEY_FILE_ERROR = "must be a path to a PGP key file";
+const KEY_ID_ERROR = "must be a PGP key id";
+const SCRIPT_ERROR = "must be a path to a shell script";
+const SPDX_ERROR = "must be an SPDX license expression";
+const URL_ERROR = "must be an absolute URL";
+const VERSION_ERROR = "must be a version string";
+const hexColorSchema = z.string({ error: HEX_COLOR_ERROR }).regex(HEX_COLOR_PATTERN, { error: HEX_COLOR_ERROR });
+
+const relationsSchema = z.strictObject({
+    deb: textList("Debian package relation", "must be an array of Debian package relations").optional(),
+    rpm: textList("RPM package relation", "must be an array of RPM package relations").optional(),
+});
+
+const developerSchema = z.strictObject({
+    id: text("must be a reverse-DNS developer id").optional(),
+    name: text("must be a developer or organization name").optional(),
+    email: text("must be an email address").optional(),
+});
+
+const screenshotSchema = z
+    .strictObject({
+        url: url("must be an absolute URL to a PNG or JPEG").optional(),
+        file: text("must be an image path relative to the project root").optional(),
+        caption: text("must be a screenshot caption").optional(),
+        isDefault: flag(BOOLEAN_ERROR).optional(),
+    })
+    .refine((entry) => entry.url !== undefined || entry.file !== undefined, {
+        error: "must have either a `url` or a `file`",
+    });
+
+const releaseSchema = z.strictObject({
+    version: text(VERSION_ERROR),
+    date: z.iso.date({ error: "must be an ISO date (YYYY-MM-DD)" }),
+    type: z.enum(RELEASE_TYPES, { error: "must be one of development, snapshot, stable" }).optional(),
+    urgency: z.enum(RELEASE_URGENCIES, { error: "must be one of critical, high, low, medium" }).optional(),
+    notes: textList("release note paragraph", "must be an array of release note paragraphs").optional(),
+    url: url(URL_ERROR).optional(),
+});
+
+const fileAssociationSchema = z.strictObject({
+    extension: fileExtension("must be a file extension without a leading dot"),
+    mimeType: text("must be a MIME type such as text/plain"),
+    description: text("must be a description of the file type").optional(),
+});
+
+const desktopActionSchema = z.strictObject({
+    name: text("must be an action name"),
+    args: textList("argument", "must be an array of arguments appended to Exec").optional(),
+    icon: text("must be an icon name").optional(),
+});
+
+const brandingSchema = z.strictObject({
+    light: hexColorSchema,
+    dark: hexColorSchema,
+});
+
+const nodeRuntimeSchema = z.strictObject({
+    source: z.enum(NODE_SOURCES, { error: "must be one of download, host, path" }).optional(),
+    version: text("must be a Node.js version such as 24.19.0").optional(),
+    path: text("must be a path to a node binary").optional(),
+    shouldStrip: flag(BOOLEAN_ERROR).optional(),
+    shouldUseCompileCache: flag(BOOLEAN_ERROR).optional(),
+});
+
+const scriptsSchema = z.strictObject({
+    preInstall: text(SCRIPT_ERROR).optional(),
+    postInstall: text(SCRIPT_ERROR).optional(),
+    preRemove: text(SCRIPT_ERROR).optional(),
+    postRemove: text(SCRIPT_ERROR).optional(),
+});
+
+const debSchema = z.strictObject({
+    packageName: text("must be a Debian package name").optional(),
+    section: text("must be a Debian archive section").optional(),
+    priority: text("must be a Debian priority").optional(),
+    compression: z.enum(DEB_COMPRESSIONS, { error: "must be one of gzip, none, xz, zstd" }).optional(),
+    fields: textRecord("must be a control field value", "must be a record of control field names to values")
+        .optional(),
+});
+
+const rpmSchema = z.strictObject({
+    packageName: text("must be an RPM package name").optional(),
+    group: text("must be an RPM group").optional(),
+    compression: z.enum(RPM_COMPRESSIONS, { error: "must be one of gzip, lzma, xz, zstd" }).optional(),
+    prefixes: textList("prefix", "must be an array of relocation prefixes").optional(),
+});
+
+const appimageSchema = z.strictObject({
+    fileName: text("must be an output file name").optional(),
+    compression: z.enum(APPIMAGE_COMPRESSIONS, { error: "must be one of gzip, xz, zstd" }).optional(),
+    updateInformation: text("must be an AppImage update information string").optional(),
+    runtimeFile: text("must be a path to an AppImage runtime file").optional(),
+});
+
+const flatpakSourceSchema = z.strictObject({
+    url: url("must be an absolute git URL").optional(),
+    tag: text("must be a git tag").optional(),
+    commit: text("must be a git commit sha").optional(),
+});
+
+const flatpakSchema = z.strictObject({
+    mode: z.enum(FLATPAK_MODES, { error: 'must be "prebuilt" or "source"' }).optional(),
+    runtime: text("must be a runtime id").optional(),
+    runtimeVersion: text('must be a runtime branch such as "50"').optional(),
+    sdk: text("must be an SDK id").optional(),
+    nodeExtension: text("must be a Node SDK extension id").optional(),
+    sdkExtensions: textList("SDK extension id", "must be an array of SDK extension ids").optional(),
+    base: text("must be a base app id").optional(),
+    baseVersion: text("must be a base app version").optional(),
+    branch: text("must be a branch name").optional(),
+    finishArgs: textList("finish argument", "must be an array of flatpak finish arguments").optional(),
+    cleanup: textList("cleanup pattern", "must be an array of cleanup patterns").optional(),
+    buildCommands: textList("shell command", "must be an array of shell commands").optional(),
+    modules: z.array(z.unknown(), { error: "must be an array of flatpak module objects" }).optional(),
+    source: flatpakSourceSchema.optional(),
+    packageManager: z.enum(PACKAGE_MANAGERS, { error: "must be one of npm, pnpm, yarn" }).optional(),
+    lockfile: text("must be a path to a lockfile").optional(),
+    runtimeRepo: url("must be an absolute .flatpakrepo URL").optional(),
+    shouldEmitBundle: flag(BOOLEAN_ERROR).optional(),
+    shouldInstall: flag(BOOLEAN_ERROR).optional(),
+    shouldUseRofilesFuse: flag(BOOLEAN_ERROR).optional(),
+});
+
+const debSigningSchema = z.strictObject({
+    keyFile: text(KEY_FILE_ERROR),
+    keyId: text(KEY_ID_ERROR).optional(),
+    method: z.enum(DEB_SIGN_METHODS, { error: 'must be "debsign" or "dpkg-sig"' }).optional(),
+    type: z.enum(DEB_SIGN_TYPES, { error: "must be one of archive, maint, origin" }).optional(),
+    signer: text("must be a signer name and email").optional(),
+});
+
+const rpmSigningSchema = z.strictObject({
+    keyFile: text(KEY_FILE_ERROR),
+    keyId: text(KEY_ID_ERROR).optional(),
+});
+
+const flatpakSigningSchema = z.strictObject({
+    gpgKeyId: text("must be a GPG key id"),
+    gpgHomeDir: text("must be a path to a GPG home directory").optional(),
+});
+
+const appimageSigningSchema = z.strictObject({
+    gpgKeyId: text("must be a GPG key id"),
+});
+
+const signingSchema = z.strictObject({
+    appimage: appimageSigningSchema.optional(),
+    deb: debSigningSchema.optional(),
+    flatpak: flatpakSigningSchema.optional(),
+    rpm: rpmSigningSchema.optional(),
+});
+
+const extraRelationsSchema = z.strictObject({
+    recommends: relationsSchema.optional(),
+    suggests: relationsSchema.optional(),
+    provides: relationsSchema.optional(),
+    conflicts: relationsSchema.optional(),
+    replaces: relationsSchema.optional(),
+    breaks: relationsSchema.optional(),
+    preDepends: relationsSchema.optional(),
+});
+
+const deploySchema = z.strictObject({
+    targets: z
+        .array(z.enum(DEPLOY_TARGET_NAMES, { error: "must be one of appimage, deb, flatpak, rpm" }), {
+            error: "must be an array of deploy targets",
+        })
+        .optional(),
+    outDir: text("must be a directory path relative to the project root").optional(),
+    name: text("must be the display name shown in the launcher").optional(),
+    genericName: text("must be a generic application name").optional(),
+    binaryName: text("must be a kebab-case command name").optional(),
+    version: text(VERSION_ERROR).optional(),
+    release: text("must be a packaging revision").optional(),
+    epoch: z.int({ error: EPOCH_ERROR }).min(0, { error: EPOCH_ERROR }).optional(),
+    summary: text("must be a single-line summary without a trailing period").optional(),
+    description: textList("description paragraph", "must be an array of description paragraphs").optional(),
+    keywords: textList("search keyword", "must be an array of search keywords").optional(),
+    categories: textList("freedesktop category", "must be an array of freedesktop categories").optional(),
+    mimeTypes: textList("MIME type", "must be an array of MIME types").optional(),
+    developer: developerSchema.optional(),
+    license: text(SPDX_ERROR).optional(),
+    licenseFile: text("must be a path to a license file").optional(),
+    metadataLicense: text(SPDX_ERROR).optional(),
+    copyright: text("must be a copyright line").optional(),
+    homepage: url(URL_ERROR).optional(),
+    urls: z
+        .partialRecord(z.enum(URL_KINDS), url(URL_ERROR), {
+            error: "must be a record of AppStream url kinds to URLs",
+        })
+        .optional(),
+    icons: text("must be a path to an icon theme directory or a single icon file").optional(),
+    screenshots: z.array(screenshotSchema, { error: "must be an array of screenshots" }).optional(),
+    screenshotBaseUrl: url("must be an absolute base URL").optional(),
+    branding: brandingSchema.optional(),
+    contentRating: z
+        .record(z.string(), z.enum(OARS_INTENSITIES, { error: "must be one of intense, mild, moderate, none" }), {
+            error: "must be a record of OARS 1.1 attribute ids to intensities",
+        })
+        .optional(),
+    releases: z.array(releaseSchema, { error: "must be an array of releases" }).optional(),
+    execArgs: textList("argument", "must be an array of arguments appended to Exec").optional(),
+    fileAssociations: z
+        .array(fileAssociationSchema, { error: "must be an array of file associations" })
+        .optional(),
+    protocols: textList("URL scheme", "must be an array of URL schemes").optional(),
+    desktopActions: z
+        .record(z.string(), desktopActionSchema, { error: "must be a record of action ids to actions" })
+        .optional(),
+    desktopEntry: textRecord("must be a desktop entry value", "must be a record of desktop entry keys to values")
+        .optional(),
+    isDbusActivatable: flag(BOOLEAN_ERROR).optional(),
+    extraFiles: relativePathRecord(
+        "must be a destination path inside the install prefix, without a leading slash or a .. segment",
+        "must be a source path",
+        "must be a record of prefix-relative destinations to source paths",
+    ).optional(),
+    depends: relationsSchema.optional(),
+    relations: extraRelationsSchema.optional(),
+    scripts: scriptsSchema.optional(),
+    node: nodeRuntimeSchema.optional(),
+    signing: signingSchema.optional(),
+    appimage: appimageSchema.optional(),
+    deb: debSchema.optional(),
+    flatpak: flatpakSchema.optional(),
+    rpm: rpmSchema.optional(),
+});
+
+export { deploySchema };

package/src/internal.ts

@@ -1,5 +1,6 @@
 export type { ResolvedReactCompilerOptions } from "./config.ts";
 export {
+    APPLICATION_ID_MAX_LENGTH,
     isValidApplicationId,
     resolveElementComponents,
     resolveElementProps,

package/src/loader.ts

@@ -2,6 +2,7 @@ import { getOrInsert } from "@gtkx/utils";
 import { loadConfig as loadConfigFile } from "c12";
 import { existsSync } from "node:fs";
 import { resolve } from "node:path";
+import { missingConfigFileError } from "./config-error.ts";
 import { type Config, resolveConfig, type ResolvedConfig, validateConfig } from "./config.ts";
 
 /** Result of loading a project's `gtkx.config.ts` file. */
@@ -33,14 +34,16 @@ type ConfigLoader = {
 
 /**
  * Loads and validates the `gtkx.config.ts` file for a project.
- * @param cwd Directory the configuration file is looked up in.
+ * @param cwd Directory the configuration file is looked up in; parent directories are not searched.
  * @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.
+ * @throws When that directory holds no configuration file, or when the configuration fails validation.
  */
 const loadConfig = async (cwd: string, options: LoadConfigOptions = {}): Promise<LoadedConfig> => {
+    const searched = resolve(cwd);
+
     const result = await loadConfigFile<Config>({
         name: "gtkx",
-        cwd,
+        cwd: searched,
         rcFile: false,
         globalRc: false,
         packageJson: false,
@@ -48,18 +51,19 @@ const loadConfig = async (cwd: string, options: LoadConfigOptions = {}): Promise
         ...((options.mode !== undefined) && { envName: options.mode }),
     });
 
-    const config = result.config;
     const configFile = result.configFile;
-    validateConfig(config);
 
-    if (configFile === undefined || !existsSync(resolve(cwd, configFile))) {
-        throw new Error(`gtkx.config.ts: no configuration file was found from ${cwd}`);
+    if (configFile === undefined || !existsSync(resolve(searched, configFile))) {
+        throw missingConfigFileError(searched);
     }
 
+    const config = result.config;
+    validateConfig(config);
+
     return {
         config,
         configFile,
-        root: result.cwd ?? cwd,
+        root: result.cwd ?? searched,
     };
 };