@theholocron/datapad 5.0.0-alpha.152 → 5.0.0-alpha.154

package/dist/index.d.mts

@@ -1,9 +1,9 @@
 import { deepMerge as mergeConfig } from "@theholocron/object-utils";
-//#region src/default-extensions.d.ts
+//#region src/default-extensions/default-extensions.d.ts
 /** Default extension probe order, highest priority first. */
 declare const DEFAULT_EXTENSIONS: readonly ["ts", "js", "mjs", "cjs", "json"];
 //#endregion
-//#region src/define.d.ts
+//#region src/define/define.d.ts
 /**
  * Build a typed identity `defineConfig` for a specific config shape.
  *
@@ -18,7 +18,7 @@ declare const DEFAULT_EXTENSIONS: readonly ["ts", "js", "mjs", "cjs", "json"];
  */
 declare function createDefineConfig<T>(): <C extends T>(config: C) => C;
 //#endregion
-//#region src/errors.d.ts
+//#region src/errors/errors.d.ts
 /**
  * Thrown when a config file is found but cannot be loaded — malformed
  * JSON, a syntax error in a `.ts` / `.js` module, or no usable default
@@ -34,7 +34,7 @@ declare class ConfigFileError extends Error {
   filepath?: string | undefined);
 }
 //#endregion
-//#region src/load-config-file.type.d.ts
+//#region src/load-config-file/load-config-file.type.d.ts
 interface LoadConfigFileOptions {
   /** Directory to start looking in. */
   cwd: string;
@@ -57,7 +57,7 @@ interface Loaded<T> {
   filepath: string;
 }
 //#endregion
-//#region src/load-config-file.d.ts
+//#region src/load-config-file/load-config-file.d.ts
 /**
  * Load the first `<name>.config.<ext>` found starting at `cwd` — just
  * `cwd` itself by default, or walking up through ancestor directories when
@@ -67,7 +67,7 @@ interface Loaded<T> {
  */
 declare function loadConfigFile<T>(opts: LoadConfigFileOptions): Promise<Loaded<T> | null>;
 //#endregion
