@raubjo/architect-core 0.1.0 → 0.1.1

package/README.md

@@ -0,0 +1,162 @@
+# @raubjo/architect-core
+
+A Laravel-inspired application container for reactive frontends.
+
+The goal is simple: define and configure business rules in providers, then resolve services where you need them without rebuilding wiring at each call site.
+
+You keep inversion of control, lifecycle hooks, and runtime reactivity.
+
+## Why this package
+
+- Centralized service registration via providers
+- Predictable lifecycle (`register` then `boot`)
+- Framework runtime helpers (`react`, `solid`, `svelte`, `vue`)
+- Config repository and facades
+- Automatic config loading from your project `config` files
+
+If you are familiar with Laravel service providers and container bindings, this should feel familiar.
+
+## Install
+
+```bash
+bun add @raubjo/architect-core inversify reflect-metadata
+```
+
+For framework-specific runtime helpers, import from subpaths like `@raubjo/architect-core/react`.
+
+## Quick start
+
+```ts
+import "reflect-metadata";
+import { Application } from "@raubjo/architect-core";
+
+const { container, stop } = Application.configure("./")
+  .withProviders([])
+  .run();
+
+// Resolve anywhere after run()
+const config = container.get("config");
+
+// Call on teardown if needed
+stop();
+```
+
+## Service provider example
+
+Use providers to define business rules and service construction once.
+
+```ts
+import { injectable } from "inversify";
+import {
+  ServiceProvider,
+  type ServiceProviderContext,
+} from "@raubjo/architect-core";
+
+@injectable()
+class PricingService {
+  constructor(private readonly taxRate: number) {}
+
+  quote(subtotal: number) {
+    return subtotal + subtotal * this.taxRate;
+  }
+}
+
+class PricingServiceProvider extends ServiceProvider {
+  register({ container }: ServiceProviderContext) {
+    container.bind("services.pricing").toDynamicValue((ctx) => {
+      const config = ctx.container.get("config") as {
+        float: (key: string, defaultValue?: number) => number;
+      };
+
+      const taxRate = config.float("pricing.taxRate", 0.07);
+      return new PricingService(taxRate);
+    });
+  }
+
+  boot({ container }: ServiceProviderContext) {
+    // Optional startup work after all providers register.
+    // Example: warm caches, subscribe to events, etc.
+    void container;
+  }
+}
+```
+
+## Application configuration example
+
+```ts
+import "reflect-metadata";
+import { Application } from "@raubjo/architect-core";
+import { ReactRenderer, useService } from "@raubjo/architect-core/react";
+import PricingServiceProvider from "./providers/pricing-service-provider";
+
+function QuotePanel() {
+  const pricing = useService<{ quote: (subtotal: number) => number }>(
+    "services.pricing",
+  );
+
+  return <div>Total: {pricing.quote(100)}</div>;
+}
+
+const app = Application.configure("./")
+  .withProviders([new PricingServiceProvider()])
+  .withServices(({ container }) => {
+    // Optional inline registrations if you do not want a dedicated provider.
+    container.bind("featureFlags.checkout").toConstantValue(true);
+  })
+  .withRoot(QuotePanel)
+  .withRenderer(new ReactRenderer());
+
+app.run();
+```
+
+## Config auto-loading from `basePath/config`
+
+`Application.configure(basePath)` controls where config files are discovered.
+
+When `run()` is called, config is assembled from:
+
+1. Built-in default `app` config.
+2. Any default exports found in:
+   - `${basePath}/config/*.{js,mjs,cjs,ts,mts,cts}`
+   - `${basePath}/src/config/*.{js,mjs,cjs,ts,mts,cts}`
+
+Each file becomes a top-level config key based on the filename:
+
+- `config/cache.ts` -> `config.get("cache")`
+- `src/config/pricing.ts` -> `config.get("pricing")`
+
+Example:
+
+```ts
+// ./config/pricing.ts
+export default {
+  taxRate: 0.0825,
+  currency: "USD",
+};
+```
+
+```ts
+const app = Application.configure("./").run();
+const config = app.container.get("config") as {
+  get: <T = unknown>(key: string, defaultValue?: T) => T;
+};
+
+config.get("pricing.taxRate"); // 0.0825
+```
+
+## Lifecycle order
+
+`run()` executes in this order:
+
+1. Provider `register()`
+2. `.withServices(...)` callbacks
+3. Provider `boot()`
+4. `.withStartup(...)` callbacks
+5. Renderer mount (if configured)
+
+Cleanup runs in reverse order when `stop()` is called.
+
+## Notes
+
+- `Application.make(...)` is available after `run()` and resolves from the active container.
+- Config source files are cached by `basePath`; use `Application.clearConfigCache()` in tests when needed.

