feat: DX improvements for programmable API

README.md

@@ -26,6 +26,25 @@ Note: `code-complexity` currently measures complexity using either:
 $ npx code-complexity <path-to-git-directory or URL> [options]
 ```
 
+or
+
+```javascript
+// CommonJS
+const complexity = require("code-complexity")
+const results = await complexity.compute({
+  target: "some/file/path"
+})
+```
+
+```typescript
+// ES Modules
+import { analyze } from "code-complexity";
+
+const results = await analyze({
+  target: "some/file/path"
+})
+```
+
 ## Help
 
 ```text

package.json

@@ -7,7 +7,7 @@
     "email": "[email protected]"
   },
   "main": "dist/src/lib",
-  "types": "dist/src/lib/types.d.ts",
+  "types": "dist/src/lib/index.d.ts",
   "bin": {
     "code-complexity": "dist/bin/code-complexity.js"
   },

src/lib/index.ts

@@ -1,3 +1,21 @@
 import Statistics from "./statistics/statistics";
+import Churns from "./churn/churns";
+import Complexities from "./complexity/complexities";
 
+// Expose shared type interfaces
+export * from "./types";
+
+// For CommonJS support: require("code-complexity")
 export default Statistics;
+
+// For ESM functional-style support: import { analyze } from "code-complexity";
+export const analyze = Statistics.compute;
+export const analyse = Statistics.compute;
+
+// For ESM object-style: `import { Statistics } from "code-complexity"`
+export {
+  Statistics,
+  // Expose these as they are dependencies for Statistics
+  Churns,
+  Complexities,
+};