@saykit/config 0.4.1 → 0.5.0

package/dist/commands/index.cjs

@@ -1,7 +1,6 @@
 #!/usr/bin/env node
-require("../chunk-CKQMccvm.cjs");
-const require_storage = require("../storage-wS6e6qWM.cjs");
-const require_loader = require("../loader-DATEQsXj.cjs");
+const require_storage = require("../storage-DqhzA5H8.cjs");
+const require_loader = require("../loader-A1uS7qkK.cjs");
 let _commander_js_extra_typings = require("@commander-js/extra-typings");
 let node_fs_promises = require("node:fs/promises");
 let node_path = require("node:path");
@@ -145,7 +144,7 @@ function exists(path) {
 var BucketExtractWorker = class extends BucketWorker {
 	#indexedMessagesByPath = /* @__PURE__ */ new Map();
 	get #indexedMessages() {
-		return Array.from(this.#indexedMessagesByPath.values()).flat();
+		return [...this.bucket.messages, ...Array.from(this.#indexedMessagesByPath.values()).flat()];
 	}
 	async #indexPath(path) {
 		const relativePath = normalisePathForLogs(path);
@@ -167,8 +166,10 @@ var BucketExtractWorker = class extends BucketWorker {
 		this.logger.info(`Scanning bucket: ${this.bucket.include}`);
 		const paths = await globBucket(this.bucket);
 		this.logger.step(`Found ${paths.length} file(s)`);
+		if (this.bucket.messages.length) this.logger.step(`Including ${this.bucket.messages.length} message(s) declared in the config`);
 		await Promise.all(paths.map((p) => this.#indexPath(p)));
-		this.logger.info(`Total extracted messages: ${this.#indexedMessages.length}`);
+		const extracted = Array.from(this.#indexedMessagesByPath.values()).flat().length;
+		this.logger.info(`Total extracted messages: ${extracted}`);
 	}
 	async write() {
 		const mergedMessages = require_storage.mergeExtractedMessages(this.#indexedMessages);

package/dist/commands/index.d.cts

@@ -1 +1 @@
-export { };
+export {}

package/dist/commands/index.d.mts

@@ -1 +1 @@
-export { };
+export {}

package/dist/commands/index.mjs

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
-import { a as mergeExtractedMessages, i as expandBucketOutputPath, n as writeCatalogueMessages, o as pruneLocaleMessages, t as readCatalogueMessages } from "../storage-CqKPYfCR.mjs";
-import { t as resolveConfig } from "../loader-BuAqYtfl.mjs";
+import { a as mergeExtractedMessages, i as expandBucketOutputPath, n as writeCatalogueMessages, o as pruneLocaleMessages, t as readCatalogueMessages } from "../storage-B6mn0s3V.mjs";
+import { t as resolveConfig } from "../loader-DLyuZzF2.mjs";
 import { Command, program } from "@commander-js/extra-typings";
 import { access, glob, readFile, stat, watch } from "node:fs/promises";
 import { join, relative } from "node:path";
@@ -144,7 +144,7 @@ function exists(path) {
 var BucketExtractWorker = class extends BucketWorker {
 	#indexedMessagesByPath = /* @__PURE__ */ new Map();
 	get #indexedMessages() {
-		return Array.from(this.#indexedMessagesByPath.values()).flat();
+		return [...this.bucket.messages, ...Array.from(this.#indexedMessagesByPath.values()).flat()];
 	}
 	async #indexPath(path) {
 		const relativePath = normalisePathForLogs(path);
@@ -166,8 +166,10 @@ var BucketExtractWorker = class extends BucketWorker {
 		this.logger.info(`Scanning bucket: ${this.bucket.include}`);
 		const paths = await globBucket(this.bucket);
 		this.logger.step(`Found ${paths.length} file(s)`);
+		if (this.bucket.messages.length) this.logger.step(`Including ${this.bucket.messages.length} message(s) declared in the config`);
 		await Promise.all(paths.map((p) => this.#indexPath(p)));
-		this.logger.info(`Total extracted messages: ${this.#indexedMessages.length}`);
+		const extracted = Array.from(this.#indexedMessagesByPath.values()).flat().length;
+		this.logger.info(`Total extracted messages: ${extracted}`);
 	}
 	async write() {
 		const mergedMessages = mergeExtractedMessages(this.#indexedMessages);

package/dist/features/catalogue/index.cjs

@@ -1,7 +1,6 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-require("../../chunk-CKQMccvm.cjs");
-const require_hash = require("../../hash-CxBlj5Dz.cjs");
-const require_storage = require("../../storage-wS6e6qWM.cjs");
+const require_hash = require("../../hash-51ce8YiG.cjs");
+const require_storage = require("../../storage-DqhzA5H8.cjs");
 let node_path = require("node:path");
 //#region src/features/catalogue/record.ts
 /**
@@ -13,7 +12,7 @@ function resolveFallbackChain(config, locale) {
 	const source = config.locales[0];
 	const configured = config.fallbackLocales?.[locale];
 	const fallbacks = configured ? Array.isArray(configured) ? configured : [configured] : [];
-	return Array.from(new Set([
+	return Array.from(/* @__PURE__ */ new Set([
 		locale,
 		...fallbacks,
 		source

package/dist/features/catalogue/index.d.cts

@@ -1,5 +1,4 @@
-import { i as Message, n as Config, t as Bucket } from "../../shapes-Ba3xS10n.cjs";
-
+import { a as Message, n as Config, t as Bucket } from "../../shapes-CRlXtss0.cjs";
 //#region src/features/catalogue/merge.d.ts
 declare function mergeExtractedMessages(messages: Message[]): {
   message: string;

package/dist/features/catalogue/index.d.mts

@@ -1,5 +1,4 @@
-import { i as Message, n as Config, t as Bucket } from "../../shapes-NPfwlInG.mjs";
-
+import { a as Message, n as Config, t as Bucket } from "../../shapes-CRlXtss0.mjs";
 //#region src/features/catalogue/merge.d.ts
 declare function mergeExtractedMessages(messages: Message[]): {
   message: string;

package/dist/features/catalogue/index.mjs

@@ -1,5 +1,5 @@
-import { t as generateHash } from "../../hash-DyC8GzMa.mjs";
-import { a as mergeExtractedMessages, i as expandBucketOutputPath, n as writeCatalogueMessages, o as pruneLocaleMessages, r as declarationPathFor, t as readCatalogueMessages } from "../../storage-CqKPYfCR.mjs";
+import { t as generateHash } from "../../hash-DvzpieJD.mjs";
+import { a as mergeExtractedMessages, i as expandBucketOutputPath, n as writeCatalogueMessages, o as pruneLocaleMessages, r as declarationPathFor, t as readCatalogueMessages } from "../../storage-B6mn0s3V.mjs";
 import { resolve } from "node:path";
 //#region src/features/catalogue/record.ts
 /**
@@ -11,7 +11,7 @@ function resolveFallbackChain(config, locale) {
 	const source = config.locales[0];
 	const configured = config.fallbackLocales?.[locale];
 	const fallbacks = configured ? Array.isArray(configured) ? configured : [configured] : [];
-	return Array.from(new Set([
+	return Array.from(/* @__PURE__ */ new Set([
 		locale,
 		...fallbacks,
 		source

package/dist/features/loader/index.cjs

@@ -1,3 +1,3 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_loader = require("../../loader-DATEQsXj.cjs");
+const require_loader = require("../../loader-A1uS7qkK.cjs");
 exports.resolveConfig = require_loader.resolveConfig;

package/dist/features/loader/index.d.cts

@@ -1,5 +1,4 @@
-import { n as Config } from "../../shapes-Ba3xS10n.cjs";
-
+import { n as Config } from "../../shapes-CRlXtss0.cjs";
 //#region src/features/loader/resolve.d.ts
 declare function resolveConfig(name?: string): Config;
 //#endregion

package/dist/features/loader/index.d.mts

@@ -1,5 +1,4 @@
-import { n as Config } from "../../shapes-NPfwlInG.mjs";
-
+import { n as Config } from "../../shapes-CRlXtss0.mjs";
 //#region src/features/loader/resolve.d.ts
 declare function resolveConfig(name?: string): Config;
 //#endregion

package/dist/features/loader/index.mjs

@@ -1,2 +1,2 @@
-import { t as resolveConfig } from "../../loader-BuAqYtfl.mjs";
+import { t as resolveConfig } from "../../loader-DLyuZzF2.mjs";
 export { resolveConfig };

package/dist/features/messages/index.cjs

@@ -1,5 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_hash = require("../../hash-CxBlj5Dz.cjs");
+const require_hash = require("../../hash-51ce8YiG.cjs");
 //#region src/features/messages/identifier.ts
 const AUTO_INCREMENT_IDENTIFIER = Symbol("auto-increment");
 function assignSequenceIdentifiers(message, sequence = { current: 0 }) {
@@ -24,12 +24,15 @@ var Base = class {
 	}
 };
 var LiteralMessage = class extends Base {
+	text;
 	constructor(text) {
 		super();
 		this.text = text;
 	}
 };
 var ArgumentMessage = class extends Base {
+	identifier;
+	expression;
 	constructor(identifier, expression) {
 		super();
 		this.identifier = identifier;
@@ -37,6 +40,9 @@ var ArgumentMessage = class extends Base {
 	}
 };
 var ElementMessage = class extends Base {
+	identifier;
+	children;
+	expression;
 	constructor(identifier, children, expression) {
 		super();
 		this.identifier = identifier;
@@ -45,6 +51,10 @@ var ElementMessage = class extends Base {
 	}
 };
 var ChoiceMessage = class extends Base {
+	kind;
+	identifier;
+	branches;
+	expression;
 	constructor(kind, identifier, branches, expression) {
 		super();
 		this.kind = kind;
@@ -54,6 +64,12 @@ var ChoiceMessage = class extends Base {
 	}
 };
 var CompositeMessage = class extends Base {
+	descriptor;
+	comments;
+	references;
+	children;
+	accessor;
+	whitespace;
 	constructor(descriptor, comments, references, children, accessor, whitespace) {
 		super();
 		this.descriptor = descriptor;

package/dist/features/messages/index.mjs

@@ -1,4 +1,4 @@
-import { t as generateHash } from "../../hash-DyC8GzMa.mjs";
+import { t as generateHash } from "../../hash-DvzpieJD.mjs";
 //#region src/features/messages/identifier.ts
 const AUTO_INCREMENT_IDENTIFIER = Symbol("auto-increment");
 function assignSequenceIdentifiers(message, sequence = { current: 0 }) {
@@ -23,12 +23,15 @@ var Base = class {
 	}
 };
 var LiteralMessage = class extends Base {
+	text;
 	constructor(text) {
 		super();
 		this.text = text;
 	}
 };
 var ArgumentMessage = class extends Base {
+	identifier;
+	expression;
 	constructor(identifier, expression) {
 		super();
 		this.identifier = identifier;
@@ -36,6 +39,9 @@ var ArgumentMessage = class extends Base {
 	}
 };
 var ElementMessage = class extends Base {
+	identifier;
+	children;
+	expression;
 	constructor(identifier, children, expression) {
 		super();
 		this.identifier = identifier;
@@ -44,6 +50,10 @@ var ElementMessage = class extends Base {
 	}
 };
 var ChoiceMessage = class extends Base {
+	kind;
+	identifier;
+	branches;
+	expression;
 	constructor(kind, identifier, branches, expression) {
 		super();
 		this.kind = kind;
@@ -53,6 +63,12 @@ var ChoiceMessage = class extends Base {
 	}
 };
 var CompositeMessage = class extends Base {
+	descriptor;
+	comments;
+	references;
+	children;
+	accessor;
+	whitespace;
 	constructor(descriptor, comments, references, children, accessor, whitespace) {
 		super();
 		this.descriptor = descriptor;

package/dist/{hash-CxBlj5Dz.cjs → hash-51ce8YiG.cjs}

@@ -1,4 +1,3 @@
-require("./chunk-CKQMccvm.cjs");
 let js_sha256 = require("js-sha256");
 //#region src/features/messages/hash.ts
 function generateHash(input, context) {

package/dist/index.cjs

@@ -1,9 +1,30 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_chunk = require("./chunk-CKQMccvm.cjs");
+//#region \0rolldown/runtime.js
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+	if (from && typeof from === "object" || typeof from === "function") for (var keys = __getOwnPropNames(from), i = 0, n = keys.length, key; i < n; i++) {
+		key = keys[i];
+		if (!__hasOwnProp.call(to, key) && key !== except) __defProp(to, key, {
+			get: ((k) => from[k]).bind(null, key),
+			enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+		});
+	}
+	return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", {
+	value: mod,
+	enumerable: true
+}) : target, mod));
+//#endregion
 let picomatch = require("picomatch");
-picomatch = require_chunk.__toESM(picomatch, 1);
+picomatch = __toESM(picomatch, 1);
 let zod = require("zod");
-zod = require_chunk.__toESM(zod, 1);
+zod = __toESM(zod, 1);
 zod.object({
 	message: zod.string(),
 	translation: zod.string().optional(),
@@ -22,6 +43,16 @@ const Transformer = zod.object({
 	extract: zod.custom((v) => typeof v === "function"),
 	transform: zod.custom((v) => typeof v === "function")
 });
+/**
+* A message declared in the config rather than found in source. The shorthand
+* is the source string; the object form adds the metadata a descriptor would
+* otherwise carry.
+*/
+const DeclaredMessage = zod.string().or(zod.object({
+	message: zod.string(),
+	context: zod.string().optional(),
+	comments: zod.string().array().optional()
+}));
 const Bucket = zod.object({
 	include: zod.string().array(),
 	exclude: zod.string().array().optional(),
@@ -31,6 +62,14 @@ const Bucket = zod.object({
 		zod.string(),
 		".{extension}"
 	]),
+	/**
+	* Messages that belong in the catalogue but have no call site to extract
+	* them from — strings owned by a non-JavaScript artefact such as a manifest,
+	* a store listing, or an email subject. Keyed by id, so the id is stable and
+	* hand-written by definition, and merged into every extraction alongside
+	* whatever the transformers find.
+	*/
+	messages: zod.record(zod.string(), DeclaredMessage).optional(),
 	formatter: Formatter,
 	transformer: Transformer.transform((t) => [t]).or(Transformer.array()).transform((t) => ({
 		match: (id) => t.some((t) => t.match(id)),
@@ -39,6 +78,17 @@ const Bucket = zod.object({
 	}))
 }).transform((v) => ({
 	...v,
+	messages: Object.entries(v.messages ?? {}).map(([id, declared]) => {
+		const entry = typeof declared === "string" ? { message: declared } : declared;
+		return {
+			id,
+			message: entry.message,
+			translation: entry.message,
+			context: "context" in entry ? entry.context : void 0,
+			comments: ("comments" in entry ? entry.comments : void 0) ?? [],
+			references: []
+		};
+	}),
 	match: (0, picomatch.default)(v.include, { ignore: v.exclude }),
 	output: Object.assign(v.output, { match: (0, picomatch.default)(v.output.replace("{locale}", "*").replace("{extension}", v.formatter.extension.slice(1))) })
 }));

package/dist/index.d.cts

@@ -1,14 +1,20 @@
-import { a as Transformer, i as Message, n as Config, r as Formatter, t as Bucket } from "./shapes-Ba3xS10n.cjs";
+import { a as Message, i as Formatter, n as Config, o as Transformer, r as DeclaredMessage, t as Bucket } from "./shapes-CRlXtss0.cjs";
 import { input } from "zod";
-import * as _$picomatch_lib_picomatch_js0 from "picomatch/lib/picomatch.js";
-
 //#region src/index.d.ts
 declare function defineConfig<C extends input<typeof Config>>(config: C): {
   locales: [string, ...string[]];
   buckets: {
+    messages: {
+      message: string;
+      comments: string[];
+      references: string[];
+      translation?: string | undefined;
+      id?: string | undefined;
+      context?: string | undefined;
+    }[];
     match: (id: string) => boolean;
     output: `${string}{locale}${string}.{extension}` & {
-      match: _$picomatch_lib_picomatch_js0.Matcher;
+      match: import("picomatch/lib/picomatch.js").Matcher;
     };
     include: string[];
     formatter: {
@@ -36,4 +42,4 @@ declare function defineConfig<C extends input<typeof Config>>(config: C): {
   fallbackLocales?: Record<string, string | string[]> | undefined;
 };
 //#endregion
-export { Bucket, Config, Formatter, Message, Transformer, defineConfig };
+export { type Bucket, type Config, type DeclaredMessage, type Formatter, type Message, type Transformer, defineConfig };

package/dist/index.d.mts

@@ -1,14 +1,20 @@
-import { a as Transformer, i as Message, n as Config, r as Formatter, t as Bucket } from "./shapes-NPfwlInG.mjs";
+import { a as Message, i as Formatter, n as Config, o as Transformer, r as DeclaredMessage, t as Bucket } from "./shapes-CRlXtss0.mjs";
 import { input } from "zod";
-import * as _$picomatch_lib_picomatch_js0 from "picomatch/lib/picomatch.js";
-
 //#region src/index.d.ts
 declare function defineConfig<C extends input<typeof Config>>(config: C): {
   locales: [string, ...string[]];
   buckets: {
+    messages: {
+      message: string;
+      comments: string[];
+      references: string[];
+      translation?: string | undefined;
+      id?: string | undefined;
+      context?: string | undefined;
+    }[];
     match: (id: string) => boolean;
     output: `${string}{locale}${string}.{extension}` & {
-      match: _$picomatch_lib_picomatch_js0.Matcher;
+      match: import("picomatch/lib/picomatch.js").Matcher;
     };
     include: string[];
     formatter: {
@@ -36,4 +42,4 @@ declare function defineConfig<C extends input<typeof Config>>(config: C): {
   fallbackLocales?: Record<string, string | string[]> | undefined;
 };
 //#endregion
-export { Bucket, Config, Formatter, Message, Transformer, defineConfig };
+export { type Bucket, type Config, type DeclaredMessage, type Formatter, type Message, type Transformer, defineConfig };

package/dist/index.mjs

@@ -18,6 +18,16 @@ const Transformer = z.object({
 	extract: z.custom((v) => typeof v === "function"),
 	transform: z.custom((v) => typeof v === "function")
 });
+/**
+* A message declared in the config rather than found in source. The shorthand
+* is the source string; the object form adds the metadata a descriptor would
+* otherwise carry.
+*/
+const DeclaredMessage = z.string().or(z.object({
+	message: z.string(),
+	context: z.string().optional(),
+	comments: z.string().array().optional()
+}));
 const Bucket = z.object({
 	include: z.string().array(),
 	exclude: z.string().array().optional(),
@@ -27,6 +37,14 @@ const Bucket = z.object({
 		z.string(),
 		".{extension}"
 	]),
+	/**
+	* Messages that belong in the catalogue but have no call site to extract
+	* them from — strings owned by a non-JavaScript artefact such as a manifest,
+	* a store listing, or an email subject. Keyed by id, so the id is stable and
+	* hand-written by definition, and merged into every extraction alongside
+	* whatever the transformers find.
+	*/
+	messages: z.record(z.string(), DeclaredMessage).optional(),
 	formatter: Formatter,
 	transformer: Transformer.transform((t) => [t]).or(Transformer.array()).transform((t) => ({
 		match: (id) => t.some((t) => t.match(id)),
@@ -35,6 +53,17 @@ const Bucket = z.object({
 	}))
 }).transform((v) => ({
 	...v,
+	messages: Object.entries(v.messages ?? {}).map(([id, declared]) => {
+		const entry = typeof declared === "string" ? { message: declared } : declared;
+		return {
+			id,
+			message: entry.message,
+			translation: entry.message,
+			context: "context" in entry ? entry.context : void 0,
+			comments: ("comments" in entry ? entry.comments : void 0) ?? [],
+			references: []
+		};
+	}),
 	match: picomatch(v.include, { ignore: v.exclude }),
 	output: Object.assign(v.output, { match: picomatch(v.output.replace("{locale}", "*").replace("{extension}", v.formatter.extension.slice(1))) })
 }));

package/dist/loader-A1uS7qkK.cjs

@@ -0,0 +1,92 @@
+let node_path = require("node:path");
+let node_fs = require("node:fs");
+let node_module = require("node:module");
+//#region src/features/loader/files.ts
+const SUPPORTED_CONFIG_FILES = [
+	"saykit.config.js",
+	"saykit.config.cjs",
+	"saykit.config.mjs",
+	"saykit.config.ts",
+	"saykit.config.mts",
+	"saykit.config.cts"
+];
+function getConfigFileCandidates(name) {
+	return SUPPORTED_CONFIG_FILES.map((file) => file.replace("saykit", name));
+}
+function findConfigFile(moduleName, projectDir) {
+	for (const fileName of getConfigFileCandidates(moduleName)) {
+		const id = (0, node_path.join)(projectDir, fileName);
+		if ((0, node_fs.existsSync)(id)) return { id };
+	}
+	return null;
+}
+//#endregion
+//#region src/features/loader/module.ts
+/** Requires `path` without leaving it in (or reading it from) the require cache. */
+function requireFresh(require, path) {
+	const resolved = require.resolve(path);
+	delete require.cache[resolved];
+	const module = require(path);
+	delete require.cache[resolved];
+	return module?.default ?? module;
+}
+const TYPESCRIPT = /* @__PURE__ */ new Set([
+	".ts",
+	".mts",
+	".cts"
+]);
+/**
+* Adds what the runtime cannot: why a config it could not read is one it will
+* never read. Everything else is the config's own problem, and its error
+* already describes that better than we could.
+*/
+function diagnose(error, path) {
+	const code = error?.code;
+	if (code === "ERR_UNSUPPORTED_TYPESCRIPT_SYNTAX") return "Enums, namespaces and parameter properties are not erasable, so no runtime will read them.";
+	if (code === "ERR_REQUIRE_ASYNC_MODULE") return "The config is loaded synchronously, so it cannot use top-level await.";
+	if ((code === "ERR_UNKNOWN_FILE_EXTENSION" || !code && error instanceof SyntaxError) && TYPESCRIPT.has((0, node_path.extname)(path).toLowerCase())) return "Reading this config needs Node 22.18+, or a runtime that loads TypeScript itself (Bun, Deno, tsx).";
+	return null;
+}
+/**
+* Loads a config file as it sits on disk, leaving the runtime to deal with the
+* extension. Nothing is copied or rewritten, so `__dirname`,
+* `import.meta.dirname`, relative specifiers and `require.resolve` all resolve
+* against the config's own directory.
+*/
+function loadModule(path) {
+	try {
+		return requireFresh((0, node_module.createRequire)(path), path);
+	} catch (error) {
+		const hint = diagnose(error, path);
+		throw new Error(hint ? `Failed to import module. ${hint}` : "Failed to import module", { cause: error });
+	}
+}
+const js = loadModule;
+const ts = loadModule;
+const configLoaders = Object.freeze({
+	".js": js,
+	".mjs": js,
+	".cjs": js,
+	".ts": ts,
+	".mts": ts,
+	".cts": ts
+});
+//#endregion
+//#region src/features/loader/resolve.ts
+function resolveConfig(name = "saykit") {
+	const file = findConfigFile(name, process.cwd());
+	if (!file) throw new Error(`Could not find config file for "${name}"`);
+	const ext = (0, node_path.extname)(file.id).toLowerCase();
+	const load = ext in configLoaders ? configLoaders[ext] : null;
+	if (!load) throw new Error(`Unsupported config file type "${ext}" for "${name}"`);
+	const config = load(file.id);
+	if (!config || typeof config !== "object") throw new Error(`Invalid config file for "${name}"`);
+	return config;
+}
+//#endregion
+Object.defineProperty(exports, "resolveConfig", {
+	enumerable: true,
+	get: function() {
+		return resolveConfig;
+	}
+});

package/dist/loader-DLyuZzF2.mjs

@@ -0,0 +1,87 @@
+import { createRequire } from "node:module";
+import { extname, join } from "node:path";
+import { existsSync } from "node:fs";
+//#region src/features/loader/files.ts
+const SUPPORTED_CONFIG_FILES = [
+	"saykit.config.js",
+	"saykit.config.cjs",
+	"saykit.config.mjs",
+	"saykit.config.ts",
+	"saykit.config.mts",
+	"saykit.config.cts"
+];
+function getConfigFileCandidates(name) {
+	return SUPPORTED_CONFIG_FILES.map((file) => file.replace("saykit", name));
+}
+function findConfigFile(moduleName, projectDir) {
+	for (const fileName of getConfigFileCandidates(moduleName)) {
+		const id = join(projectDir, fileName);
+		if (existsSync(id)) return { id };
+	}
+	return null;
+}
+//#endregion
+//#region src/features/loader/module.ts
+/** Requires `path` without leaving it in (or reading it from) the require cache. */
+function requireFresh(require, path) {
+	const resolved = require.resolve(path);
+	delete require.cache[resolved];
+	const module = require(path);
+	delete require.cache[resolved];
+	return module?.default ?? module;
+}
+const TYPESCRIPT = /* @__PURE__ */ new Set([
+	".ts",
+	".mts",
+	".cts"
+]);
+/**
+* Adds what the runtime cannot: why a config it could not read is one it will
+* never read. Everything else is the config's own problem, and its error
+* already describes that better than we could.
+*/
+function diagnose(error, path) {
+	const code = error?.code;
+	if (code === "ERR_UNSUPPORTED_TYPESCRIPT_SYNTAX") return "Enums, namespaces and parameter properties are not erasable, so no runtime will read them.";
+	if (code === "ERR_REQUIRE_ASYNC_MODULE") return "The config is loaded synchronously, so it cannot use top-level await.";
+	if ((code === "ERR_UNKNOWN_FILE_EXTENSION" || !code && error instanceof SyntaxError) && TYPESCRIPT.has(extname(path).toLowerCase())) return "Reading this config needs Node 22.18+, or a runtime that loads TypeScript itself (Bun, Deno, tsx).";
+	return null;
+}
+/**
+* Loads a config file as it sits on disk, leaving the runtime to deal with the
+* extension. Nothing is copied or rewritten, so `__dirname`,
+* `import.meta.dirname`, relative specifiers and `require.resolve` all resolve
+* against the config's own directory.
+*/
+function loadModule(path) {
+	try {
+		return requireFresh(createRequire(path), path);
+	} catch (error) {
+		const hint = diagnose(error, path);
+		throw new Error(hint ? `Failed to import module. ${hint}` : "Failed to import module", { cause: error });
+	}
+}
+const js = loadModule;
+const ts = loadModule;
+const configLoaders = Object.freeze({
+	".js": js,
+	".mjs": js,
+	".cjs": js,
+	".ts": ts,
+	".mts": ts,
+	".cts": ts
+});
+//#endregion
+//#region src/features/loader/resolve.ts
+function resolveConfig(name = "saykit") {
+	const file = findConfigFile(name, process.cwd());
+	if (!file) throw new Error(`Could not find config file for "${name}"`);
+	const ext = extname(file.id).toLowerCase();
+	const load = ext in configLoaders ? configLoaders[ext] : null;
+	if (!load) throw new Error(`Unsupported config file type "${ext}" for "${name}"`);
+	const config = load(file.id);
+	if (!config || typeof config !== "object") throw new Error(`Invalid config file for "${name}"`);
+	return config;
+}
+//#endregion
+export { resolveConfig as t };