-//#region src/load-config-from-content.type.d.ts
+//#region src/load-config-from-content/load-config-from-content.type.d.ts
 interface LoadConfigFromContentOptions {
   /**
    * Directory to write `<name>.config.<extension>` into before loading —
@@ -86,7 +86,7 @@ interface LoadConfigFromContentOptions {
   extension: string;
 }
 //#endregion
-//#region src/load-config-from-content.d.ts
+//#region src/load-config-from-content/load-config-from-content.d.ts
 /**
  * Load config from content that didn't come from a file already on disk —
  * writes it to `<dir>/<name>.config.<extension>` first, then loads it
@@ -99,7 +99,7 @@ interface LoadConfigFromContentOptions {
  */
 declare function loadConfigFromContent<T>(opts: LoadConfigFromContentOptions): Promise<Loaded<T>>;
 //#endregion
-//#region src/load-layered.type.d.ts
+//#region src/load-layered/load-layered.type.d.ts
 interface LoadLayeredOptions<T = unknown> extends LoadConfigFileOptions {
   /**
    * When no dedicated `<name>.config.*` exists — or in addition to it —
@@ -132,7 +132,7 @@ interface LayeredResult<T> {
   sources: string[];
 }
 //#endregion
-//#region src/load-layered.d.ts
+//#region src/load-layered/load-layered.d.ts
 /**
  * `<name>.config.*` layered over the `[fallback.key]` of
  * `<fallback.file>.config.*`. Either, both, or neither may be present;
@@ -141,7 +141,7 @@ interface LayeredResult<T> {
  */
 declare function loadLayered<T>(opts: LoadLayeredOptions<T>): Promise<LayeredResult<T> | null>;
 //#endregion
-//#region src/merge-layers.d.ts
+//#region src/merge-layers/merge-layers.d.ts
 /**
  * Deep-merges config layers, lowest priority first (a later layer wins on
  * scalars; arrays concatenate; nested objects merge). `undefined` layers are
@@ -154,7 +154,7 @@ declare function loadLayered<T>(opts: LoadLayeredOptions<T>): Promise<LayeredRes
  */
 declare function mergeLayers<T>(layers: readonly (T | undefined)[]): T | undefined;
 //#endregion
-//#region src/read-config-source.type.d.ts
+//#region src/read-config-source/read-config-source.type.d.ts
 /** A config file's content fetched from somewhere other than the local disk. */
 interface ConfigSource {
   /** The file name probed, e.g. `holocron.config.ts` — relative, as `fetch` was asked for it. */
@@ -177,7 +177,7 @@ interface ReadConfigSourceOptions {
   extensions?: readonly string[];
 }
 //#endregion
-//#region src/read-config-source.d.ts
+//#region src/read-config-source/read-config-source.d.ts
 /**
  * {@link probeExtensions} for a config that lives somewhere other than the
  * local disk (a GitHub API, a git blob): probes `<name>.config.<ext>` in
@@ -187,7 +187,7 @@ interface ReadConfigSourceOptions {
  */
 declare function readConfigSource(options: ReadConfigSourceOptions): Promise<ConfigSource | undefined>;
 //#endregion
-//#region src/with-config-sandbox.type.d.ts
+//#region src/with-config-sandbox/with-config-sandbox.type.d.ts
 interface ConfigSandboxOptions {
   /**
    * A real `node_modules` directory to make visible from the sandbox. A config
@@ -203,7 +203,7 @@ interface ConfigSandboxOptions {
   prefix?: string;
 }
 //#endregion
-//#region src/with-config-sandbox.d.ts
+//#region src/with-config-sandbox/with-config-sandbox.d.ts
 /**
  * Runs `run` with a throwaway directory prepared for
  * {@link loadConfigFromContent}'s `dir`, and removes it afterwards (also when

package/dist/index.mjs

@@ -5,7 +5,7 @@ import { pathToFileURL } from "node:url";
 import { errorMessage } from "@theholocron/misc-utils";
 import { deepMerge, deepMerge as mergeConfig } from "@theholocron/object-utils";
 import { tmpdir } from "node:os";
-//#region src/default-extensions.ts
+//#region src/default-extensions/default-extensions.ts
 /** Default extension probe order, highest priority first. */
 const DEFAULT_EXTENSIONS = [
 	"ts",
@@ -15,7 +15,7 @@ const DEFAULT_EXTENSIONS = [
 	"json"
 ];
 //#endregion
-//#region src/define.ts
+//#region src/define/define.ts
 /**
 * Build a typed identity `defineConfig` for a specific config shape.
 *
@@ -32,7 +32,7 @@ function createDefineConfig() {
 	return (config) => config;
 }
 //#endregion
-//#region src/errors.ts
+//#region src/errors/errors.ts
 /**
 * Thrown when a config file is found but cannot be loaded — malformed
 * JSON, a syntax error in a `.ts` / `.js` module, or no usable default
@@ -48,7 +48,7 @@ var ConfigFileError = class extends Error {
 	}
 };
 //#endregion
-//#region src/is-file.ts
+//#region src/is-file/is-file.ts
 async function isFile(path) {
 	try {
 		return (await stat(path)).isFile();
@@ -57,7 +57,7 @@ async function isFile(path) {
 	}
 }
 //#endregion
-//#region src/load-file.ts
+//#region src/load-file/load-file.ts
 /**
 * The actual file-loading mechanics `load.ts`'s exported functions share:
 * JSON parsing, dynamic `import()` (TS via `tsx`'s persistent ESM loader,
@@ -115,7 +115,7 @@ function extractDefault(filepath, mod) {
 	return raw;
 }
 //#endregion
-//#region src/probe-extensions.ts
+//#region src/probe-extensions/probe-extensions.ts
 /**
 * Probe `dir` for `<name>.config.<ext>` in extension-priority order,
 * loading and returning the first match. The one piece of per-directory
@@ -134,7 +134,7 @@ async function probeExtensions(dir, name, extensions) {
 	}
 }
 //#endregion
-//#region src/load-config-file.ts
+//#region src/load-config-file/load-config-file.ts
 /**
 * Discover and load `<name>.config.*` files, or load one from content that
 * didn't come from a file at all ({@link loadConfigFromContent}).
@@ -170,7 +170,7 @@ async function loadConfigFile(opts) {
 	return await findUpward(opts.cwd, checkDir, hasGitEntry) ?? null;
 }
 //#endregion
-//#region src/load-config-from-content.ts
+//#region src/load-config-from-content/load-config-from-content.ts
 /**
 * Load config from content that didn't come from a file already on disk —
 * writes it to `<dir>/<name>.config.<extension>` first, then loads it
@@ -190,7 +190,7 @@ async function loadConfigFromContent(opts) {
 	};
 }
 //#endregion
-//#region src/merge-layers.ts
+//#region src/merge-layers/merge-layers.ts
 /**
 * Deep-merges config layers, lowest priority first (a later layer wins on
 * scalars; arrays concatenate; nested objects merge). `undefined` layers are
@@ -207,7 +207,7 @@ function mergeLayers(layers) {
 	return present.reduce((acc, layer) => deepMerge(acc, layer), {});
 }
 //#endregion
-//#region src/load-layered.ts
+//#region src/load-layered/load-layered.ts
 /**
 * `<name>.config.*` layered over the `[fallback.key]` of
 * `<fallback.file>.config.*`. Either, both, or neither may be present;
@@ -248,7 +248,7 @@ async function loadLayered(opts) {
 	};
 }
 //#endregion
-//#region src/read-config-source.ts
+//#region src/read-config-source/read-config-source.ts
 /**
 * {@link probeExtensions} for a config that lives somewhere other than the
 * local disk (a GitHub API, a git blob): probes `<name>.config.<ext>` in
@@ -268,7 +268,7 @@ async function readConfigSource(options) {
 	}
 }
 //#endregion
-//#region src/with-config-sandbox.ts
+//#region src/with-config-sandbox/with-config-sandbox.ts
 /**
 * Runs `run` with a throwaway directory prepared for
 * {@link loadConfigFromContent}'s `dir`, and removes it afterwards (also when

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@theholocron/datapad",
-  "version": "5.0.0-alpha.152",
+  "version": "5.0.0-alpha.154",
   "description": "Generic config-file loading for Holocron — discover, load (JSON/JS/TS/ESM/CJS), and merge <name>.config.* files with a typed defineConfig.",
   "keywords": [
     "config",
@@ -32,9 +32,9 @@
     "dist"
   ],
   "dependencies": {
-    "@theholocron/fs-utils": "^1.13.0",
-    "@theholocron/misc-utils": "^1.13.0",
-    "@theholocron/object-utils": "^1.13.0",
+    "@theholocron/fs-utils": "^1.15.1",
+    "@theholocron/misc-utils": "^1.15.1",
+    "@theholocron/object-utils": "^1.15.1",
     "tsx": "4.23.12"
   },
   "devDependencies": {