fix: decouple configs for this base package

Author: djMax

.eslintrc.js

@@ -54,7 +54,7 @@ Run the function as many times as you like—it is idempotent and only touches f
 
 ## Package-driven configuration
 
-Most projects will declare their config files directly in `package.json` and call the bundled CLI as part of
+Most projects keep their file definitions in a dedicated module and call the bundled CLI as part of
 `postinstall`:
 
 ```json
@@ -63,18 +63,33 @@ Most projects will declare their config files directly in `package.json` and cal
   "scripts": {
     "postinstall": "cpconfig"
   },
-  "cpconfig": {
-    "files": {
-      "config/.env.local": { "contents": "API_TOKEN=abc123" },
-      ".secrets.json": { "contents": "{\n  \"key\": \"value\"\n}" }
-    }
+  "config": {
+    "cpconfig": "./cpconfig.config.mjs"
   }
 }
 ```
 
 The CLI walks up from the current working directory, finds the nearest `package.json`, and reads the `cpconfig`
-definition (or `config.cpconfig`). Definitions can either be an object of files (as above) or an object with
-`{ "files": { ... }, "options": { ... } }`, mirroring the programmatic API.
+definition (preferring `config.cpconfig`). When the value is a string, `cpconfig` resolves and imports that module
+using standard Node.js resolution. The module can export either:
+
+- a default or named `config` object with `{ files, options }`;
+- a plain object map of files;
+- a factory function (sync or async) returning either of the above.
+
+For example, `cpconfig.config.mjs` might look like:
+
+```js
+export default {
+  files: {
+    'config/.env.local': { contents: 'API_TOKEN=abc123' },
+    '.secrets.json': { contents: '{\n  "key": "value"\n}' },
+  },
+};
+```
+
+If you prefer, you can still embed the object directly in `package.json` under either `cpconfig` or `config.cpconfig`.
+Module exports simply provide a cleaner home for larger definitions or shared packages.
 
 - Run `npx cpconfig` manually whenever you need to refresh files.
 - Add `cpconfig` to `postinstall` to keep developer machines in sync automatically.

.prettierrc.js

@@ -0,0 +1,9 @@
+import js from "@eslint/js";
+import globals from "globals";
+import tseslint from "typescript-eslint";
+import { defineConfig } from "eslint/config";
+
+export default defineConfig([
+  { files: ["**/*.{js,mjs,cjs,ts,mts,cts}"], plugins: { js }, extends: ["js/recommended"], languageOptions: { globals: globals.browser } },
+  tseslint.configs.recommended,
+]);

README.md

@@ -4,9 +4,7 @@
   "description": "A simple zero dependency utility to manage configuration files for node projects across your organization",
   "main": "build/index.js",
   "types": "build/index.d.ts",
-  "bin": {
-    "cpconfig": "build/cli.js"
-  },
+  "bin": "build/cli.js",
   "author": "Developers <[email protected]>",
   "license": "UNLICENSED",
   "packageManager": "[email protected]",
@@ -43,17 +41,37 @@
       "@semantic-release/github"
     ]
   },
+  "prettier": {
+    "bracketSpacing": true,
+    "bracketSameLine": true,
+    "singleQuote": true,
+    "trailingComma": "all",
+    "printWidth": 100,
+    "overrides": [
+      {
+        "files": "*.js",
+        "options": {
+          "parser": "babel"
+        }
+      }
+    ]
+  },
   "devDependencies": {
+    "@eslint/js": "^9.39.1",
     "@semantic-release/exec": "^7.1.0",
     "@semantic-release/github": "^12.0.0",
     "@types/node": "^24.9.1",
     "@typescript-eslint/eslint-plugin": "^8.46.2",
     "@typescript-eslint/parser": "^8.46.2",
-    "eslint": "^9.38.0",
+    "eslint": "^9.39.1",
     "eslint-config-prettier": "^10.1.8",
     "eslint-import-resolver-typescript": "^4.4.4",
     "eslint-plugin-import": "^2.32.0",
+    "globals": "^16.5.0",
+    "jiti": "^2.6.1",
+    "prettier": "^3.6.2",
     "typescript": "^5.9.3",
+    "typescript-eslint": "^8.46.3",
     "vitest": "^4.0.3"
   }
 }

