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

package/lib/index.js

@@ -1,10 +1,9 @@
 import fs from 'node:fs';
-import { createRequire } from 'node:module';
 import path from 'node:path';
-const VL_CONFIG_FILES = ['vl-tools.config.mjs', 'vl-tools.config.js'];
+import { pathToFileURL } from 'node:url';
+const VL_CONFIG_FILES = ['vl-tools.config.mjs'];
 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)
 // --------------------------------------------------------
@@ -61,40 +60,31 @@ const findFileUp = (names, cwd = process.cwd()) => {
 // FIND & READ file helpers
 // --------------------------------------------------------
 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 {};
-    // 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 {
         return JSON.parse(fs.readFileSync(file, 'utf-8'));
     }
     catch (_e) {
-        // ignore error
+        return {};
+    }
+};
+const loadModuleAsync = async (filePath) => {
+    try {
+        const mod = await import(pathToFileURL(filePath).href);
+        return mod?.default ?? mod ?? {};
+    }
+    catch (e) {
+        console.warn(`[tools-core] Failed to load config: ${filePath}\n  ${e.message}`);
+        return {};
     }
-    return {};
 };
 // --------------------------------------------------------
 // GET PACKAGE.JSON info
 // --------------------------------------------------------
-const getPackageJSON = () => {
-    const data = loadFileToJSON(PACKAGE_FILE_NAME);
-    return data;
-};
+const getPackageJSON = () => loadFileToJSON(PACKAGE_FILE_NAME);
 // --------------------------------------------------------
 // PACKAGE.json parsing functions
 // --------------------------------------------------------
@@ -136,7 +126,7 @@ const getPkgData = () => {
 };
 // --------------------------------------------------------
 // LOAD EXTERNAL CONFIGURATION
-// Cascading: finds all vl-tools.config.{mjs,js} files from
+// Cascading: finds all vl-tools.config.mjs files from
 // cwd upward, then deep-merges them (root first, closest
 // package config wins).
 // --------------------------------------------------------
@@ -156,11 +146,11 @@ const findAllConfigFiles = () => {
     // Root config first, closest config last (overrides)
     return files.reverse();
 };
