@vitus-labs/tools-core 1.8.1-alpha.0 → 1.8.1-alpha.2

package/lib/index.js

@@ -1,40 +1,92 @@
 import fs from 'node:fs';
 import { createRequire } from 'node:module';
-import { findUpSync } from 'find-up';
-import { get as _get, merge } from 'lodash-es';
-const VITUS_LABS_FILE_NAME = 'vl-tools.config.js';
+import path from 'node:path';
+const VL_CONFIG_FILES = ['vl-tools.config.mjs', 'vl-tools.config.js'];
 const PACKAGE_FILE_NAME = 'package.json';
 const TYPESCRIPT_FILE_NAME = 'tsconfig.json';
 const require = createRequire(import.meta.url);
 // --------------------------------------------------------
+// Utility helpers (replaces lodash-es and find-up)
+// --------------------------------------------------------
+const get = (obj, dotPath, defaultValue = {}) => {
+    const keys = dotPath.split('.');
+    let result = obj;
+    for (const key of keys) {
+        if (result == null)
+            return defaultValue;
+        result = result[key];
+    }
+    return result === undefined ? defaultValue : result;
+};
+const deepMerge = (target, source) => {
+    const result = { ...target };
+    for (const key of Object.keys(source)) {
+        const srcVal = source[key];
+        const tgtVal = result[key];
+        if (typeof srcVal === 'object' &&
+            srcVal !== null &&
+            !Array.isArray(srcVal) &&
+            typeof tgtVal === 'object' &&
+            tgtVal !== null &&
+            !Array.isArray(tgtVal)) {
+            result[key] = deepMerge(tgtVal, srcVal);
+        }
+        else {
+            result[key] = srcVal;
+        }
+    }
+    return result;
+};
+const findFileUp = (names, cwd = process.cwd()) => {
+    const fileNames = Array.isArray(names) ? names : [names];
+    let dir = path.resolve(cwd);
+    while (true) {
+        for (const name of fileNames) {
+            const filePath = path.join(dir, name);
+            try {
+                if (fs.statSync(filePath).isFile())
+                    return filePath;
+            }
+            catch (_e) {
+                // file doesn't exist, continue
+            }
+        }
+        const parent = path.dirname(dir);
+        if (parent === dir)
+            return undefined;
+        dir = parent;
+    }
+};
+// --------------------------------------------------------
 // FIND & READ file helpers
 // --------------------------------------------------------
-const findFile = (filename) => findUpSync(filename, { type: 'file' });
+const findFile = (filename) => findFileUp(filename);
+const loadModule = (filePath) => {
+    try {
+        const imported = require(filePath);
+        // Handle ESM default export wrapping
+        return imported?.default ?? imported ?? {};
+    }
+    catch (_e) {
+        return {};
+    }
+};
 const loadFileToJSON = (filename) => {
     const file = findFile(filename);
     if (!file)
         return {};
-    let data = {};
     // try to read an exported module first
+    const data = loadModule(file);
+    if (data && Object.keys(data).length > 0)
+        return data;
+    // try to read a plain json file like tsconfig.json
     try {
-        const importedFile = require(file);
-        if (importedFile) {
-            data = importedFile;
-        }
+        return JSON.parse(fs.readFileSync(file, 'utf-8'));
     }
     catch (_e) {
         // ignore error
     }
-    // try to read a plain json file like tsconfig.json
-    if (!data) {
-        try {
-            data = JSON.parse(fs.readFileSync(file, 'utf-8'));
-        }
-        catch (_e) {
-            // ignore error
-        }
-    }
-    return data;
+    return {};
 };
 // --------------------------------------------------------
 // GET PACKAGE.JSON info
@@ -56,9 +108,6 @@ const getDependenciesList = (types) => {
     });
     return result;
 };
