tyfigo 0.2.0-next.a30eb96.0 → 0.2.0

package/README.md

@@ -121,6 +121,11 @@ config/app.production.config.yaml(7,20): error TS2322: Type 'number' is not assi
 src/main.ts(3,7): error TS2322: Type 'number' is not assignable to type 'string'.
 ```
 
+Without a schema, the types are strict and widened: an environment file can't add a key (so there are no optional sections),
+`logLevel: info` is `string` rather than `'info' | 'debug'`, a placeholder without a default is `string`, and a `loadConfig`
+mismatch is reported at the call rather than on the YAML line. A schema handles each of these; see
+[What tsc checks without a schema](https://tyfigo.vercel.app/docs/type-checking#what-tsc-checks-without-a-schema).
+
 `database.url` has no default, so set `DATABASE_URL` (in `.env` or the environment) before you run the example. Without it, the import fails
 with `Environment variable 'DATABASE_URL' is not set (missing-variable)`.
 
@@ -173,9 +178,12 @@ const env = loadEnv(z.object({ NODE_ENV: z.enum(['development', 'production', 't
 | Jest                         | `'tyfigo/jest'` as the `transform` for config files, with their extensions in `moduleFileExtensions` | [jest](https://github.com/imranbarbhuiya/tyfigo/tree/main/examples/jest)       |
 
 Browser builds get the base and environment files inlined, and a `${VAR}` placeholder or an import of `loadEnv` in a client bundle
-fails the build. Server bundles fix the environment when they build: they inline the base, environment and local files, ignore
-`NODE_ENV` at run time for picking layers, and read `.env` files and environment variables when they start. See
-[Browser builds](https://tyfigo.vercel.app/docs/browser-builds).
+fails the build. Server bundles are built once and deployed anywhere: they inline the base, local and every environment's
+files, pick the layers by `NODE_ENV` when they start (unless the plugin's `environment` option fixes it), and read `.env` files
+and environment variables then. See [Server bundles](https://tyfigo.vercel.app/docs/browser-builds#server-bundles).
+
+`next build` can't pass `--runExternalCode` to its type check, so `withTyfigo` turns Next's check off and runs
+`tsc --noEmit --runExternalCode` itself after the compile. See [Next.js](https://tyfigo.vercel.app/docs/bundlers/next).
 
 ## Formats
 
@@ -191,10 +199,26 @@ tyfigo reads seven formats under eight suffixes, since YAML takes both `.config.
 | `.config.properties`          | `.properties` |
 | `.config.xml`                 | XML           |
 