package/bun.lock

@@ -3,18 +3,99 @@
   "configVersion": 1,
   "workspaces": {
     "": {
-      "name": "@ioc/application",
+      "name": "@raubjo/architect-core",
       "devDependencies": {
         "@types/react": "^19.2.14",
         "@types/react-dom": "^19.2.3",
+        "bun-types": "^1.3.9",
+        "prettier": "^3.8.1",
+        "solid-js": "^1.9.0",
+        "vue": "^3.5.13",
       },
+      "peerDependencies": {
+        "inversify": "^7.11.0",
+        "react": "^19.0.0",
+        "react-dom": "^19.0.0",
+        "reflect-metadata": "~0.2.2",
+        "solid-js": "",
+        "svelte": "",
+        "vue": "^3.0.0",
+      },
+      "optionalPeers": [
+        "inversify",
+        "react",
+        "react-dom",
+        "solid-js",
+        "svelte",
+        "vue",
+      ],
     },
   },
   "packages": {
+    "@babel/helper-string-parser": ["@babel/helper-string-parser@7.27.1", "", {}, "sha512-qMlSxKbpRlAridDExk92nSobyDdpPijUq2DW6oDnUqd0iOGxmQjyqhMIihI9+zv4LPyZdRje2cavWPbCbWm3eA=="],
+
+    "@babel/helper-validator-identifier": ["@babel/helper-validator-identifier@7.28.5", "", {}, "sha512-qSs4ifwzKJSV39ucNjsvc6WVHs6b7S03sOh2OcHF9UHfVPqWWALUsNUVzhSBiItjRZoLHx7nIarVjqKVusUZ1Q=="],
+
+    "@babel/parser": ["@babel/parser@7.29.0", "", { "dependencies": { "@babel/types": "^7.29.0" }, "bin": "./bin/babel-parser.js" }, "sha512-IyDgFV5GeDUVX4YdF/3CPULtVGSXXMLh1xVIgdCgxApktqnQV0r7/8Nqthg+8YLGaAtdyIlo2qIdZrbCv4+7ww=="],
+
+    "@babel/types": ["@babel/types@7.29.0", "", { "dependencies": { "@babel/helper-string-parser": "^7.27.1", "@babel/helper-validator-identifier": "^7.28.5" } }, "sha512-LwdZHpScM4Qz8Xw2iKSzS+cfglZzJGvofQICy7W7v4caru4EaAmyUuO6BGrbyQ2mYV11W0U8j5mBhd14dd3B0A=="],
+
+    "@jridgewell/sourcemap-codec": ["@jridgewell/sourcemap-codec@1.5.5", "", {}, "sha512-cYQ9310grqxueWbl+WuIUIaiUaDcj7WOq5fVhEljNVgRfOUhY9fy2zTvfoqWsnebh8Sl70VScFbICvJnLKB0Og=="],
+
+    "@types/node": ["@types/node@25.2.3", "", { "dependencies": { "undici-types": "~7.16.0" } }, "sha512-m0jEgYlYz+mDJZ2+F4v8D1AyQb+QzsNqRuI7xg1VQX/KlKS0qT9r1Mo16yo5F/MtifXFgaofIFsdFMox2SxIbQ=="],
+
     "@types/react": ["@types/react@19.2.14", "", { "dependencies": { "csstype": "^3.2.2" } }, "sha512-ilcTH/UniCkMdtexkoCN0bI7pMcJDvmQFPvuPvmEaYA/NSfFTAgdUSLAoVjaRJm7+6PvcM+q1zYOwS4wTYMF9w=="],
 
     "@types/react-dom": ["@types/react-dom@19.2.3", "", { "peerDependencies": { "@types/react": "^19.2.0" } }, "sha512-jp2L/eY6fn+KgVVQAOqYItbF0VY/YApe5Mz2F0aykSO8gx31bYCZyvSeYxCHKvzHG5eZjc+zyaS5BrBWya2+kQ=="],
 
+    "@vue/compiler-core": ["@vue/compiler-core@3.5.28", "", { "dependencies": { "@babel/parser": "^7.29.0", "@vue/shared": "3.5.28", "entities": "^7.0.1", "estree-walker": "^2.0.2", "source-map-js": "^1.2.1" } }, "sha512-kviccYxTgoE8n6OCw96BNdYlBg2GOWfBuOW4Vqwrt7mSKWKwFVvI8egdTltqRgITGPsTFYtKYfxIG8ptX2PJHQ=="],
+
+    "@vue/compiler-dom": ["@vue/compiler-dom@3.5.28", "", { "dependencies": { "@vue/compiler-core": "3.5.28", "@vue/shared": "3.5.28" } }, "sha512-/1ZepxAb159jKR1btkefDP+J2xuWL5V3WtleRmxaT+K2Aqiek/Ab/+Ebrw2pPj0sdHO8ViAyyJWfhXXOP/+LQA=="],
+
+    "@vue/compiler-sfc": ["@vue/compiler-sfc@3.5.28", "", { "dependencies": { "@babel/parser": "^7.29.0", "@vue/compiler-core": "3.5.28", "@vue/compiler-dom": "3.5.28", "@vue/compiler-ssr": "3.5.28", "@vue/shared": "3.5.28", "estree-walker": "^2.0.2", "magic-string": "^0.30.21", "postcss": "^8.5.6", "source-map-js": "^1.2.1" } }, "sha512-6TnKMiNkd6u6VeVDhZn/07KhEZuBSn43Wd2No5zaP5s3xm8IqFTHBj84HJah4UepSUJTro5SoqqlOY22FKY96g=="],
+
+    "@vue/compiler-ssr": ["@vue/compiler-ssr@3.5.28", "", { "dependencies": { "@vue/compiler-dom": "3.5.28", "@vue/shared": "3.5.28" } }, "sha512-JCq//9w1qmC6UGLWJX7RXzrGpKkroubey/ZFqTpvEIDJEKGgntuDMqkuWiZvzTzTA5h2qZvFBFHY7fAAa9475g=="],
+
+    "@vue/reactivity": ["@vue/reactivity@3.5.28", "", { "dependencies": { "@vue/shared": "3.5.28" } }, "sha512-gr5hEsxvn+RNyu9/9o1WtdYdwDjg5FgjUSBEkZWqgTKlo/fvwZ2+8W6AfKsc9YN2k/+iHYdS9vZYAhpi10kNaw=="],
+
+    "@vue/runtime-core": ["@vue/runtime-core@3.5.28", "", { "dependencies": { "@vue/reactivity": "3.5.28", "@vue/shared": "3.5.28" } }, "sha512-POVHTdbgnrBBIpnbYU4y7pOMNlPn2QVxVzkvEA2pEgvzbelQq4ZOUxbp2oiyo+BOtiYlm8Q44wShHJoBvDPAjQ=="],
+
+    "@vue/runtime-dom": ["@vue/runtime-dom@3.5.28", "", { "dependencies": { "@vue/reactivity": "3.5.28", "@vue/runtime-core": "3.5.28", "@vue/shared": "3.5.28", "csstype": "^3.2.3" } }, "sha512-4SXxSF8SXYMuhAIkT+eBRqOkWEfPu6nhccrzrkioA6l0boiq7sp18HCOov9qWJA5HML61kW8p/cB4MmBiG9dSA=="],
+
+    "@vue/server-renderer": ["@vue/server-renderer@3.5.28", "", { "dependencies": { "@vue/compiler-ssr": "3.5.28", "@vue/shared": "3.5.28" }, "peerDependencies": { "vue": "3.5.28" } }, "sha512-pf+5ECKGj8fX95bNincbzJ6yp6nyzuLDhYZCeFxUNp8EBrQpPpQaLX3nNCp49+UbgbPun3CeVE+5CXVV1Xydfg=="],
+
+    "@vue/shared": ["@vue/shared@3.5.28", "", {}, "sha512-cfWa1fCGBxrvaHRhvV3Is0MgmrbSCxYTXCSCau2I0a1Xw1N1pHAvkWCiXPRAqjvToILvguNyEwjevUqAuBQWvQ=="],
+
+    "bun-types": ["bun-types@1.3.9", "", { "dependencies": { "@types/node": "*" } }, "sha512-+UBWWOakIP4Tswh0Bt0QD0alpTY8cb5hvgiYeWCMet9YukHbzuruIEeXC2D7nMJPB12kbh8C7XJykSexEqGKJg=="],
+
     "csstype": ["csstype@3.2.3", "", {}, "sha512-z1HGKcYy2xA8AGQfwrn0PAy+PB7X/GSj3UVJW9qKyn43xWa+gl5nXmU4qqLMRzWVLFC8KusUX8T/0kCiOYpAIQ=="],
+
+    "entities": ["entities@7.0.1", "", {}, "sha512-TWrgLOFUQTH994YUyl1yT4uyavY5nNB5muff+RtWaqNVCAK408b5ZnnbNAUEWLTCpum9w6arT70i1XdQ4UeOPA=="],
+
+    "estree-walker": ["estree-walker@2.0.2", "", {}, "sha512-Rfkk/Mp/DL7JVje3u18FxFujQlTNR2q6QfMSMB7AvCBx91NGj/ba3kCfza0f6dVDbw7YlRf/nDrn7pQrCCyQ/w=="],
+
+    "magic-string": ["magic-string@0.30.21", "", { "dependencies": { "@jridgewell/sourcemap-codec": "^1.5.5" } }, "sha512-vd2F4YUyEXKGcLHoq+TEyCjxueSeHnFxyyjNp80yg0XV4vUhnDer/lvvlqM/arB5bXQN5K2/3oinyCRyx8T2CQ=="],
+
+    "nanoid": ["nanoid@3.3.11", "", { "bin": { "nanoid": "bin/nanoid.cjs" } }, "sha512-N8SpfPUnUp1bK+PMYW8qSWdl9U+wwNWI4QKxOYDy9JAro3WMX7p2OeVRF9v+347pnakNevPmiHhNmZ2HbFA76w=="],
+
+    "picocolors": ["picocolors@1.1.1", "", {}, "sha512-xceH2snhtb5M9liqDsmEw56le376mTZkEX/jEb/RxNFyegNul7eNslCXP9FDj/Lcu0X8KEyMceP2ntpaHrDEVA=="],
+
+    "postcss": ["postcss@8.5.6", "", { "dependencies": { "nanoid": "^3.3.11", "picocolors": "^1.1.1", "source-map-js": "^1.2.1" } }, "sha512-3Ybi1tAuwAP9s0r1UQ2J4n5Y0G05bJkpUIO0/bI9MhwmD70S5aTWbXGBwxHrelT+XM1k6dM0pk+SwNkpTRN7Pg=="],
+
+    "prettier": ["prettier@3.8.1", "", { "bin": { "prettier": "bin/prettier.cjs" } }, "sha512-UOnG6LftzbdaHZcKoPFtOcCKztrQ57WkHDeRD9t/PTQtmT0NHSeWWepj6pS0z/N7+08BHFDQVUrfmfMRcZwbMg=="],
+
+    "reflect-metadata": ["reflect-metadata@0.2.2", "", {}, "sha512-urBwgfrvVP/eAyXx4hluJivBKzuEbSQs9rKWCrCkbSxNv8mxPcUZKeuoF3Uy4mJl3Lwprp6yy5/39VWigZ4K6Q=="],
+
+    "seroval": ["seroval@1.5.0", "", {}, "sha512-OE4cvmJ1uSPrKorFIH9/w/Qwuvi/IMcGbv5RKgcJ/zjA/IohDLU6SVaxFN9FwajbP7nsX0dQqMDes1whk3y+yw=="],
+
+    "seroval-plugins": ["seroval-plugins@1.5.0", "", { "peerDependencies": { "seroval": "^1.0" } }, "sha512-EAHqADIQondwRZIdeW2I636zgsODzoBDwb3PT/+7TLDWyw1Dy/Xv7iGUIEXXav7usHDE9HVhOU61irI3EnyyHA=="],
+
+    "solid-js": ["solid-js@1.9.11", "", { "dependencies": { "csstype": "^3.1.0", "seroval": "~1.5.0", "seroval-plugins": "~1.5.0" } }, "sha512-WEJtcc5mkh/BnHA6Yrg4whlF8g6QwpmXXRg4P2ztPmcKeHHlH4+djYecBLhSpecZY2RRECXYUwIc/C2r3yzQ4Q=="],
+
+    "source-map-js": ["source-map-js@1.2.1", "", {}, "sha512-UXWMKhLOwVKb728IUtQPXxfYU+usdybtUrK/8uGE8CQMvrhOpwvzDBwj0QhSL7MQc7vIsISBG8VQ8+IDQxpfQA=="],
+
+    "undici-types": ["undici-types@7.16.0", "", {}, "sha512-Zz+aZWSj8LE6zoxD+xrjh4VfkIG8Ya6LvYkZqtUQGJPZjYl53ypCaUwWqo7eI0x66KBGeRo+mlBEkMSeSZ38Nw=="],
+
+    "vue": ["vue@3.5.28", "", { "dependencies": { "@vue/compiler-dom": "3.5.28", "@vue/compiler-sfc": "3.5.28", "@vue/runtime-dom": "3.5.28", "@vue/server-renderer": "3.5.28", "@vue/shared": "3.5.28" }, "peerDependencies": { "typescript": "*" }, "optionalPeers": ["typescript"] }, "sha512-BRdrNfeoccSoIZeIhyPBfvWSLFP4q8J3u8Ju8Ug5vu3LdD+yTM13Sg4sKtljxozbnuMu1NB1X5HBHRYUzFocKg=="],
   }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@raubjo/architect-core",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "private": false,
   "type": "module",
   "publishConfig": {
@@ -8,18 +8,27 @@
   },
   "scripts": {
     "test": "bun test",
-    "test:coverage": "bun test --coverage"
+    "test:coverage": "bun test --coverage",
+    "fix": "prettier -w ./src/**/*"
   },
   "exports": {
     ".": "./src/index.ts",
+    "./react": "./src/react.ts",
+    "./solid": "./src/solid.ts",
+    "./svelte": "./src/svelte.ts",
+    "./vue": "./src/vue.ts",
     "./application": "./src/foundation/application.ts",
-    "./config/app": "./src/config/app.ts",
+    "./container/contract": "./src/container/contract.ts",
+    "./container/adapters/inversify": "./src/container/adapters/inversify.ts",
+    "./container/adapters/builtin": "./src/container/adapters/builtin.ts",
+    "./config/adapters/esm": "./src/config/adapters/esm.ts",
     "./config/env": "./src/config/env.ts",
     "./config/repository": "./src/config/repository.ts",
     "./cache/manager": "./src/cache/manager.ts",
     "./cache/cache": "./src/cache/cache.ts",
     "./facades/cache": "./src/support/facades/cache.ts",
     "./storage/manager": "./src/storage/manager.ts",
+    "./storage/adapters/contract": "./src/storage/adapters/contract.ts",
     "./storage/storage": "./src/storage/storage.ts",
     "./storage/adapters/memory": "./src/storage/adapters/memory.ts",
     "./storage/adapters/local-storage": "./src/storage/adapters/local-storage.ts",
@@ -27,17 +36,56 @@
     "./facades/storage": "./src/support/facades/storage.ts",
     "./filesystem/filesystem": "./src/filesystem/filesystem.ts",
     "./filesystem/local-adapter": "./src/filesystem/adapters/local.ts",
-    "./rendering/renderer": "./src/rendering/renderer.ts",
-    "./rendering/react": "./src/rendering/adapters/react.tsx",
+    "./renderers/contract": "./src/renderers/contract.ts",
+    "./renderers/react": "./src/renderers/adapters/react.tsx",
+    "./renderers/solid": "./src/renderers/adapters/solid.tsx",
+    "./renderers/svelte": "./src/renderers/adapters/svelte.ts",
+    "./renderers/vue": "./src/renderers/adapters/vue.ts",
     "./facades/config": "./src/support/facades/config.ts",
     "./providers/config-service-provider": "./src/support/providers/config-service-provider.ts",
     "./runtimes/react": "./src/runtimes/react.tsx",
+    "./runtimes/solid": "./src/runtimes/solid.tsx",
+    "./runtimes/svelte": "./src/runtimes/svelte.ts",
+    "./runtimes/vue": "./src/runtimes/vue.ts",
     "./str": "./src/support/str.ts",
     "./service-provider": "./src/support/service-provider.ts",
     "./facade": "./src/support/facades/facade.ts"
   },