eslint.config.mts

@@ -38,7 +38,9 @@ describe('cli', () => {
       expect(stderr.toString()).toBe('');
 
       await expect(readFile(path.join(cwd, 'secrets/.env'), 'utf8')).resolves.toBe('SECRET=1');
-      await expect(readFile(path.join(cwd, 'config/app.json'), 'utf8')).resolves.toBe('{"flag":true}');
+      await expect(readFile(path.join(cwd, 'config/app.json'), 'utf8')).resolves.toBe(
+        '{"flag":true}',
+      );
 
       const gitignore = await readFile(path.join(cwd, '.gitignore'), 'utf8');
       expect(gitignore).toContain('secrets/.env');
@@ -48,6 +50,83 @@ describe('cli', () => {
     });
   });
 
+  test('loads configuration from a referenced module', async () => {
+    await withTempDir(async (cwd) => {
+      const modulePath = path.join(cwd, 'cpconfig.config.mjs');
+
+      await writeFile(
+        modulePath,
+        `export default {\n  files: {\n    'module-output.txt': { contents: 'from module' }\n  }\n};\n`,
+      );
+
+      await writeFile(
+        path.join(cwd, 'package.json'),
+        JSON.stringify(
+          {
+            ...packageTemplate,
+            config: {
+              cpconfig: './cpconfig.config.mjs',
+            },
+          },
+          null,
+          2,
+        ),
+      );
+
+      const stdout = createBuffer();
+      const stderr = createBuffer();
+
+      const exitCode = await runCli([], { cwd, stdout, stderr });
+
+      expect(exitCode).toBe(0);
+      expect(stderr.toString()).toBe('');
+
+      await expect(readFile(path.join(cwd, 'module-output.txt'), 'utf8')).resolves.toBe(
+        'from module',
+      );
+      const gitignore = await readFile(path.join(cwd, '.gitignore'), 'utf8');
+      expect(gitignore).toContain('module-output.txt');
+      expect(stdout.toString()).toContain('cpconfig apply');
+      expect(stdout.toString()).toContain('cpconfig.config.mjs');
+    });
+  });
+
+  test('supports config modules exporting factories', async () => {
+    await withTempDir(async (cwd) => {
+      const modulePath = path.join(cwd, 'cpconfig.factory.mjs');
+
+      await writeFile(
+        modulePath,
+        `export default async function buildConfig() {\n  await Promise.resolve();\n  return {\n    files: {\n      'factory.txt': { contents: 'from factory' }\n    },\n    options: {\n      gitignorePath: 'generated.ignore'\n    }\n  };\n}\n`,
+      );
+
+      await writeFile(
+        path.join(cwd, 'package.json'),
+        JSON.stringify(
+          {
+            ...packageTemplate,
+            cpconfig: './cpconfig.factory.mjs',
+          },
+          null,
+          2,
+        ),
+      );
+
+      const stdout = createBuffer();
+      const stderr = createBuffer();
+
+      const exitCode = await runCli([], { cwd, stdout, stderr });
+
+      expect(exitCode).toBe(0);
+      expect(stderr.toString()).toBe('');
+
+      await expect(readFile(path.join(cwd, 'factory.txt'), 'utf8')).resolves.toBe('from factory');
+      const gitignore = await readFile(path.join(cwd, 'generated.ignore'), 'utf8');
+      expect(gitignore).toContain('factory.txt');
+      expect(stdout.toString()).toContain('cpconfig.factory.mjs');
+    });
+  });
+
   test('supports dry runs without writing files', async () => {
     await withTempDir(async (cwd) => {
       await writeFile(