-// parse namespace name
-// const parseNamespace = (name) =>
-//   name.startsWith('@') ? name.split('/')[0] : ''
 // converts package name to umd or iife valid format
 // example: napespace-package-name => namespacePackageName
 const camelspaceBundleName = (name) => {
@@ -76,13 +125,8 @@ const camelspaceBundleName = (name) => {
 const getPkgData = () => {
     const pkg = getPackageJSON();
     const { name } = pkg;
-    // const namespace = parseNamespace(name)
     return {
         ...pkg,
-        // nameWithoutPrefix: name.replace(namespace, '').replace('/', ''),
-        // namespace,
-        // namespaceName: namespace.replace('@', ''),
-        // rootPath: findFilePath('package.json'),
         bundleName: camelspaceBundleName(name),
         externalDependencies: getDependenciesList([
             'dependencies',
@@ -92,11 +136,38 @@ const getPkgData = () => {
 };
 // --------------------------------------------------------
 // LOAD EXTERNAL CONFIGURATION
+// Cascading: finds all vl-tools.config.{mjs,js} files from
+// cwd upward, then deep-merges them (root first, closest
+// package config wins).
 // --------------------------------------------------------
-const getExternalConfig = () => loadFileToJSON(VITUS_LABS_FILE_NAME);
+const findAllConfigFiles = () => {
+    const files = [];
+    let cwd = process.cwd();
+    while (true) {
+        const file = findFileUp(VL_CONFIG_FILES, cwd);
+        if (!file)
+            break;
+        files.push(file);
+        const parentDir = path.dirname(path.dirname(file));
+        if (parentDir === path.dirname(file))
+            break;
+        cwd = parentDir;
+    }
+    // Root config first, closest config last (overrides)
+    return files.reverse();
+};
+const getExternalConfig = () => {
+    const files = findAllConfigFiles();
+    let config = {};
+    for (const file of files) {
+        const loaded = loadModule(file);
+        config = deepMerge(config, loaded);
+    }
+    return config;
+};
 const loadConfigParam = (filename) => (key, defaultValue = {}) => {
     const externalConfig = loadFileToJSON(filename);
-    return _get(externalConfig, key, defaultValue);
+    return get(externalConfig, key, defaultValue);
 };
 const loadVLToolsConfig = () => {
     const externalConfig = getExternalConfig();
@@ -104,15 +175,16 @@ const loadVLToolsConfig = () => {
         get config() {
             return object;
         },
-        get: (param, defaultValue) => _get(object, param, defaultValue || {}),
-        merge: (param) => cloneAndEnhance(merge(object, param)),
+        get: (param, defaultValue) => get(object, param, defaultValue || {}),
+        merge: (param) => cloneAndEnhance(deepMerge(param, object)),
     });
     const getOutput = (key) => {
-        const result = _get(externalConfig, key, {});
+        const result = get(externalConfig, key, {});
         return cloneAndEnhance(result);
     };
     return getOutput;
 };
+const defineConfig = (config) => config;
 const swapGlobals = (globals) => Object.entries(globals).reduce((acc, [key, value]) => {
     acc[value] = key;
     return acc;
@@ -120,5 +192,5 @@ const swapGlobals = (globals) => Object.entries(globals).reduce((acc, [key, valu
 const PKG = getPkgData();
 const VL_CONFIG = loadVLToolsConfig();
 const TS_CONFIG = loadFileToJSON(TYPESCRIPT_FILE_NAME);
-export { findFile, loadConfigParam, loadFileToJSON, loadVLToolsConfig, swapGlobals, PKG, VL_CONFIG, TS_CONFIG, };
+export { defineConfig, findFile, loadConfigParam, loadFileToJSON, loadVLToolsConfig, swapGlobals, PKG, VL_CONFIG, TS_CONFIG, };
 //# sourceMappingURL=index.js.map

package/lib/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAA;AACxB,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAC3C,OAAO,IAAI,MAAM,WAAW,CAAA;AAE5B,MAAM,eAAe,GAAG,CAAC,qBAAqB,EAAE,oBAAoB,CAAC,CAAA;AACrE,MAAM,iBAAiB,GAAG,cAAc,CAAA;AACxC,MAAM,oBAAoB,GAAG,eAAe,CAAA;AAE5C,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;AAE9C,2DAA2D;AAC3D,mDAAmD;AACnD,2DAA2D;AAC3D,MAAM,GAAG,GAAG,CAAC,GAAQ,EAAE,OAAe,EAAE,eAAoB,EAAE,EAAO,EAAE;IACrE,MAAM,IAAI,GAAG,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAA;IAC/B,IAAI,MAAM,GAAG,GAAG,CAAA;IAEhB,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,IAAI,MAAM,IAAI,IAAI;YAAE,OAAO,YAAY,CAAA;QACvC,MAAM,GAAG,MAAM,CAAC,GAAG,CAAC,CAAA;IACtB,CAAC;IAED,OAAO,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,MAAM,CAAA;AACrD,CAAC,CAAA;AAED,MAAM,SAAS,GAAG,CAChB,MAA2B,EAC3B,MAA2B,EACN,EAAE;IACvB,MAAM,MAAM,GAAG,EAAE,GAAG,MAAM,EAAE,CAAA;IAE5B,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;QACtC,MAAM,MAAM,GAAG,MAAM,CAAC,GAAG,CAAC,CAAA;QAC1B,MAAM,MAAM,GAAG,MAAM,CAAC,GAAG,CAAC,CAAA;QAE1B,IACE,OAAO,MAAM,KAAK,QAAQ;YAC1B,MAAM,KAAK,IAAI;YACf,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC;YACtB,OAAO,MAAM,KAAK,QAAQ;YAC1B,MAAM,KAAK,IAAI;YACf,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EACtB,CAAC;YACD,MAAM,CAAC,GAAG,CAAC,GAAG,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;QACzC,CAAC;aAAM,CAAC;YACN,MAAM,CAAC,GAAG,CAAC,GAAG,MAAM,CAAA;QACtB,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAA;AACf,CAAC,CAAA;AAED,MAAM,UAAU,GAAG,CACjB,KAAwB,EACxB,GAAG,GAAG,OAAO,CAAC,GAAG,EAAE,EACC,EAAE;IACtB,MAAM,SAAS,GAAG,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAA;IACxD,IAAI,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAA;IAE3B,OAAO,IAAI,EAAE,CAAC;QACZ,KAAK,MAAM,IAAI,IAAI,SAAS,EAAE,CAAC;YAC7B,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,CAAA;YACrC,IAAI,CAAC;gBACH,IAAI,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,MAAM,EAAE;oBAAE,OAAO,QAAQ,CAAA;YACrD,CAAC;YAAC,OAAO,EAAE,EAAE,CAAC;gBACZ,+BAA+B;YACjC,CAAC;QACH,CAAC;QAED,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAA;QAChC,IAAI,MAAM,KAAK,GAAG;YAAE,OAAO,SAAS,CAAA;QACpC,GAAG,GAAG,MAAM,CAAA;IACd,CAAC;AACH,CAAC,CAAA;AAED,2DAA2D;AAC3D,2BAA2B;AAC3B,2DAA2D;AAC3D,MAAM,QAAQ,GAAG,CAAC,QAAgB,EAAE,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAA;AAE3D,MAAM,UAAU,GAAG,CAAC,QAAgB,EAAuB,EAAE;IAC3D,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAA;QAClC,qCAAqC;QACrC,OAAO,QAAQ,EAAE,OAAO,IAAI,QAAQ,IAAI,EAAE,CAAA;IAC5C,CAAC;IAAC,OAAO,EAAE,EAAE,CAAC;QACZ,OAAO,EAAE,CAAA;IACX,CAAC;AACH,CAAC,CAAA;AAED,MAAM,cAAc,GAAG,CAAC,QAAgB,EAAuB,EAAE;IAC/D,MAAM,IAAI,GAAG,QAAQ,CAAC,QAAQ,CAAC,CAAA;IAE/B,IAAI,CAAC,IAAI;QAAE,OAAO,EAAE,CAAA;IAEpB,uCAAuC;IACvC,MAAM,IAAI,GAAG,UAAU,CAAC,IAAI,CAAC,CAAA;IAC7B,IAAI,IAAI,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,IAAI,CAAA;IAErD,mDAAmD;IACnD,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,YAAY,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAA;IACnD,CAAC;IAAC,OAAO,EAAE,EAAE,CAAC;QACZ,eAAe;IACjB,CAAC;IAED,OAAO,EAAE,CAAA;AACX,CAAC,CAAA;AAED,2DAA2D;AAC3D,wBAAwB;AACxB,2DAA2D;AAC3D,MAAM,cAAc,GAAG,GAAG,EAAE;IAC1B,MAAM,IAAI,GAAG,cAAc,CAAC,iBAAiB,CAAC,CAAA;IAE9C,OAAO,IAAI,CAAA;AACb,CAAC,CAAA;AAED,2DAA2D;AAC3D,iCAAiC;AACjC,2DAA2D;AAE3D,6CAA6C;AAC7C,MAAM,mBAAmB,GAAG,CAAC,KAAU,EAAE,EAAE;IACzC,MAAM,GAAG,GAAG,cAAc,EAAE,CAAA;IAC5B,IAAI,MAAM,GAAQ,EAAE,CAAA;IAEpB,KAAK,CAAC,OAAO,CAAC,CAAC,IAAS,EAAE,EAAE;QAC1B,MAAM,IAAI,GAAG,GAAG,CAAC,IAAI,CAAC,CAAA;QACtB,MAAM,GAAG,CAAC,GAAG,MAAM,EAAE,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,CAAA;IAClD,CAAC,CAAC,CAAA;IAEF,OAAO,MAAM,CAAA;AACf,CAAC,CAAA;AAED,oDAAoD;AACpD,0DAA0D;AAC1D,MAAM,oBAAoB,GAAG,CAAC,IAAY,EAAE,EAAE;IAC5C,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,GAAG,EAAE,GAAG,CAAC,CAAA;IAC1D,MAAM,WAAW,GAAG,CAAC,KAAU,EAAE,EAAE,CACjC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAS,EAAE,CAAM,EAAE,EAAE,CAC9B,CAAC,KAAK,CAAC;QACL,CAAC,CAAC,IAAI;QACN,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAC/D,CAAA;IACH,MAAM,KAAK,GAAG,UAAU,CAAC,KAAK,CAAC,GAAG,CAAC,CAAA;IACnC,MAAM,MAAM,GAAG,WAAW,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;IAE1C,OAAO,MAAM,CAAA;AACf,CAAC,CAAA;AAED,2DAA2D;AAC3D,oBAAoB;AACpB,2DAA2D;AAC3D,MAAM,UAAU,GAAG,GAAwB,EAAE;IAC3C,MAAM,GAAG,GAAG,cAAc,EAAE,CAAA;IAC5B,MAAM,EAAE,IAAI,EAAE,GAAG,GAAG,CAAA;IAEpB,OAAO;QACL,GAAG,GAAG;QACN,UAAU,EAAE,oBAAoB,CAAC,IAAI,CAAC;QACtC,oBAAoB,EAAE,mBAAmB,CAAC;YACxC,cAAc;YACd,kBAAkB;SACnB,CAAC;KACH,CAAA;AACH,CAAC,CAAA;AAED,2DAA2D;AAC3D,8BAA8B;AAC9B,2DAA2D;AAC3D,yDAAyD;AACzD,wBAAwB;AACxB,2DAA2D;AAC3D,MAAM,kBAAkB,GAAG,GAAa,EAAE;IACxC,MAAM,KAAK,GAAa,EAAE,CAAA;IAC1B,IAAI,GAAG,GAAG,OAAO,CAAC,GAAG,EAAE,CAAA;IAEvB,OAAO,IAAI,EAAE,CAAC;QACZ,MAAM,IAAI,GAAG,UAAU,CAAC,eAAe,EAAE,GAAG,CAAC,CAAA;QAC7C,IAAI,CAAC,IAAI;YAAE,MAAK;QAChB,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QAChB,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAA;QAClD,IAAI,SAAS,KAAK,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC;YAAE,MAAK;QAC3C,GAAG,GAAG,SAAS,CAAA;IACjB,CAAC;IAED,qDAAqD;IACrD,OAAO,KAAK,CAAC,OAAO,EAAE,CAAA;AACxB,CAAC,CAAA;AAED,MAAM,iBAAiB,GAAG,GAAwB,EAAE;IAClD,MAAM,KAAK,GAAG,kBAAkB,EAAE,CAAA;IAClC,IAAI,MAAM,GAAwB,EAAE,CAAA;IAEpC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,MAAM,GAAG,UAAU,CAAC,IAAI,CAAC,CAAA;QAC/B,MAAM,GAAG,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IACpC,CAAC;IAED,OAAO,MAAM,CAAA;AACf,CAAC,CAAA;AAED,MAAM,eAAe,GACnB,CAAC,QAAgB,EAAE,EAAE,CACrB,CAAC,GAAW,EAAE,YAAY,GAAG,EAAE,EAAE,EAAE;IACjC,MAAM,cAAc,GAAG,cAAc,CAAC,QAAQ,CAAC,CAAA;IAE/C,OAAO,GAAG,CAAC,cAAc,EAAE,GAAG,EAAE,YAAY,CAAC,CAAA;AAC/C,CAAC,CAAA;AAEH,MAAM,iBAAiB,GAAG,GAAG,EAAE;IAC7B,MAAM,cAAc,GAAG,iBAAiB,EAAE,CAAA;IAE1C,MAAM,eAAe,GAAG,CAAC,MAA2B,EAAE,EAAE,CAAC,CAAC;QACxD,IAAI,MAAM;YACR,OAAO,MAAM,CAAA;QACf,CAAC;QACD,GAAG,EAAE,CAAC,KAAa,EAAE,YAAkB,EAAE,EAAE,CACzC,GAAG,CAAC,MAAM,EAAE,KAAK,EAAE,YAAY,IAAI,EAAE,CAAC;QACxC,KAAK,EAAE,CAAC,KAA0B,EAAE,EAAE,CACpC,eAAe,CAAC,SAAS,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;KAC5C,CAAC,CAAA;IAEF,MAAM,SAAS,GAAG,CAAC,GAAW,EAAE,EAAE;QAChC,MAAM,MAAM,GAAG,GAAG,CAAC,cAAc,EAAE,GAAG,EAAE,EAAE,CAAC,CAAA;QAE3C,OAAO,eAAe,CAAC,MAAM,CAAC,CAAA;IAChC,CAAC,CAAA;IAED,OAAO,SAAS,CAAA;AAClB,CAAC,CAAA;AAED,MAAM,YAAY,GAAG,CAAgC,MAAS,EAAK,EAAE,CAAC,MAAM,CAAA;AAE5E,MAAM,WAAW,GAAG,CAAC,OAA+B,EAAE,EAAE,CACtD,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,MAAM,CAC5B,CAAC,GAAG,EAAE,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE;IACpB,GAAG,CAAC,KAAK,CAAC,GAAG,GAAG,CAAA;IAChB,OAAO,GAAG,CAAA;AACZ,CAAC,EACD,EAAE,CACH,CAAA;AAEH,MAAM,GAAG,GAAG,UAAU,EAAE,CAAA;AACxB,MAAM,SAAS,GAAG,iBAAiB,EAAE,CAAA;AACrC,MAAM,SAAS,GAAG,cAAc,CAAC,oBAAoB,CAAC,CAAA;AAEtD,OAAO,EACL,YAAY,EACZ,QAAQ,EACR,eAAe,EACf,cAAc,EACd,iBAAiB,EACjB,WAAW,EACX,GAAG,EACH,SAAS,EACT,SAAS,GACV,CAAA"}

package/lib/types/index.d.ts

@@ -6,6 +6,7 @@ declare const loadVLToolsConfig: () => (key: string) => {
     get: (param: string, defaultValue?: any) => any;
     merge: (param: Record<string, any>) => /*elided*/ any;
 };
+declare const defineConfig: <T extends Record<string, any>>(config: T) => T;
 declare const swapGlobals: (globals: Record<string, string>) => Record<string, string>;
 declare const PKG: Record<string, any>;
 declare const VL_CONFIG: (key: string) => {
@@ -14,5 +15,5 @@ declare const VL_CONFIG: (key: string) => {
     merge: (param: Record<string, any>) => /*elided*/ any;
 };
 declare const TS_CONFIG: Record<string, any>;
-export { findFile, loadConfigParam, loadFileToJSON, loadVLToolsConfig, swapGlobals, PKG, VL_CONFIG, TS_CONFIG, };
+export { defineConfig, findFile, loadConfigParam, loadFileToJSON, loadVLToolsConfig, swapGlobals, PKG, VL_CONFIG, TS_CONFIG, };
 //# sourceMappingURL=index.d.ts.map

package/lib/types/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAcA,QAAA,MAAM,QAAQ,GAAI,UAAU,MAAM,uBAA2C,CAAA;AAE7E,QAAA,MAAM,cAAc,GAAI,UAAU,MAAM,KAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CA4B5D,CAAA;AA2ED,QAAA,MAAM,eAAe,GAClB,UAAU,MAAM,MAChB,KAAK,MAAM,EAAE,iBAAiB,QAI9B,CAAA;AAEH,QAAA,MAAM,iBAAiB,cAaG,MAAM;;iBANf,MAAM,iBAAiB,GAAG;mBAExB,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;CAWrC,CAAA;AAED,QAAA,MAAM,WAAW,GAAI,SAAS,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,2BAOjD,CAAA;AAEH,QAAA,MAAM,GAAG,qBAAe,CAAA;AACxB,QAAA,MAAM,SAAS,QAnBW,MAAM;;iBANf,MAAM,iBAAiB,GAAG;mBAExB,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;CAuBD,CAAA;AACrC,QAAA,MAAM,SAAS,qBAAuC,CAAA;AAEtD,OAAO,EACL,QAAQ,EACR,eAAe,EACf,cAAc,EACd,iBAAiB,EACjB,WAAW,EACX,GAAG,EACH,SAAS,EACT,SAAS,GACV,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AA8EA,QAAA,MAAM,QAAQ,GAAI,UAAU,MAAM,uBAAyB,CAAA;AAY3D,QAAA,MAAM,cAAc,GAAI,UAAU,MAAM,KAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAiB5D,CAAA;AAgGD,QAAA,MAAM,eAAe,GAClB,UAAU,MAAM,MAChB,KAAK,MAAM,EAAE,iBAAiB,QAI9B,CAAA;AAEH,QAAA,MAAM,iBAAiB,cAaG,MAAM;;iBANf,MAAM,iBAAiB,GAAG;mBAExB,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;CAWrC,CAAA;AAED,QAAA,MAAM,YAAY,GAAI,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,QAAQ,CAAC,KAAG,CAAW,CAAA;AAE5E,QAAA,MAAM,WAAW,GAAI,SAAS,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,2BAOjD,CAAA;AAEH,QAAA,MAAM,GAAG,qBAAe,CAAA;AACxB,QAAA,MAAM,SAAS,QArBW,MAAM;;iBANf,MAAM,iBAAiB,GAAG;mBAExB,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;CAyBD,CAAA;AACrC,QAAA,MAAM,SAAS,qBAAuC,CAAA;AAEtD,OAAO,EACL,YAAY,EACZ,QAAQ,EACR,eAAe,EACf,cAAc,EACd,iBAAiB,EACjB,WAAW,EACX,GAAG,EACH,SAAS,EACT,SAAS,GACV,CAAA"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vitus-labs/tools-core",
-  "version": "1.8.1-alpha.0+120486e",
+  "version": "1.8.1-alpha.2+6f381e3",
   "license": "MIT",
   "repository": {
     "type": "git",
@@ -29,14 +29,9 @@
     "build": "tsc",
     "typecheck": "tsc --noEmit"
   },
-  "dependencies": {
-    "find-up": "^8.0.0",
-    "lodash-es": "^4.17.23"
-  },
   "devDependencies": {
-    "@types/lodash-es": "^4.17.12",
-    "@vitus-labs/tools-typescript": "1.8.1-alpha.0+120486e",
+    "@vitus-labs/tools-typescript": "1.8.1-alpha.2+6f381e3",
     "typescript": "^5.9.3"
   },
-  "gitHead": "120486efcc0272ae215bd365af859e66ae0830d3"
+  "gitHead": "6f381e35e5829bc1fae660817f19bfa5098674d6"
 }

package/src/index.test.ts

@@ -1,13 +1,13 @@
 import { beforeEach, describe, expect, it, vi } from 'vitest'
 
-const mockFindUpSync = vi.fn()
-vi.mock('find-up', () => ({
-  findUpSync: mockFindUpSync,
-}))
-
+const mockStatSync = vi.fn()
 const mockReadFileSync = vi.fn()
 vi.mock('node:fs', () => ({
-  default: { readFileSync: mockReadFileSync },
+  default: {
+    statSync: mockStatSync,
+    readFileSync: mockReadFileSync,
+  },
+  statSync: mockStatSync,
   readFileSync: mockReadFileSync,
 }))
 
@@ -16,25 +16,32 @@ vi.mock('node:module', () => ({
   createRequire: vi.fn(() => mockRequireFn),
 }))
 
+// Helper: make specific paths "exist" for findFileUp
+const makeFilesExist = (paths: string[]) => {
+  mockStatSync.mockImplementation((filePath: string) => {
+    if (paths.includes(filePath)) return { isFile: () => true }
+    throw new Error('ENOENT')
+  })
+}
+
 // Default mock setup that satisfies module-level getPkgData() —
 // package.json must always be found with a valid `name` field,
 // otherwise camelspaceBundleName(undefined) crashes at import time.
 const setupDefaultMocks = () => {
-  mockFindUpSync.mockImplementation((filename: string) => {
-    if (filename === 'package.json') return '/mock/package.json'
-    return undefined
-  })
-  mockRequireFn.mockImplementation((path: string) => {
-    if (path === '/mock/package.json') return { name: 'mock-pkg' }
+  vi.spyOn(process, 'cwd').mockReturnValue('/mock/project')
+  makeFilesExist(['/mock/project/package.json'])
+  mockRequireFn.mockImplementation((p: string) => {
+    if (p === '/mock/project/package.json') return { name: 'mock-pkg' }
     return null
   })
 }
 
 describe('tools-core', () => {
   beforeEach(() => {
-    mockFindUpSync.mockReset()
+    mockStatSync.mockReset()
     mockReadFileSync.mockReset()
     mockRequireFn.mockReset()
+    vi.restoreAllMocks()
   })
 
   describe('swapGlobals', () => {
@@ -58,6 +65,22 @@ describe('tools-core', () => {
     })
   })
 
+  describe('defineConfig', () => {
+    let defineConfig: <T extends Record<string, any>>(config: T) => T
+
+    beforeEach(async () => {
+      vi.resetModules()
+      setupDefaultMocks()
+      const mod = await import('./index.js')
+      defineConfig = mod.defineConfig
+    })
+
+    it('should return the same config object', () => {
+      const config = { stories: { framework: 'next' } }
+      expect(defineConfig(config)).toBe(config)
+    })
+  })
+
   describe('findFile', () => {
     let findFile: (filename: string) => string | undefined
 
@@ -68,19 +91,17 @@ describe('tools-core', () => {
       findFile = mod.findFile
     })
 
-    it('should call findUpSync with the filename', () => {
-      mockFindUpSync.mockReturnValue('/path/to/file.json')
-      findFile('file.json')
-      expect(mockFindUpSync).toHaveBeenCalledWith('file.json', { type: 'file' })
+    it('should return the path when file is found in cwd', () => {
+      makeFilesExist(['/mock/project/package.json', '/mock/project/some.json'])
+      expect(findFile('some.json')).toBe('/mock/project/some.json')
     })
 
-    it('should return the path when file is found', () => {
-      mockFindUpSync.mockReturnValue('/path/to/file.json')
-      expect(findFile('file.json')).toBe('/path/to/file.json')
+    it('should walk up directories to find the file', () => {
+      makeFilesExist(['/mock/project/package.json', '/mock/some.json'])
+      expect(findFile('some.json')).toBe('/mock/some.json')
     })
 
     it('should return undefined when file is not found', () => {
-      mockFindUpSync.mockReturnValue(undefined)
       expect(findFile('missing.json')).toBeUndefined()
     })
   })
@@ -96,27 +117,46 @@ describe('tools-core', () => {
     })
 
     it('should return empty object when file is not found', () => {
-      mockFindUpSync.mockReturnValue(undefined)
       expect(loadFileToJSON('missing.json')).toEqual({})
     })
 
     it('should load file using require when available', () => {
-      mockFindUpSync.mockReturnValue('/path/to/config.js')
-      mockRequireFn.mockReturnValue({ key: 'value' })
+      makeFilesExist(['/mock/project/package.json', '/mock/project/config.js'])
+      mockRequireFn.mockImplementation((p: string) => {
+        if (p === '/mock/project/config.js') return { key: 'value' }
+        return null
+      })
       expect(loadFileToJSON('config.js')).toEqual({ key: 'value' })
     })
 
-    it('should return empty object when require returns falsy', () => {
-      mockFindUpSync.mockReturnValue('/path/to/config.json')
-      mockRequireFn.mockReturnValue(null)
-      expect(loadFileToJSON('config.json')).toEqual({})
+    it('should unwrap ESM default export', () => {
+      makeFilesExist(['/mock/project/package.json', '/mock/project/config.mjs'])
+      mockRequireFn.mockImplementation((p: string) => {
+        if (p === '/mock/project/config.mjs')
+          return { default: { key: 'value' } }
+        return null
+      })
+      expect(loadFileToJSON('config.mjs')).toEqual({ key: 'value' })
+    })
+
+    it('should fall back to JSON.parse when require returns empty', () => {
+      makeFilesExist(['/mock/project/package.json', '/mock/project/data.json'])
+      mockRequireFn.mockImplementation((p: string) => {
+        if (p === '/mock/project/data.json') throw new Error('require failed')
+        return null
+      })
+      mockReadFileSync.mockReturnValue('{"parsed": true}')
+      expect(loadFileToJSON('data.json')).toEqual({ parsed: true })
     })
 
     it('should return empty object when require throws', () => {
-      mockFindUpSync.mockReturnValue('/path/to/bad.json')
+      makeFilesExist(['/mock/project/package.json', '/mock/project/bad.json'])
       mockRequireFn.mockImplementation(() => {
         throw new Error('require failed')
       })
+      mockReadFileSync.mockImplementation(() => {
+        throw new Error('read failed')
+      })
       expect(loadFileToJSON('bad.json')).toEqual({})
     })
   })
@@ -134,71 +174,145 @@ describe('tools-core', () => {
     })
 
     it('should return a function that gets a nested config value', () => {
-      mockFindUpSync.mockReturnValue('/path/to/config.js')
-      mockRequireFn.mockReturnValue({ build: { sourceDir: 'src' } })
+      makeFilesExist(['/mock/project/package.json', '/mock/project/config.js'])
+      mockRequireFn.mockImplementation((p: string) => {
+        if (p === '/mock/project/config.js')
+          return { build: { sourceDir: 'src' } }
+        return null
+      })
       const getParam = loadConfigParam('config.js')
       expect(getParam('build.sourceDir')).toBe('src')
     })
 
     it('should return defaultValue when key is not found', () => {
-      mockFindUpSync.mockReturnValue('/path/to/config.js')
-      mockRequireFn.mockReturnValue({})
+      makeFilesExist(['/mock/project/package.json', '/mock/project/config.js'])
+      mockRequireFn.mockImplementation((p: string) => {
+        if (p === '/mock/project/config.js') return {}
+        return null
+      })
       const getParam = loadConfigParam('config.js')
       expect(getParam('missing.key', 'default')).toBe('default')
     })
   })
 
   describe('loadVLToolsConfig', () => {
-    let loadVLToolsConfig: () => (key: string) => any
-
     beforeEach(async () => {
       vi.resetModules()
       setupDefaultMocks()
-      const mod = await import('./index.js')
-      loadVLToolsConfig = mod.loadVLToolsConfig
     })
 
-    it('should return a function that provides .config, .get(), .merge()', () => {
-      mockFindUpSync.mockReturnValue('/path/to/vl-tools.config.js')
-      mockRequireFn.mockReturnValue({ build: { sourceDir: 'src' } })
-      const vlConfig = loadVLToolsConfig()
+    it('should return a function that provides .config, .get(), .merge()', async () => {
+      makeFilesExist([
+        '/mock/project/package.json',
+        '/mock/project/vl-tools.config.js',
+      ])
+      mockRequireFn.mockImplementation((p: string) => {
+        if (p === '/mock/project/package.json') return { name: 'mock-pkg' }
+        if (p === '/mock/project/vl-tools.config.js')
+          return { build: { sourceDir: 'src' } }
+        return null
+      })
+
+      const mod = await import('./index.js')
+      const vlConfig = mod.loadVLToolsConfig()
       const buildConfig = vlConfig('build')
       expect(buildConfig.config).toEqual({ sourceDir: 'src' })
       expect(buildConfig.get('sourceDir')).toBe('src')
     })
 
-    it('should support chained merge calls', () => {
-      mockFindUpSync.mockReturnValue('/path/to/vl-tools.config.js')
-      mockRequireFn.mockReturnValue({ build: { sourceDir: 'src' } })
-      const vlConfig = loadVLToolsConfig()
+    it('should support chained merge calls', async () => {
+      makeFilesExist([
+        '/mock/project/package.json',
+        '/mock/project/vl-tools.config.js',
+      ])
+      mockRequireFn.mockImplementation((p: string) => {
+        if (p === '/mock/project/package.json') return { name: 'mock-pkg' }
+        if (p === '/mock/project/vl-tools.config.js')
+          return { build: { sourceDir: 'src' } }
+        return null
+      })
+
+      const mod = await import('./index.js')
+      const vlConfig = mod.loadVLToolsConfig()
       const merged = vlConfig('build').merge({ outputDir: 'lib' })
       expect(merged.config).toEqual({ sourceDir: 'src', outputDir: 'lib' })
     })
 
-    it('should return empty config when file is not found', () => {
-      mockFindUpSync.mockReturnValue(undefined)
-      const vlConfig = loadVLToolsConfig()
+    it('should return empty config when file is not found', async () => {
+      const mod = await import('./index.js')
+      const vlConfig = mod.loadVLToolsConfig()
       const result = vlConfig('build')
       expect(result.config).toEqual({})
     })
 
-    it('should return default value with get when key is missing', () => {
-      mockFindUpSync.mockReturnValue(undefined)
-      const vlConfig = loadVLToolsConfig()
+    it('should return default value with get when key is missing', async () => {
+      const mod = await import('./index.js')
+      const vlConfig = mod.loadVLToolsConfig()
       const result = vlConfig('build')
       expect(result.get('missing')).toEqual({})
     })
+
+    it('should prefer .mjs over .js config files', async () => {
+      makeFilesExist([
+        '/mock/project/package.json',
+        '/mock/project/vl-tools.config.mjs',
+        '/mock/project/vl-tools.config.js',
+      ])
+      mockRequireFn.mockImplementation((p: string) => {
+        if (p === '/mock/project/package.json') return { name: 'mock-pkg' }
+        if (p === '/mock/project/vl-tools.config.mjs')
+          return { build: { sourceDir: 'mjs-src' } }
+        if (p === '/mock/project/vl-tools.config.js')
+          return { build: { sourceDir: 'js-src' } }
+        return null
+      })
+
+      const mod = await import('./index.js')
+      const vlConfig = mod.loadVLToolsConfig()
+      expect(vlConfig('build').config).toEqual({ sourceDir: 'mjs-src' })
+    })
+
+    it('should cascade configs from root to package (deep merge)', async () => {
+      vi.spyOn(process, 'cwd').mockReturnValue('/mock/packages/ui')
+      makeFilesExist([
+        '/mock/packages/ui/package.json',
+        '/mock/vl-tools.config.js',
+        '/mock/packages/ui/vl-tools.config.js',
+      ])
+      mockRequireFn.mockImplementation((p: string) => {
+        if (p === '/mock/packages/ui/package.json') return { name: 'mock-pkg' }
+        // Root config: base settings
+        if (p === '/mock/vl-tools.config.js')
+          return {
+            stories: { framework: 'vite', port: 6006 },
+            build: { sourceDir: 'src' },
+          }
+        // Package config: override framework only
+        if (p === '/mock/packages/ui/vl-tools.config.js')
+          return { stories: { framework: 'next' } }
+        return null
+      })
+
+      const mod = await import('./index.js')
+      const vlConfig = mod.loadVLToolsConfig()
+      const stories = vlConfig('stories')
+
+      // framework overridden by package config
+      expect(stories.get('framework')).toBe('next')
+      // port inherited from root config
+      expect(stories.get('port')).toBe(6006)
+      // build inherited from root config
+      expect(vlConfig('build').config).toEqual({ sourceDir: 'src' })
+    })
   })
 
   describe('module-level constants', () => {
     it('should export PKG with bundleName from scoped package name', async () => {
       vi.resetModules()
-      mockFindUpSync.mockImplementation((filename: string) => {
-        if (filename === 'package.json') return '/path/to/package.json'
-        return undefined
-      })
-      mockRequireFn.mockImplementation((path: string) => {
-        if (path === '/path/to/package.json') {
+      vi.spyOn(process, 'cwd').mockReturnValue('/path/to')
+      makeFilesExist(['/path/to/package.json'])
+      mockRequireFn.mockImplementation((p: string) => {
+        if (p === '/path/to/package.json') {
           return {
             name: '@test/pkg',
             version: '1.0.0',
@@ -216,12 +330,10 @@ describe('tools-core', () => {
 
     it('should handle simple hyphenated package names in bundleName', async () => {
       vi.resetModules()
-      mockFindUpSync.mockImplementation((filename: string) => {
-        if (filename === 'package.json') return '/path/to/package.json'
-        return undefined
-      })
-      mockRequireFn.mockImplementation((path: string) => {
-        if (path === '/path/to/package.json') {
+      vi.spyOn(process, 'cwd').mockReturnValue('/path/to')
+      makeFilesExist(['/path/to/package.json'])
+      mockRequireFn.mockImplementation((p: string) => {
+        if (p === '/path/to/package.json') {
           return { name: 'my-cool-library' }
         }
         return null
@@ -233,12 +345,10 @@ describe('tools-core', () => {
 
     it('should include peerDependencies in externalDependencies', async () => {
       vi.resetModules()
-      mockFindUpSync.mockImplementation((filename: string) => {
-        if (filename === 'package.json') return '/path/to/package.json'
-        return undefined
-      })
-      mockRequireFn.mockImplementation((path: string) => {
-        if (path === '/path/to/package.json') {
+      vi.spyOn(process, 'cwd').mockReturnValue('/path/to')
+      makeFilesExist(['/path/to/package.json'])
+      mockRequireFn.mockImplementation((p: string) => {
+        if (p === '/path/to/package.json') {
           return {
             name: 'my-lib',
             peerDependencies: { 'styled-components': '^6' },
@@ -260,14 +370,14 @@ describe('tools-core', () => {
 
     it('should export TS_CONFIG from tsconfig.json', async () => {
       vi.resetModules()
-      mockFindUpSync.mockImplementation((filename: string) => {
-        if (filename === 'package.json') return '/mock/package.json'
-        if (filename === 'tsconfig.json') return '/path/to/tsconfig.json'
-        return undefined
-      })
-      mockRequireFn.mockImplementation((path: string) => {
-        if (path === '/mock/package.json') return { name: 'mock-pkg' }
-        if (path === '/path/to/tsconfig.json') {
+      vi.spyOn(process, 'cwd').mockReturnValue('/mock/project')
+      makeFilesExist([
+        '/mock/project/package.json',
+        '/mock/project/tsconfig.json',
+      ])
+      mockRequireFn.mockImplementation((p: string) => {
+        if (p === '/mock/project/package.json') return { name: 'mock-pkg' }
+        if (p === '/mock/project/tsconfig.json') {
           return { compilerOptions: { strict: true } }
         }
         return null

package/src/index.ts

@@ -1,47 +1,110 @@
 import fs from 'node:fs'
 import { createRequire } from 'node:module'
-import { findUpSync } from 'find-up'
-import { get as _get, merge } from 'lodash-es'
+import path from 'node:path'
 
-const VITUS_LABS_FILE_NAME = 'vl-tools.config.js'
+const VL_CONFIG_FILES = ['vl-tools.config.mjs', 'vl-tools.config.js']
 const PACKAGE_FILE_NAME = 'package.json'
 const TYPESCRIPT_FILE_NAME = 'tsconfig.json'
 
 const require = createRequire(import.meta.url)
 
+// --------------------------------------------------------
+// Utility helpers (replaces lodash-es and find-up)
+// --------------------------------------------------------
+const get = (obj: any, dotPath: string, defaultValue: any = {}): any => {
+  const keys = dotPath.split('.')
+  let result = obj
+
+  for (const key of keys) {
+    if (result == null) return defaultValue
+    result = result[key]
+  }
+
+  return result === undefined ? defaultValue : result
+}
+
+const deepMerge = (
+  target: Record<string, any>,
+  source: Record<string, any>,
+): Record<string, any> => {
+  const result = { ...target }
+
+  for (const key of Object.keys(source)) {
+    const srcVal = source[key]
+    const tgtVal = result[key]
+
+    if (
+      typeof srcVal === 'object' &&
+      srcVal !== null &&
+      !Array.isArray(srcVal) &&
+      typeof tgtVal === 'object' &&
+      tgtVal !== null &&
+      !Array.isArray(tgtVal)
+    ) {
+      result[key] = deepMerge(tgtVal, srcVal)
+    } else {
+      result[key] = srcVal
+    }
+  }
+
+  return result
+}
+
+const findFileUp = (
+  names: string | string[],
+  cwd = process.cwd(),
+): string | undefined => {
+  const fileNames = Array.isArray(names) ? names : [names]
+  let dir = path.resolve(cwd)
+
+  while (true) {
+    for (const name of fileNames) {
+      const filePath = path.join(dir, name)
+      try {
+        if (fs.statSync(filePath).isFile()) return filePath
+      } catch (_e) {
+        // file doesn't exist, continue
+      }
+    }
+
+    const parent = path.dirname(dir)
+    if (parent === dir) return undefined
+    dir = parent
+  }
+}
+
 // --------------------------------------------------------
 // FIND & READ file helpers
 // --------------------------------------------------------
-const findFile = (filename: string) => findUpSync(filename, { type: 'file' })
+const findFile = (filename: string) => findFileUp(filename)
+
+const loadModule = (filePath: string): Record<string, any> => {
+  try {
+    const imported = require(filePath)
+    // Handle ESM default export wrapping
+    return imported?.default ?? imported ?? {}
+  } catch (_e) {
+    return {}
+  }
+}
 
 const loadFileToJSON = (filename: string): Record<string, any> => {
   const file = findFile(filename)
 
   if (!file) return {}
 
-  let data: Record<string, any> = {}
-
   // try to read an exported module first
-  try {
-    const importedFile = require(file)
+  const data = loadModule(file)
+  if (data && Object.keys(data).length > 0) return data
 
-    if (importedFile) {
-      data = importedFile
-    }
+  // try to read a plain json file like tsconfig.json
+  try {
+    return JSON.parse(fs.readFileSync(file, 'utf-8'))
   } catch (_e) {
     // ignore error
   }
 
-  // try to read a plain json file like tsconfig.json
-  if (!data) {
-    try {
-      data = JSON.parse(fs.readFileSync(file, 'utf-8'))
-    } catch (_e) {
-      // ignore error
-    }
-  }
-
-  return data
+  return {}
 }
 
 // --------------------------------------------------------
@@ -70,10 +133,6 @@ const getDependenciesList = (types: any) => {
   return result
 }
 
-// parse namespace name
-// const parseNamespace = (name) =>
-//   name.startsWith('@') ? name.split('/')[0] : ''
-
 // converts package name to umd or iife valid format
 // example: napespace-package-name => namespacePackageName
 const camelspaceBundleName = (name: string) => {
@@ -96,14 +155,9 @@ const camelspaceBundleName = (name: string) => {
 const getPkgData = (): Record<string, any> => {
   const pkg = getPackageJSON()
   const { name } = pkg
-  // const namespace = parseNamespace(name)
 
   return {
     ...pkg,
-    // nameWithoutPrefix: name.replace(namespace, '').replace('/', ''),
-    // namespace,
-    // namespaceName: namespace.replace('@', ''),
-    // rootPath: findFilePath('package.json'),
     bundleName: camelspaceBundleName(name),
     externalDependencies: getDependenciesList([
       'dependencies',
@@ -114,15 +168,45 @@ const getPkgData = (): Record<string, any> => {
 
 // --------------------------------------------------------
 // LOAD EXTERNAL CONFIGURATION
+// Cascading: finds all vl-tools.config.{mjs,js} files from
+// cwd upward, then deep-merges them (root first, closest
+// package config wins).
 // --------------------------------------------------------
-const getExternalConfig = () => loadFileToJSON(VITUS_LABS_FILE_NAME)
+const findAllConfigFiles = (): string[] => {
+  const files: string[] = []
+  let cwd = process.cwd()
+
+  while (true) {
+    const file = findFileUp(VL_CONFIG_FILES, cwd)
+    if (!file) break
+    files.push(file)
+    const parentDir = path.dirname(path.dirname(file))
+    if (parentDir === path.dirname(file)) break
+    cwd = parentDir
+  }
+
+  // Root config first, closest config last (overrides)
+  return files.reverse()
+}
+
+const getExternalConfig = (): Record<string, any> => {
+  const files = findAllConfigFiles()
+  let config: Record<string, any> = {}
+
+  for (const file of files) {
+    const loaded = loadModule(file)
+    config = deepMerge(config, loaded)
+  }
+
+  return config
+}
 
 const loadConfigParam =
   (filename: string) =>
   (key: string, defaultValue = {}) => {
     const externalConfig = loadFileToJSON(filename)
 
-    return _get(externalConfig, key, defaultValue)
+    return get(externalConfig, key, defaultValue)
   }
 
 const loadVLToolsConfig = () => {
@@ -133,13 +217,13 @@ const loadVLToolsConfig = () => {
       return object
     },
     get: (param: string, defaultValue?: any) =>
-      _get(object, param, defaultValue || {}),
+      get(object, param, defaultValue || {}),
     merge: (param: Record<string, any>) =>
-      cloneAndEnhance(merge(object, param)),
+      cloneAndEnhance(deepMerge(param, object)),
   })
 
   const getOutput = (key: string) => {
-    const result = _get(externalConfig, key, {})
+    const result = get(externalConfig, key, {})
 
     return cloneAndEnhance(result)
   }
@@ -147,6 +231,8 @@ const loadVLToolsConfig = () => {
   return getOutput
 }
 
+const defineConfig = <T extends Record<string, any>>(config: T): T => config
+
 const swapGlobals = (globals: Record<string, string>) =>
   Object.entries(globals).reduce<Record<string, string>>(
     (acc, [key, value]) => {
@@ -161,6 +247,7 @@ const VL_CONFIG = loadVLToolsConfig()
 const TS_CONFIG = loadFileToJSON(TYPESCRIPT_FILE_NAME)
 
 export {
+  defineConfig,
   findFile,
   loadConfigParam,
   loadFileToJSON,