+  "peerDependencies": {
+    "inversify": "^7.11.0",
+    "reflect-metadata": "~0.2.2",
+    "react": "^19.0.0",
+    "react-dom": "^19.0.0",
+    "svelte": "",
+    "solid-js": "",
+    "vue": "^3.0.0"
+  },
+  "peerDependenciesMeta": {
+    "react": {
+      "optional": true
+    },
+    "react-dom": {
+      "optional": true
+    },
+    "solid-js": {
+      "optional": true
+    },
+    "svelte": {
+      "optional": true
+    },
+    "vue": {
+      "optional": true
+    },
+    "inversify": {
+      "optional": true
+    }
+  },
   "devDependencies": {
     "@types/react": "^19.2.14",
-    "@types/react-dom": "^19.2.3"
+    "@types/react-dom": "^19.2.3",
+    "bun-types": "^1.3.9",
+    "prettier": "^3.8.1",
+    "solid-js": "^1.9.0",
+    "vue": "^3.5.13"
   }
 }

package/src/cache/cache.ts

@@ -1,3 +1,3 @@
-import type { StorageAdapter } from "../storage/storage";
+import type { Adapter } from "@/storage/adapters/contract";
 
-export type CacheStore = StorageAdapter;
+export type CacheStore = Adapter;

package/src/cache/manager.ts