-const getExternalConfig = () => {
+const getExternalConfig = async () => {
     const files = findAllConfigFiles();
     let config = {};
     for (const file of files) {
-        const loaded = loadModule(file);
+        const loaded = await loadModuleAsync(file);
         config = deepMerge(config, loaded);
     }
     return config;
@@ -169,8 +159,8 @@ const loadConfigParam = (filename) => (key, defaultValue = {}) => {
     const externalConfig = loadFileToJSON(filename);
     return get(externalConfig, key, defaultValue);
 };
-const loadVLToolsConfig = () => {
-    const externalConfig = getExternalConfig();
+const loadVLToolsConfig = async () => {
+    const externalConfig = await getExternalConfig();
     const cloneAndEnhance = (object) => ({
         get config() {
             return object;
@@ -190,7 +180,7 @@ const swapGlobals = (globals) => Object.entries(globals).reduce((acc, [key, valu
     return acc;
 }, {});
 const PKG = getPkgData();
-const VL_CONFIG = loadVLToolsConfig();
+const VL_CONFIG = await loadVLToolsConfig();
 const TS_CONFIG = loadFileToJSON(TYPESCRIPT_FILE_NAME);
 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":"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"}

package/lib/types/index.d.ts

@@ -1,11 +1,11 @@
 declare const findFile: (filename: string) => string | undefined;
 declare const loadFileToJSON: (filename: string) => Record<string, any>;
 declare const loadConfigParam: (filename: string) => (key: string, defaultValue?: {}) => any;
-declare const loadVLToolsConfig: () => (key: string) => {
+declare const loadVLToolsConfig: () => Promise<(key: string) => {
     readonly config: Record<string, any>;
     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>;

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

@@ -1 +1 @@
-{"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AA4EA,QAAA,MAAM,QAAQ,GAAI,UAAU,MAAM,uBAAyB,CAAA;AAE3D,QAAA,MAAM,cAAc,GAAI,UAAU,MAAM,KAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAS5D,CAAA;AA0GD,QAAA,MAAM,eAAe,GAClB,UAAU,MAAM,MAChB,KAAK,MAAM,EAAE,iBAAiB,QAI9B,CAAA;AAEH,QAAA,MAAM,iBAAiB,sBAaG,MAAM;;iBANf,MAAM,iBAAiB,GAAG;mBAExB,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;EAWrC,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;CAyBK,CAAA;AAC3C,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.2+6f381e3",
+  "version": "1.9.0",
   "license": "MIT",
   "repository": {
     "type": "git",
@@ -30,8 +30,8 @@
     "typecheck": "tsc --noEmit"
   },
   "devDependencies": {
-    "@vitus-labs/tools-typescript": "1.8.1-alpha.2+6f381e3",
+    "@vitus-labs/tools-typescript": "1.9.0",
     "typescript": "^5.9.3"
   },
-  "gitHead": "6f381e35e5829bc1fae660817f19bfa5098674d6"
+  "gitHead": "167c6e3a00ad6e9bcec14dfdb7aaef3ffbdb42e9"
 }

package/src/index.test.ts

@@ -1,300 +1,260 @@
-import { beforeEach, describe, expect, it, vi } from 'vitest'
-
-const mockStatSync = vi.fn()
-const mockReadFileSync = vi.fn()
-vi.mock('node:fs', () => ({
-  default: {
-    statSync: mockStatSync,
-    readFileSync: mockReadFileSync,
-  },
-  statSync: mockStatSync,
-  readFileSync: mockReadFileSync,
-}))
-
-const mockRequireFn = vi.fn()
-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')
-  })
+import { mkdirSync, rmSync, writeFileSync } from 'node:fs'
+import { tmpdir } from 'node:os'
+import path from 'node:path'
+import { afterAll, beforeEach, describe, expect, it, vi } from 'vitest'
+
+const BASE_TMP = path.join(tmpdir(), `vl-core-test-${Date.now()}`)
+let testId = 0
+
+const createTestDir = (opts: {
+  packageJson?: Record<string, any>
+  tsConfig?: Record<string, any>
+  vlConfig?: Record<string, any>
+  parent?: { vlConfig?: Record<string, any> }
+}) => {
+  testId++
+  const root = path.join(BASE_TMP, `t${testId}`)
+  const projectDir = opts.parent ? path.join(root, 'packages', 'child') : root
+
+  mkdirSync(projectDir, { recursive: true })
+
+  writeFileSync(
+    path.join(projectDir, 'package.json'),
+    JSON.stringify(opts.packageJson ?? { name: 'test-pkg' }),
+  )
+
+  if (opts.tsConfig) {
+    writeFileSync(
+      path.join(projectDir, 'tsconfig.json'),
+      JSON.stringify(opts.tsConfig),
+    )
+  }
+
+  if (opts.vlConfig) {
+    writeFileSync(
+      path.join(projectDir, 'vl-tools.config.mjs'),
+      `export default ${JSON.stringify(opts.vlConfig)}`,
+    )
+  }
+
+  if (opts.parent?.vlConfig) {
+    writeFileSync(
+      path.join(root, 'vl-tools.config.mjs'),
+      `export default ${JSON.stringify(opts.parent.vlConfig)}`,
+    )
+  }
+
+  return projectDir
 }
 
-// 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 = () => {
-  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
-  })
-}
+afterAll(() => {
+  rmSync(BASE_TMP, { recursive: true, force: true })
+})
 
 describe('tools-core', () => {
   beforeEach(() => {
-    mockStatSync.mockReset()
-    mockReadFileSync.mockReset()
-    mockRequireFn.mockReset()
     vi.restoreAllMocks()
   })
 
   describe('swapGlobals', () => {
-    let swapGlobals: (globals: Record<string, string>) => Record<string, string>
-
-    beforeEach(async () => {
+    it('should invert key/value pairs', async () => {
       vi.resetModules()
-      setupDefaultMocks()
-      const mod = await import('./index.js')
-      swapGlobals = mod.swapGlobals
-    })
+      const dir = createTestDir({})
+      vi.spyOn(process, 'cwd').mockReturnValue(dir)
 
-    it('should invert key/value pairs', () => {
+      const mod = await import('./index.js')
       const input = { react: 'React', 'react-dom': 'ReactDOM' }
-      const result = swapGlobals(input)
-      expect(result).toEqual({ React: 'react', ReactDOM: 'react-dom' })
+      expect(mod.swapGlobals(input)).toEqual({
+        React: 'react',
+        ReactDOM: 'react-dom',
+      })
     })
 
-    it('should return empty object for empty input', () => {
-      expect(swapGlobals({})).toEqual({})
+    it('should return empty object for empty input', async () => {
+      vi.resetModules()
+      const dir = createTestDir({})
+      vi.spyOn(process, 'cwd').mockReturnValue(dir)
+
+      const mod = await import('./index.js')
+      expect(mod.swapGlobals({})).toEqual({})
     })
   })
 
   describe('defineConfig', () => {
-    let defineConfig: <T extends Record<string, any>>(config: T) => T
-
-    beforeEach(async () => {
+    it('should return the same config object', async () => {
       vi.resetModules()
-      setupDefaultMocks()
-      const mod = await import('./index.js')
-      defineConfig = mod.defineConfig
-    })
+      const dir = createTestDir({})
+      vi.spyOn(process, 'cwd').mockReturnValue(dir)
 
-    it('should return the same config object', () => {
+      const mod = await import('./index.js')
       const config = { stories: { framework: 'next' } }
-      expect(defineConfig(config)).toBe(config)
+      expect(mod.defineConfig(config)).toBe(config)
     })
   })
 
   describe('findFile', () => {
-    let findFile: (filename: string) => string | undefined
-
-    beforeEach(async () => {
+    it('should return the path when file is found in cwd', async () => {
       vi.resetModules()
-      setupDefaultMocks()
+      const dir = createTestDir({ tsConfig: { strict: true } })
+      vi.spyOn(process, 'cwd').mockReturnValue(dir)
+
       const mod = await import('./index.js')
-      findFile = mod.findFile
+      expect(mod.findFile('tsconfig.json')).toBe(
+        path.join(dir, 'tsconfig.json'),
+      )
     })
 
-    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 walk up directories to find the file', async () => {
+      vi.resetModules()
+      testId++
+      const root = path.join(BASE_TMP, `t${testId}`)
+      const child = path.join(root, 'sub', 'deep')
+      mkdirSync(child, { recursive: true })
+      writeFileSync(
+        path.join(child, 'package.json'),
+        JSON.stringify({ name: 'deep' }),
+      )
+      writeFileSync(path.join(root, 'target.json'), '{}')
+      vi.spyOn(process, 'cwd').mockReturnValue(child)
 
-    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')
+      const mod = await import('./index.js')
+      expect(mod.findFile('target.json')).toBe(path.join(root, 'target.json'))
     })
 
-    it('should return undefined when file is not found', () => {
-      expect(findFile('missing.json')).toBeUndefined()
+    it('should return undefined when file is not found', async () => {
+      vi.resetModules()
+      const dir = createTestDir({})
+      vi.spyOn(process, 'cwd').mockReturnValue(dir)
+
+      const mod = await import('./index.js')
+      expect(mod.findFile('nonexistent.xyz')).toBeUndefined()
     })
   })
 
   describe('loadFileToJSON', () => {
-    let loadFileToJSON: (filename: string) => Record<string, any>
-
-    beforeEach(async () => {
+    it('should return empty object when file is not found', async () => {
       vi.resetModules()
-      setupDefaultMocks()
-      const mod = await import('./index.js')
-      loadFileToJSON = mod.loadFileToJSON
-    })
+      const dir = createTestDir({})
+      vi.spyOn(process, 'cwd').mockReturnValue(dir)
 
-    it('should return empty object when file is not found', () => {
-      expect(loadFileToJSON('missing.json')).toEqual({})
+      const mod = await import('./index.js')
+      expect(mod.loadFileToJSON('missing.json')).toEqual({})
     })
 
-    it('should load file using require when available', () => {
-      makeFilesExist(['/mock/project/package.json', '/mock/project/config.js'])
-      mockRequireFn.mockImplementation((p: string) => {
-        if (p === '/mock/project/config.js') return { key: 'value' }
-        return null
+    it('should parse JSON files', async () => {
+      vi.resetModules()
+      const dir = createTestDir({
+        tsConfig: { compilerOptions: { strict: true } },
       })
-      expect(loadFileToJSON('config.js')).toEqual({ key: 'value' })
-    })
+      vi.spyOn(process, 'cwd').mockReturnValue(dir)
 
-    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
+      const mod = await import('./index.js')
+      expect(mod.loadFileToJSON('tsconfig.json')).toEqual({
+        compilerOptions: { strict: true },
       })
-      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 for invalid JSON', async () => {
+      vi.resetModules()
+      const dir = createTestDir({})
+      writeFileSync(path.join(dir, 'bad.json'), 'not json{{{')
+      vi.spyOn(process, 'cwd').mockReturnValue(dir)
 
-    it('should return empty object when require throws', () => {
-      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({})
+      const mod = await import('./index.js')
+      expect(mod.loadFileToJSON('bad.json')).toEqual({})
     })
   })
 
   describe('loadConfigParam', () => {
-    let loadConfigParam: (
-      filename: string,
-    ) => (key: string, defaultValue?: any) => any
-
-    beforeEach(async () => {
+    it('should return a function that gets a nested config value', async () => {
       vi.resetModules()
-      setupDefaultMocks()
-      const mod = await import('./index.js')
-      loadConfigParam = mod.loadConfigParam
-    })
+      const dir = createTestDir({})
+      writeFileSync(
+        path.join(dir, 'config.json'),
+        JSON.stringify({ build: { sourceDir: 'src' } }),
+      )
+      vi.spyOn(process, 'cwd').mockReturnValue(dir)
 
-    it('should return a function that gets a nested config value', () => {
-      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')
+      const mod = await import('./index.js')
+      const getParam = mod.loadConfigParam('config.json')
       expect(getParam('build.sourceDir')).toBe('src')
     })
 
-    it('should return defaultValue when key is not found', () => {
-      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')
+    it('should return defaultValue when key is not found', async () => {
+      vi.resetModules()
+      const dir = createTestDir({})
+      writeFileSync(path.join(dir, 'config.json'), JSON.stringify({}))
+      vi.spyOn(process, 'cwd').mockReturnValue(dir)
+
+      const mod = await import('./index.js')
+      const getParam = mod.loadConfigParam('config.json')
       expect(getParam('missing.key', 'default')).toBe('default')
     })
   })
 
   describe('loadVLToolsConfig', () => {
-    beforeEach(async () => {
+    it('should load .mjs config and provide .config, .get(), .merge()', async () => {
       vi.resetModules()
-      setupDefaultMocks()
-    })
-
-    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 dir = createTestDir({
+        vlConfig: { build: { sourceDir: 'src' } },
       })
+      vi.spyOn(process, 'cwd').mockReturnValue(dir)
 
       const mod = await import('./index.js')
-      const vlConfig = mod.loadVLToolsConfig()
+      const vlConfig = await mod.loadVLToolsConfig()
       const buildConfig = vlConfig('build')
       expect(buildConfig.config).toEqual({ sourceDir: 'src' })
       expect(buildConfig.get('sourceDir')).toBe('src')
     })
 
     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
+      vi.resetModules()
+      const dir = createTestDir({
+        vlConfig: { build: { sourceDir: 'src' } },
       })
+      vi.spyOn(process, 'cwd').mockReturnValue(dir)
 
       const mod = await import('./index.js')
-      const vlConfig = mod.loadVLToolsConfig()
+      const vlConfig = await 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', async () => {
-      const mod = await import('./index.js')
-      const vlConfig = mod.loadVLToolsConfig()
-      const result = vlConfig('build')
-      expect(result.config).toEqual({})
-    })
+    it('should return empty config when no config file exists', async () => {
+      vi.resetModules()
+      const dir = createTestDir({})
+      vi.spyOn(process, 'cwd').mockReturnValue(dir)
 
-    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({})
+      const vlConfig = await mod.loadVLToolsConfig()
+      expect(vlConfig('build').config).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
-      })
+    it('should return default value with get when key is missing', async () => {
+      vi.resetModules()
+      const dir = createTestDir({})
+      vi.spyOn(process, 'cwd').mockReturnValue(dir)
 
       const mod = await import('./index.js')
-      const vlConfig = mod.loadVLToolsConfig()
-      expect(vlConfig('build').config).toEqual({ sourceDir: 'mjs-src' })
+      const vlConfig = await mod.loadVLToolsConfig()
+      expect(vlConfig('build').get('missing')).toEqual({})
     })
 
     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 {
+      vi.resetModules()
+      const dir = createTestDir({
+        vlConfig: { stories: { framework: 'next' } },
+        parent: {
+          vlConfig: {
             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
+          },
+        },
       })
+      vi.spyOn(process, 'cwd').mockReturnValue(dir)
 
       const mod = await import('./index.js')
-      const vlConfig = mod.loadVLToolsConfig()
+      const vlConfig = await mod.loadVLToolsConfig()
       const stories = vlConfig('stories')
 
       // framework overridden by package config
@@ -309,18 +269,14 @@ describe('tools-core', () => {
   describe('module-level constants', () => {
     it('should export PKG with bundleName from scoped package name', async () => {
       vi.resetModules()
-      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',
-            dependencies: { react: '^19' },
-          }
-        }
-        return null
+      const dir = createTestDir({
+        packageJson: {
+          name: '@test/pkg',
+          version: '1.0.0',
+          dependencies: { react: '^19' },
+        },
       })
+      vi.spyOn(process, 'cwd').mockReturnValue(dir)
 
       const mod = await import('./index.js')
       expect(mod.PKG.name).toBe('@test/pkg')
@@ -330,14 +286,10 @@ describe('tools-core', () => {
 
     it('should handle simple hyphenated package names in bundleName', async () => {
       vi.resetModules()
-      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
+      const dir = createTestDir({
+        packageJson: { name: 'my-cool-library' },
       })
+      vi.spyOn(process, 'cwd').mockReturnValue(dir)
 
       const mod = await import('./index.js')
       expect(mod.PKG.bundleName).toBe('myCoolLibrary')
@@ -345,17 +297,13 @@ describe('tools-core', () => {
 
     it('should include peerDependencies in externalDependencies', async () => {
       vi.resetModules()
-      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' },
-          }
-        }
-        return null
+      const dir = createTestDir({
+        packageJson: {
+          name: 'my-lib',
+          peerDependencies: { 'styled-components': '^6' },
+        },
       })
+      vi.spyOn(process, 'cwd').mockReturnValue(dir)
 
       const mod = await import('./index.js')
       expect(mod.PKG.externalDependencies).toContain('styled-components')
@@ -363,28 +311,35 @@ describe('tools-core', () => {
 
     it('should export VL_CONFIG as a function', async () => {
       vi.resetModules()
-      setupDefaultMocks()
+      const dir = createTestDir({})
+      vi.spyOn(process, 'cwd').mockReturnValue(dir)
+
       const mod = await import('./index.js')
       expect(typeof mod.VL_CONFIG).toBe('function')
     })
 
     it('should export TS_CONFIG from tsconfig.json', async () => {
       vi.resetModules()
-      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
+      const dir = createTestDir({
+        tsConfig: { compilerOptions: { strict: true } },
       })
+      vi.spyOn(process, 'cwd').mockReturnValue(dir)
 
       const mod = await import('./index.js')
       expect(mod.TS_CONFIG).toEqual({ compilerOptions: { strict: true } })
     })
+
+    it('should resolve VL_CONFIG from .mjs config at module level', async () => {
+      vi.resetModules()
+      const dir = createTestDir({
+        vlConfig: { stories: { framework: 'next', port: 3000 } },
+      })
+      vi.spyOn(process, 'cwd').mockReturnValue(dir)
+
+      const mod = await import('./index.js')
+      const stories = mod.VL_CONFIG('stories')
+      expect(stories.get('framework')).toBe('next')
+      expect(stories.get('port')).toBe(3000)
+    })
   })
 })

package/src/index.ts

@@ -1,13 +1,11 @@
 import fs from 'node:fs'
-import { createRequire } from 'node:module'
 import path from 'node:path'
+import { pathToFileURL } from 'node:url'
 
-const VL_CONFIG_FILES = ['vl-tools.config.mjs', 'vl-tools.config.js']
+const VL_CONFIG_FILES = ['vl-tools.config.mjs']
 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)
 // --------------------------------------------------------
@@ -78,43 +76,35 @@ const findFileUp = (
 // --------------------------------------------------------
 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 {}
 
-  // 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 {
     return JSON.parse(fs.readFileSync(file, 'utf-8'))
   } catch (_e) {
-    // ignore error
+    return {}
   }
+}
 
-  return {}
+const loadModuleAsync = async (
+  filePath: string,
+): Promise<Record<string, any>> => {
+  try {
+    const mod = await import(pathToFileURL(filePath).href)
+    return mod?.default ?? mod ?? {}
+  } catch (e: any) {
+    console.warn(
+      `[tools-core] Failed to load config: ${filePath}\n  ${e.message}`,
+    )
+    return {}
+  }
 }
 
 // --------------------------------------------------------
 // GET PACKAGE.JSON info
 // --------------------------------------------------------
-const getPackageJSON = () => {
-  const data = loadFileToJSON(PACKAGE_FILE_NAME)
-
-  return data
-}
+const getPackageJSON = () => loadFileToJSON(PACKAGE_FILE_NAME)
 
 // --------------------------------------------------------
 // PACKAGE.json parsing functions
@@ -168,7 +158,7 @@ const getPkgData = (): Record<string, any> => {
 
 // --------------------------------------------------------
 // LOAD EXTERNAL CONFIGURATION
-// Cascading: finds all vl-tools.config.{mjs,js} files from
+// Cascading: finds all vl-tools.config.mjs files from
 // cwd upward, then deep-merges them (root first, closest
 // package config wins).
 // --------------------------------------------------------
@@ -189,12 +179,12 @@ const findAllConfigFiles = (): string[] => {
   return files.reverse()
 }
 
-const getExternalConfig = (): Record<string, any> => {
+const getExternalConfig = async (): Promise<Record<string, any>> => {
   const files = findAllConfigFiles()
   let config: Record<string, any> = {}
 
   for (const file of files) {
-    const loaded = loadModule(file)
+    const loaded = await loadModuleAsync(file)
     config = deepMerge(config, loaded)
   }
 
@@ -209,8 +199,8 @@ const loadConfigParam =
     return get(externalConfig, key, defaultValue)
   }
 
-const loadVLToolsConfig = () => {
-  const externalConfig = getExternalConfig()
+const loadVLToolsConfig = async () => {
+  const externalConfig = await getExternalConfig()
 
   const cloneAndEnhance = (object: Record<string, any>) => ({
     get config() {
@@ -243,7 +233,7 @@ const swapGlobals = (globals: Record<string, string>) =>
   )
 
 const PKG = getPkgData()
-const VL_CONFIG = loadVLToolsConfig()
+const VL_CONFIG = await loadVLToolsConfig()
 const TS_CONFIG = loadFileToJSON(TYPESCRIPT_FILE_NAME)
 
 export {