+Plain `.json` isn't supported: it's a built-in TypeScript extension, so no content mapper can claim `.json`, `.config.json` or
+`.config/<name>.json` (tsc reports `TS18066`). Rename the file to `.config.jsonc`; every JSON file is valid JSONC.
+
+### A `.config` directory
+
+Config files can also live in a `.config` folder with plain extensions: `.config/app.yaml` is a base file and
+`.config/app.production.yaml`, `.config/app.local.yaml` and `.config/app.production.local.yaml` are its layers. Every runtime and
+bundler loads them by path with no setup, and `.yaml` files elsewhere are left alone. `.env` files are read from the folder
+that contains `.config`.
+
+Type-checking them is opt-in: add the plain extensions you use to tyfigo's `extensions` (`".yaml"` next to the `.config.*`
+suffixes) and include `".config/*"`. tyfigo then owns that extension, so it can't be combined with another mapper (such as
+Motherload) for it, and every other `.yaml` file is typed as plain data, with no layers or placeholders. See
+[A `.config` directory](https://tyfigo.vercel.app/docs/config-files#a-config-directory) and the
+[config-dir example](https://github.com/imranbarbhuiya/tyfigo/tree/main/examples/config-dir).
+
 ## tyfigo and Motherload
 
 [Motherload](https://motherload.dev) also imports data files through TypeScript 7.1 content mappers, but it is a general data
-loader: import any `.yaml`, `.toml`, `.csv`, `.md` or other data file and get its contents, typed as `as const` would type them. tyfigo only claims `*.config.*` files and is for the settings your app reads at start-up: widened
+loader: import any `.yaml`, `.toml`, `.csv`, `.md` or other data file and get its contents, typed as `as const` would type them. tyfigo claims `*.config.*` files (and, opt-in, a `.config` folder) and is for the settings your app reads at start-up: widened
 types, layered environment files checked against the base, placeholders and schema validation. They can share a project,
 since TypeScript gives each extension one owner and the longest suffix wins, so tyfigo can own `.config.yaml` while
 Motherload owns `.yaml`. See [tyfigo and Motherload](https://tyfigo.vercel.app/docs#tyfigo-and-motherload).

package/dist/bun.d.mts

@@ -1,7 +1,14 @@
 import { BunPlugin } from "bun";
+export interface TyfigoBunOptions {
+  /**
+   * The environment name. Defaults to `NODE_ENV`, read when the config loads, or when a server `Bun.build` bundle starts.
+   * Setting it fixes the environment of a server bundle.
+   */
+  readonly environment?: string | undefined;
+}
 /**
  * The tyfigo Bun plugin. Importing `tyfigo/bun` (a `bunfig.toml` `preload`) registers it for the runtime and `bun test`; pass
  * `tyfigo()` in `plugins` to use it with `Bun.build`, where a `browser` target inlines the config and a server target inlines the config files and reads `.env` files when it runs.
  */
-export declare const tyfigo: () => BunPlugin;
+export declare const tyfigo: (options?: TyfigoBunOptions) => BunPlugin;
 //# sourceMappingURL=bun.d.mts.map

package/dist/bun.mjs

@@ -1,26 +1,26 @@
-import { n as formatProblems } from "./problems-BNAqmOzL.mjs";
-import { t as configSuffixes } from "./formats-D_dKXoPf.mjs";
-import { t as load } from "./load-DxIjRpX6.mjs";
+import { n as formatProblems } from "./problems-DS_eJB6e.mjs";
+import { n as configPathPattern } from "./formats-Bf8-iQw-.mjs";
+import { t as load } from "./load-yFCdP4to.mjs";
 import { extname } from "node:path";
 import { fileURLToPath } from "node:url";
 import { plugin } from "bun";
 // src/bun.ts
 const runtime = fileURLToPath(new URL(`runtime/index${extname(import.meta.url)}`, import.meta.url));
-const filter = new RegExp(`[^/\\\\](?:${configSuffixes.map((suffix) => suffix.replaceAll(".", "\\.")).join("|")})$`);
 /**
 * The tyfigo Bun plugin. Importing `tyfigo/bun` (a `bunfig.toml` `preload`) registers it for the runtime and `bun test`; pass
 * `tyfigo()` in `plugins` to use it with `Bun.build`, where a `browser` target inlines the config and a server target inlines the config files and reads `.env` files when it runs.
 */
-const tyfigo = () => ({
+const tyfigo = (options = {}) => ({
 	name: "tyfigo",
 	setup(build) {
 		const config = build.config;
 		const target = config?.target === "browser" ? "browser" : "server";
-		build.onLoad({ filter }, ({ path }) => {
+		build.onLoad({ filter: configPathPattern }, ({ path }) => {
 			const result = load(path, {
 				target,
 				runtime,
-				bundle: config !== void 0
+				bundle: config !== void 0,
+				environment: options.environment
 			});
 			if (result.problems.length > 0) throw new Error(`Invalid config ${path}\n${formatProblems(result.problems)}`);
 			return {

package/dist/bun.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"bun.mjs","names":[],"sources":["../src/bun.ts"],"sourcesContent":["import { extname } from 'node:path';\nimport { fileURLToPath } from 'node:url';\n\nimport { plugin } from 'bun';\n\nimport { configSuffixes, formatProblems } from './core/index.ts';\nimport { load } from './runtime/index.ts';\n\nimport type { BunPlugin } from 'bun';\n\n// The runtime next to this module, so it resolves from config files outside the dependency tree: `.ts` in this repo, `.mjs` once built.\nconst runtime = fileURLToPath(new URL(`runtime/index${extname(import.meta.url)}`, import.meta.url));\n\nconst filter = new RegExp(`[^/\\\\\\\\](?:${configSuffixes.map((suffix) => suffix.replaceAll('.', '\\\\.')).join('|')})$`);\n\n/**\n * The tyfigo Bun plugin. Importing `tyfigo/bun` (a `bunfig.toml` `preload`) registers it for the runtime and `bun test`; pass\n * `tyfigo()` in `plugins` to use it with `Bun.build`, where a `browser` target inlines the config and a server target inlines the config files and reads `.env` files when it runs.\n */\nexport const tyfigo = (): BunPlugin => ({\n\tname: 'tyfigo',\n\tsetup(build) {\n\t\tconst config = build.config as typeof build.config | undefined;\n\t\tconst target = config?.target === 'browser' ? 'browser' : 'server';\n\t\tbuild.onLoad({ filter }, ({ path }) => {\n\t\t\tconst result = load(path, { target, runtime, bundle: config !== undefined });\n\t\t\tif (result.problems.length > 0) {\n\t\t\t\tthrow new Error(`Invalid config ${path}\\n${formatProblems(result.problems)}`);\n\t\t\t}\n\t\t\treturn { contents: result.code, loader: 'js' };\n\t\t});\n\t},\n});\n\nvoid plugin(tyfigo());\n"],"mappings":";;;;;;;AAWA,MAAM,UAAU,cAAc,IAAI,IAAI,gBAAgB,QAAQ,YAAY,GAAG,KAAK,YAAY,GAAG,CAAC;AAElG,MAAM,SAAS,IAAI,OAAO,cAAc,eAAe,KAAK,WAAW,OAAO,WAAW,KAAK,KAAK,CAAC,CAAC,CAAC,KAAK,GAAG,EAAE,GAAG;;;;;AAMnH,MAAa,gBAA2B;CACvC,MAAM;CACN,MAAM,OAAO;EACZ,MAAM,SAAS,MAAM;EACrB,MAAM,SAAS,QAAQ,WAAW,YAAY,YAAY;EAC1D,MAAM,OAAO,EAAE,OAAO,IAAI,EAAE,WAAW;GACtC,MAAM,SAAS,KAAK,MAAM;IAAE;IAAQ;IAAS,QAAQ,WAAW,KAAA;GAAU,CAAC;GAC3E,IAAI,OAAO,SAAS,SAAS,GAC5B,MAAM,IAAI,MAAM,kBAAkB,KAAK,IAAI,eAAe,OAAO,QAAQ,GAAG;GAE7E,OAAO;IAAE,UAAU,OAAO;IAAM,QAAQ;GAAK;EAC9C,CAAC;CACF;AACD;AAEK,OAAO,OAAO,CAAC"}
+{"version":3,"file":"bun.mjs","names":[],"sources":["../src/bun.ts"],"sourcesContent":["import { extname } from 'node:path';\nimport { fileURLToPath } from 'node:url';\n\nimport { plugin } from 'bun';\n\nimport { configPathPattern, formatProblems } from './core/index.ts';\nimport { load } from './runtime/index.ts';\n\nimport type { BunPlugin } from 'bun';\n\n// The runtime next to this module, so it resolves from config files outside the dependency tree: `.ts` in this repo, `.mjs` once built.\nconst runtime = fileURLToPath(new URL(`runtime/index${extname(import.meta.url)}`, import.meta.url));\n\nexport interface TyfigoBunOptions {\n\t/**\n\t * The environment name. Defaults to `NODE_ENV`, read when the config loads, or when a server `Bun.build` bundle starts.\n\t * Setting it fixes the environment of a server bundle.\n\t */\n\treadonly environment?: string | undefined;\n}\n\n/**\n * The tyfigo Bun plugin. Importing `tyfigo/bun` (a `bunfig.toml` `preload`) registers it for the runtime and `bun test`; pass\n * `tyfigo()` in `plugins` to use it with `Bun.build`, where a `browser` target inlines the config and a server target inlines the config files and reads `.env` files when it runs.\n */\nexport const tyfigo = (options: TyfigoBunOptions = {}): BunPlugin => ({\n\tname: 'tyfigo',\n\tsetup(build) {\n\t\tconst config = build.config as typeof build.config | undefined;\n\t\tconst target = config?.target === 'browser' ? 'browser' : 'server';\n\t\tbuild.onLoad({ filter: configPathPattern }, ({ path }) => {\n\t\t\tconst result = load(path, {\n\t\t\t\ttarget,\n\t\t\t\truntime,\n\t\t\t\tbundle: config !== undefined,\n\t\t\t\tenvironment: options.environment,\n\t\t\t});\n\t\t\tif (result.problems.length > 0) {\n\t\t\t\tthrow new Error(`Invalid config ${path}\\n${formatProblems(result.problems)}`);\n\t\t\t}\n\t\t\treturn { contents: result.code, loader: 'js' };\n\t\t});\n\t},\n});\n\nvoid plugin(tyfigo());\n"],"mappings":";;;;;;;AAWA,MAAM,UAAU,cAAc,IAAI,IAAI,gBAAgB,QAAQ,YAAY,GAAG,KAAK,YAAY,GAAG,CAAC;;;;;AAclG,MAAa,UAAU,UAA4B,CAAC,OAAkB;CACrE,MAAM;CACN,MAAM,OAAO;EACZ,MAAM,SAAS,MAAM;EACrB,MAAM,SAAS,QAAQ,WAAW,YAAY,YAAY;EAC1D,MAAM,OAAO,EAAE,QAAQ,kBAAkB,IAAI,EAAE,WAAW;GACzD,MAAM,SAAS,KAAK,MAAM;IACzB;IACA;IACA,QAAQ,WAAW,KAAA;IACnB,aAAa,QAAQ;GACtB,CAAC;GACD,IAAI,OAAO,SAAS,SAAS,GAC5B,MAAM,IAAI,MAAM,kBAAkB,KAAK,IAAI,eAAe,OAAO,QAAQ,GAAG;GAE7E,OAAO;IAAE,UAAU,OAAO;IAAM,QAAQ;GAAK;EAC9C,CAAC;CACF;AACD;AAEK,OAAO,OAAO,CAAC"}

package/dist/effect.mjs

@@ -1,7 +1,7 @@
 import { t as ConfigValidationError } from "./schema-DcD4N9N-.mjs";
-import { t as decodeEnv } from "./env-Bd-1Atoz.mjs";
+import { t as decodeEnv } from "./env--pSRlq_k.mjs";
 import { a as layerConfig, i as ConfigService, n as layerConfigProvider, o as loadConfig, r as ConfigError, t as configProvider } from "./effect.browser-CO87TEE_.mjs";
-import { t as resolveConfig } from "./resolve-D3geHCGs.mjs";
+import { t as resolveConfig } from "./resolve-DQfTdYJN.mjs";
 import { ConfigProvider, Effect, Layer } from "effect";
 // src/effect/env.ts
 /**

package/dist/{env-Bd-1Atoz.mjs → env--pSRlq_k.mjs}

@@ -1,4 +1,4 @@
-import { n as processEnv, r as readEnv } from "./env-R3_XPW_u.mjs";
+import { n as processEnv, r as readEnv } from "./env-Dv5OHfEf.mjs";
 import { r as validate } from "./schema-DcD4N9N-.mjs";
 import { Effect } from "effect";
 import { join } from "node:path";
@@ -24,4 +24,4 @@ const decodeEnv = Effect.fn("decodeEnv")(function* (schema, options) {
 });
 export { decodeEnv as t };
 
-//# sourceMappingURL=env-Bd-1Atoz.mjs.map
+//# sourceMappingURL=env--pSRlq_k.mjs.map

package/dist/{env-Bd-1Atoz.mjs.map → env--pSRlq_k.mjs.map}

@@ -1 +1 @@
-{"version":3,"file":"env-Bd-1Atoz.mjs","names":[],"sources":["../src/env.ts"],"sourcesContent":["import { join } from 'node:path';\nimport process from 'node:process';\n\nimport { Effect } from 'effect';\n\nimport { processEnv, readEnv } from './core/env.ts';\nimport { validate } from './schema.ts';\n\nimport type { ConfigSchema, LoadEnvOptions } from './schema.ts';\n\nexport const decodeEnv = Effect.fn('decodeEnv')(function* <S extends ConfigSchema>(\n\tschema: S,\n\toptions: LoadEnvOptions & { readonly async: boolean; readonly native?: boolean | undefined },\n) {\n\tconst env = options.env ?? processEnv();\n\tconst environment = options.environment ?? (env.NODE_ENV || undefined);\n\tconst result = yield* readEnv(join(options.cwd ?? process.cwd(), '.env'), { environment, env });\n\treturn yield* validate(schema, result.variables, {\n\t\tsubject: 'environment variables',\n\t\tasync: options.async,\n\t\tnative: options.native,\n\t\tissues: result.problems.map((problem) => ({\n\t\t\tpath: [],\n\t\t\tmessage: problem.message,\n\t\t\tlocation: `${problem.file}:${problem.line}:${problem.column}`,\n\t\t})),\n\t});\n});\n"],"mappings":";;;;;;AAUA,MAAa,YAAY,OAAO,GAAG,WAAW,CAAC,CAAC,WAC/C,QACA,SACC;CACD,MAAM,MAAM,QAAQ,OAAO,WAAW;CACtC,MAAM,cAAc,QAAQ,gBAAgB,IAAI,YAAY,KAAA;CAC5D,MAAM,SAAS,OAAO,QAAQ,KAAK,QAAQ,OAAO,QAAQ,IAAI,GAAG,MAAM,GAAG;EAAE;EAAa;CAAI,CAAC;CAC9F,OAAO,OAAO,SAAS,QAAQ,OAAO,WAAW;EAChD,SAAS;EACT,OAAO,QAAQ;EACf,QAAQ,QAAQ;EAChB,QAAQ,OAAO,SAAS,KAAK,aAAa;GACzC,MAAM,CAAC;GACP,SAAS,QAAQ;GACjB,UAAU,GAAG,QAAQ,KAAK,GAAG,QAAQ,KAAK,GAAG,QAAQ;EACtD,EAAE;CACH,CAAC;AACF,CAAC"}
+{"version":3,"file":"env--pSRlq_k.mjs","names":[],"sources":["../src/env.ts"],"sourcesContent":["import { join } from 'node:path';\nimport process from 'node:process';\n\nimport { Effect } from 'effect';\n\nimport { processEnv, readEnv } from './core/env.ts';\nimport { validate } from './schema.ts';\n\nimport type { ConfigSchema, LoadEnvOptions } from './schema.ts';\n\nexport const decodeEnv = Effect.fn('decodeEnv')(function* <S extends ConfigSchema>(\n\tschema: S,\n\toptions: LoadEnvOptions & { readonly async: boolean; readonly native?: boolean | undefined },\n) {\n\tconst env = options.env ?? processEnv();\n\tconst environment = options.environment ?? (env.NODE_ENV || undefined);\n\tconst result = yield* readEnv(join(options.cwd ?? process.cwd(), '.env'), { environment, env });\n\treturn yield* validate(schema, result.variables, {\n\t\tsubject: 'environment variables',\n\t\tasync: options.async,\n\t\tnative: options.native,\n\t\tissues: result.problems.map((problem) => ({\n\t\t\tpath: [],\n\t\t\tmessage: problem.message,\n\t\t\tlocation: `${problem.file}:${problem.line}:${problem.column}`,\n\t\t})),\n\t});\n});\n"],"mappings":";;;;;;AAUA,MAAa,YAAY,OAAO,GAAG,WAAW,CAAC,CAAC,WAC/C,QACA,SACC;CACD,MAAM,MAAM,QAAQ,OAAO,WAAW;CACtC,MAAM,cAAc,QAAQ,gBAAgB,IAAI,YAAY,KAAA;CAC5D,MAAM,SAAS,OAAO,QAAQ,KAAK,QAAQ,OAAO,QAAQ,IAAI,GAAG,MAAM,GAAG;EAAE;EAAa;CAAI,CAAC;CAC9F,OAAO,OAAO,SAAS,QAAQ,OAAO,WAAW;EAChD,SAAS;EACT,OAAO,QAAQ;EACf,QAAQ,QAAQ;EAChB,QAAQ,OAAO,SAAS,KAAK,aAAa;GACzC,MAAM,CAAC;GACP,SAAS,QAAQ;GACjB,UAAU,GAAG,QAAQ,KAAK,GAAG,QAAQ,KAAK,GAAG,QAAQ;EACtD,EAAE;CACH,CAAC;AACF,CAAC"}

package/dist/env-Dv5OHfEf.mjs

@@ -0,0 +1,51 @@
+import { a as envDirectories, o as findFile, t as fileProblem } from "./problems-DS_eJB6e.mjs";
+import { Effect, Result } from "effect";
+import { resolve } from "node:path";
+import process from "node:process";
+import { readFileSync } from "node:fs";
+import { parseEnv } from "node:util";
+// src/core/env.ts
+/**
+* A copy of the real environment. This is the only place tyfigo reads `process.env`.
+*/
+const processEnv = () => ({ ...process.env });
+const envFileNames = (environment) => environment ? [
+	".env",
+	".env.local",
+	`.env.${environment}`,
+	`.env.${environment}.local`
+] : [".env", ".env.local"];
+/**
+* Reads `.env`, `.env.local`, `.env.<environment>` and `.env.<environment>.local` (each later one wins) and puts `env` on top.
+* Each file is searched next to `baseFile` first (above its `.config` directory when it is in one), then in the nearest directory
+* with a `package.json`. Never writes `process.env`.
+*/
+const readEnv = Effect.fn("readEnv")(function* (baseFile, options = {}) {
+	const directories = yield* envDirectories(resolve(baseFile));
+	const variables = {};
+	const files = [];
+	const problems = [];
+	for (const name of envFileNames(options.environment)) {
+		const file = yield* findFile(directories, name);
+		if (!file) continue;
+		const parsed = yield* Effect.result(Effect.try({
+			try: () => parseEnv(readFileSync(file, "utf8")),
+			catch: (error) => fileProblem(file, "read-error", `Cannot read ${file}: ${error.message}`)
+		}));
+		if (Result.isFailure(parsed)) {
+			problems.push(parsed.failure);
+			continue;
+		}
+		files.push(file);
+		Object.assign(variables, parsed.success);
+	}
+	for (const [key, value] of Object.entries(options.env ?? processEnv())) if (value !== void 0) variables[key] = value;
+	return {
+		variables,
+		files,
+		problems
+	};
+});
+export { processEnv as n, readEnv as r, envFileNames as t };
+
+//# sourceMappingURL=env-Dv5OHfEf.mjs.map

package/dist/env-Dv5OHfEf.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"env-Dv5OHfEf.mjs","names":[],"sources":["../src/core/env.ts"],"sourcesContent":["import { readFileSync } from 'node:fs';\nimport { resolve } from 'node:path';\nimport process from 'node:process';\nimport { parseEnv } from 'node:util';\n\nimport { Effect, Result } from 'effect';\n\nimport { envDirectories, findFile } from './files.ts';\nimport { fileProblem } from './problems.ts';\n\nimport type { Problem } from './problems.ts';\n\nexport type EnvVariables = Readonly<Record<string, string | undefined>>;\n\nexport interface EnvResult {\n\t/**\n\t * The `.env` values with the real environment on top.\n\t */\n\treadonly variables: EnvVariables;\n\t/**\n\t * The `.env` files that were read, in the order they apply.\n\t */\n\treadonly files: readonly string[];\n\treadonly problems: readonly Problem[];\n}\n\n/**\n * A copy of the real environment. This is the only place tyfigo reads `process.env`.\n */\nexport const processEnv = (): EnvVariables => ({ ...process.env });\n\nexport const envFileNames = (environment?: string): readonly string[] =>\n\tenvironment ? ['.env', '.env.local', `.env.${environment}`, `.env.${environment}.local`] : ['.env', '.env.local'];\n\n/**\n * Reads `.env`, `.env.local`, `.env.<environment>` and `.env.<environment>.local` (each later one wins) and puts `env` on top.\n * Each file is searched next to `baseFile` first (above its `.config` directory when it is in one), then in the nearest directory\n * with a `package.json`. Never writes `process.env`.\n */\nexport const readEnv = Effect.fn('readEnv')(function* (\n\tbaseFile: string,\n\toptions: { readonly environment?: string | undefined; readonly env?: EnvVariables | undefined } = {},\n) {\n\tconst directories = yield* envDirectories(resolve(baseFile));\n\tconst variables: Record<string, string | undefined> = {};\n\tconst files: string[] = [];\n\tconst problems: Problem[] = [];\n\tfor (const name of envFileNames(options.environment)) {\n\t\tconst file = yield* findFile(directories, name);\n\t\tif (!file) continue;\n\t\tconst parsed = yield* Effect.result(\n\t\t\tEffect.try({\n\t\t\t\ttry: () => parseEnv(readFileSync(file, 'utf8')),\n\t\t\t\tcatch: (error) => fileProblem(file, 'read-error', `Cannot read ${file}: ${(error as Error).message}`),\n\t\t\t}),\n\t\t);\n\t\tif (Result.isFailure(parsed)) {\n\t\t\tproblems.push(parsed.failure);\n\t\t\tcontinue;\n\t\t}\n\n\t\tfiles.push(file);\n\t\tObject.assign(variables, parsed.success);\n\t}\n\n\tfor (const [key, value] of Object.entries(options.env ?? processEnv())) {\n\t\tif (value !== undefined) variables[key] = value;\n\t}\n\treturn { variables, files, problems } satisfies EnvResult;\n});\n"],"mappings":";;;;;;;;;;AA6BA,MAAa,oBAAkC,EAAE,GAAG,QAAQ,IAAI;AAEhE,MAAa,gBAAgB,gBAC5B,cAAc;CAAC;CAAQ;CAAc,QAAQ;CAAe,QAAQ,YAAY;AAAO,IAAI,CAAC,QAAQ,YAAY;;;;;;AAOjH,MAAa,UAAU,OAAO,GAAG,SAAS,CAAC,CAAC,WAC3C,UACA,UAAkG,CAAC,GAClG;CACD,MAAM,cAAc,OAAO,eAAe,QAAQ,QAAQ,CAAC;CAC3D,MAAM,YAAgD,CAAC;CACvD,MAAM,QAAkB,CAAC;CACzB,MAAM,WAAsB,CAAC;CAC7B,KAAK,MAAM,QAAQ,aAAa,QAAQ,WAAW,GAAG;EACrD,MAAM,OAAO,OAAO,SAAS,aAAa,IAAI;EAC9C,IAAI,CAAC,MAAM;EACX,MAAM,SAAS,OAAO,OAAO,OAC5B,OAAO,IAAI;GACV,WAAW,SAAS,aAAa,MAAM,MAAM,CAAC;GAC9C,QAAQ,UAAU,YAAY,MAAM,cAAc,eAAe,KAAK,IAAK,MAAgB,SAAS;EACrG,CAAC,CACF;EACA,IAAI,OAAO,UAAU,MAAM,GAAG;GAC7B,SAAS,KAAK,OAAO,OAAO;GAC5B;EACD;EAEA,MAAM,KAAK,IAAI;EACf,OAAO,OAAO,WAAW,OAAO,OAAO;CACxC;CAEA,KAAK,MAAM,CAAC,KAAK,UAAU,OAAO,QAAQ,QAAQ,OAAO,WAAW,CAAC,GACpE,IAAI,UAAU,KAAA,GAAW,UAAU,OAAO;CAE3C,OAAO;EAAE;EAAW;EAAO;CAAS;AACrC,CAAC"}

package/dist/{formats-D_dKXoPf.mjs → formats-Bf8-iQw-.mjs}

@@ -1,5 +1,6 @@
-import { r as problemAt } from "./problems-BNAqmOzL.mjs";
+import { i as configDirectory, l as isInConfigDirectory, r as problemAt } from "./problems-DS_eJB6e.mjs";
 import { n as formatPath, r as pathKey, t as SourceIndex } from "./positions-BCTEFZTX.mjs";
+import { basename, extname } from "node:path";
 import { getStaticJSONValue, parseJSON, tokenize } from "jsonc-eslint-parser";
 import { getNodeValue, parseTree, printParseErrorCode } from "jsonc-parser";
 import { getStaticTOMLValue, parseTOML } from "toml-eslint-parser";
@@ -874,27 +875,54 @@ const yaml = {
 	parseScalar
 };
 // src/core/formats/index.ts
-const formats = {
-	".config.yaml": yaml,
-	".config.yml": yaml,
-	".config.toml": toml,
-	".config.jsonc": jsonc,
-	".config.json5": json5,
-	".config.ini": ini,
-	".config.properties": properties,
-	".config.xml": xml
-};
+/**
+* The formats by file extension.
+*/
+const formatExtensions = {
+	".yaml": yaml,
+	".yml": yaml,
+	".toml": toml,
+	".jsonc": jsonc,
+	".json5": json5,
+	".ini": ini,
+	".properties": properties,
+	".xml": xml
+};
+const formats = Object.fromEntries(Object.entries(formatExtensions).map(([extension, format]) => [`.config${extension}`, format]));
 const configSuffixes = Object.keys(formats);
 /**
-* Splits a config file name (not a path) into its stem and suffix, or returns `undefined` when tyfigo does not claim it.
+* The format of a file extension such as `.yaml`, or `undefined` when tyfigo does not read it.
 */
-const parseConfigFileName = (fileName) => {
+const formatOfExtension = (extension) => Object.hasOwn(formatExtensions, extension) ? formatExtensions[extension] : void 0;
+/**
+* Splits a config file path into its stem and suffix, or returns `undefined` when tyfigo does not claim it. A config file's name
+* ends in a suffix such as `.config.yaml`, or it has a format extension such as `.yaml` and sits in a `.config` directory.
+*/
+const parseConfigPath = (path) => {
+	const fileName = basename(path);
 	for (const [suffix, format] of Object.entries(formats)) if (fileName.endsWith(suffix) && fileName.length > suffix.length) return {
 		stem: fileName.slice(0, -suffix.length),
 		suffix,
 		format
 	};
+	const suffix = extname(fileName);
+	const format = formatOfExtension(suffix);
+	if (!format || !isInConfigDirectory(path) || fileName.startsWith(".")) return void 0;
+	return {
+		stem: fileName.slice(0, -suffix.length),
+		suffix,
+		format
+	};
 };
-export { kindOf as a, isPlainObject as i, parseConfigFileName as n, resolvePlaceholders as o, hasPlaceholder as r, configSuffixes as t };
+const escape = (text) => text.replaceAll(".", String.raw`\.`);
+/**
+* Matches the paths {@link parseConfigPath} claims, with either path separator, for loader and bundler filters.
+*/
+const configPathPattern = new RegExp(String.raw`(?:[^/\\](?:${configSuffixes.map(escape).join("|")})|(?:^|[/\\])${escape(configDirectory)}[/\\][^/\\.][^/\\]*(?:${Object.keys(formatExtensions).map(escape).join("|")}))$`, "u");
+/**
+* A short description of the files tyfigo claims, for error messages.
+*/
+const configFileDescription = `a name ending in ${configSuffixes.join(", ")}, or a ${Object.keys(formatExtensions).join(", ")} file in a ${configDirectory} directory`;
+export { formatOfExtension as a, isPlainObject as c, formatExtensions as i, kindOf as l, configPathPattern as n, parseConfigPath as o, configSuffixes as r, hasPlaceholder as s, configFileDescription as t, resolvePlaceholders as u };
 
-//# sourceMappingURL=formats-D_dKXoPf.mjs.map
+//# sourceMappingURL=formats-Bf8-iQw-.mjs.map