@@ -1,115 +1,125 @@
-import type ConfigRepository from "../config/repository";
-import IndexedDbAdapter from "../storage/adapters/indexed-db";
-import LocalStorageAdapter from "../storage/adapters/local-storage";
-import MemoryStorageAdapter from "../storage/adapters/memory";
-import type { StorageAdapter } from "../storage/storage";
-import type { CacheStore } from "./cache";
+import type ConfigRepository from "@/config/repository";
+import IndexedDbAdapter from "@/storage/adapters/indexed-db";
+import LocalStorageAdapter from "@/storage/adapters/local-storage";
+import MemoryStorageAdapter from "@/storage/adapters/memory";
+import type { Adapter } from "@/storage/adapters/contract";
+import type { CacheStore } from "@/cache/cache";
 
 type CacheStoreConfig = {
-  driver?: string;
+    driver?: string;
 };
 
 function isRecord(value: unknown): value is Record<string, unknown> {
-  return typeof value === "object" && value !== null && !Array.isArray(value);
+    return typeof value === "object" && value !== null && !Array.isArray(value);
 }
 
-export default class CacheManager implements StorageAdapter {
-  protected stores: Record<string, CacheStore>;
-  protected active: string;
+export default class CacheManager implements Adapter {
+    protected stores: Record<string, CacheStore>;
+    protected active: string;
 
-  constructor(stores: Record<string, CacheStore>, active = "memory") {
-    this.stores = stores;
-    this.active = active in this.stores ? active : firstStoreName(this.stores);
-  }
-
-  static fromConfig(config: ConfigRepository): CacheManager {
-    const stores = CacheManager.storesFromConfig(config);
-    const active = config.string("cache.default", "memory");
+    constructor(stores: Record<string, CacheStore>, active = "memory") {
+        this.stores = stores;
+        this.active =
+            active in this.stores ? active : firstStoreName(this.stores);
+    }
 
-    return new CacheManager(stores, active);
-  }
+    static fromConfig(config: ConfigRepository): CacheManager {
+        const stores = CacheManager.storesFromConfig(config);
+        const active = config.string("cache.default", "memory");
 
-  protected static storesFromConfig(config: ConfigRepository): Record<string, CacheStore> {
-    const baseDrivers = CacheManager.defaultDrivers();
-    const configured = config.get<Record<string, unknown>>("cache.stores", {}) ?? {};
-    if (!isRecord(configured) || Object.keys(configured).length === 0) {
-      return baseDrivers;
+        return new CacheManager(stores, active);
     }
 
-    const stores: Record<string, CacheStore> = {};
-    for (const [name, storeConfig] of Object.entries(configured)) {
-      const driver = resolveDriver(storeConfig, name);
-      stores[name] = baseDrivers[driver] ?? baseDrivers.memory;
+    protected static storesFromConfig(
+        config: ConfigRepository,
+    ): Record<string, CacheStore> {
+        const baseDrivers = CacheManager.defaultDrivers();
+        const configured =
+            config.get<Record<string, unknown>>("cache.stores", {}) ?? {};
+        if (!isRecord(configured) || Object.keys(configured).length === 0) {
+            return baseDrivers;
+        }
+
+        const stores: Record<string, CacheStore> = {};
+        for (const [name, storeConfig] of Object.entries(configured)) {
+            const driver = resolveDriver(storeConfig, name);
+            stores[name] = baseDrivers[driver] ?? baseDrivers.memory;
+        }
+
+        return stores;
     }
 
-    return stores;
-  }
-
-  protected static defaultDrivers(): Record<string, CacheStore> {
-    const memory = new MemoryStorageAdapter();
-    const hasWindow = typeof window !== "undefined";
-    const hasLocal = hasWindow && typeof window.localStorage !== "undefined";
-    const hasIndexed = typeof globalThis.indexedDB !== "undefined";
-
-    return {
-      memory,
-      local: hasLocal ? new LocalStorageAdapter(window.localStorage) : memory,
-      indexed: hasIndexed ? new IndexedDbAdapter() : memory,
-    };
-  }
-
-  store(name?: string): CacheStore {
-    const target = typeof name === "string" ? name : this.active;
-    if (!(target in this.stores)) {
-      throw new Error(`Cache store [${target}] is not defined.`);
+    protected static defaultDrivers(): Record<string, CacheStore> {
+        const memory = new MemoryStorageAdapter();
+        const hasWindow = typeof window !== "undefined";
+        const hasLocal =
+            hasWindow && typeof window.localStorage !== "undefined";
+        const hasIndexed = typeof globalThis.indexedDB !== "undefined";
+
+        return {
+            memory,
+            local:
+                hasLocal ?
+                    new LocalStorageAdapter(window.localStorage)
+                :   memory,
+            indexed: hasIndexed ? new IndexedDbAdapter() : memory,
+        };
     }
 
-    return this.stores[target];
-  }
+    store(name?: string): CacheStore {
+        const target = typeof name === "string" ? name : this.active;
+        if (!(target in this.stores)) {
+            throw new Error(`Cache store [${target}] is not defined.`);
+        }
 
-  use(name: string): this {
-    this.active = this.store(name) ? name : this.active;
-    return this;
-  }
+        return this.stores[target];
+    }
 
-  get<T = unknown>(key: string): Promise<T | null> {
-    return this.store().get<T>(key);
-  }
+    use(name: string): this {
+        this.active = this.store(name) ? name : this.active;
+        return this;
+    }
 
-  set<T = unknown>(key: string, value: T): Promise<void> {
-    return this.store().set<T>(key, value);
-  }
+    get<T = unknown>(key: string): Promise<T | null> {
+        return this.store().get<T>(key);
+    }
 
-  has(key: string): Promise<boolean> {
-    return this.store().has(key);
-  }
+    set<T = unknown>(key: string, value: T): Promise<void> {
+        return this.store().set<T>(key, value);
+    }
 
-  delete(key: string): Promise<void> {
-    return this.store().delete(key);
-  }
+    has(key: string): Promise<boolean> {
+        return this.store().has(key);
+    }
 
-  clear(): Promise<void> {
-    return this.store().clear();
-  }
+    delete(key: string): Promise<void> {
+        return this.store().delete(key);
+    }
+
+    clear(): Promise<void> {
+        return this.store().clear();
+    }
 
-  keys(): Promise<string[]> {
-    return this.store().keys();
-  }
+    keys(): Promise<string[]> {
+        return this.store().keys();
+    }
 }
 
 function firstStoreName(stores: Record<string, CacheStore>): string {
-  if ("memory" in stores) {
-    return "memory";
-  }
+    if ("memory" in stores) {
+        return "memory";
+    }
 
-  return Object.keys(stores)[0];
+    return Object.keys(stores)[0];
 }
 
 function resolveDriver(value: unknown, fallback: string): string {
-  if (!isRecord(value)) {
-    return fallback;
-  }
+    if (!isRecord(value)) {
+        return fallback;
+    }
 
-  const storeConfig = value as CacheStoreConfig;
-  return typeof storeConfig.driver === "string" ? storeConfig.driver : fallback;
+    const storeConfig = value as CacheStoreConfig;
+    return typeof storeConfig.driver === "string" ?
+            storeConfig.driver
+        :   fallback;
 }

package/src/config/adapters/esm.ts

@@ -0,0 +1,26 @@
+import type { ConfigItems } from "@/config/repository";
+
+type ConfigModule = { default?: unknown };
+
+function fileNameWithoutExtension(path: string): string {
+    const file = path.split("/").pop() ?? path;
+    return file.replace(/\.[^/.]+$/, "");
+}
+
+export function loadConfig(modules: Record<string, unknown>): ConfigItems {
+    const discovered: ConfigItems = {};
+
+    for (const [path, loaded] of Object.entries(modules)) {
+        const key = fileNameWithoutExtension(path);
+        if (key === "index") {
+            continue;
+        }
+
+        const module = loaded as ConfigModule;
+        if (module && "default" in module && module.default !== undefined) {
+            discovered[key] = module.default;
+        }
+    }
+
+    return discovered;
+}

package/src/config/clone.ts

@@ -1,9 +1,9 @@
-import type { ConfigItems } from "./repository";
+import type { ConfigItems } from "@/config/repository";
 
 export function cloneConfigItems(items: ConfigItems): ConfigItems {
-  if (typeof structuredClone === "function") {
-    return structuredClone(items) as ConfigItems;
-  }
+    if (typeof structuredClone === "function") {
+        return structuredClone(items) as ConfigItems;
+    }
 
-  return JSON.parse(JSON.stringify(items)) as ConfigItems;
+    return JSON.parse(JSON.stringify(items)) as ConfigItems;
 }

package/src/config/env.global.d.ts

@@ -1,5 +1,6 @@
 declare global {
-  function env<T = unknown>(key: string, defaultValue?: T | null): T | unknown | null;
+    function env(key: string): import("./env").EnvValue | undefined;
+    function env<T>(key: string, defaultValue: T): import("./env").EnvValue | T;
 }
 
 export {};