archicat 0.1.0 → 0.1.2

package/README.md

@@ -1,10 +1,11 @@
-# ArchiCat
+# 🐈 ArchiCat
 
-**M²: Modular Mirroring.**
+**M² — Modular Mirroring for TypeScript.**
 
-ArchiCat is a Gradle-like generative architecture framework for TypeScript.
+ArchiCat keeps your TypeScript architecture clean, explicit, and enforceable.
+It turns your dependency graph into real import boundaries, so your project structure is not just a convention.
 
-TypeScript asks: **will this import resolve?**  
+TypeScript asks: **will this import resolve?**
 ArchiCat asks: **should this import exist?**
 
 ```bash
@@ -169,19 +170,20 @@ export default defineArchicatConfig({
 });
 ```
 
-App `tsconfig.json`:
+The generated `.archicat/tsconfig.json` is a composable TypeScript config fragment. Consumers own their own `tsconfig.json` and may compose it however they need. For example, with TypeScript 5+ multiple `extends`:
 
 ```json
 {
-  "extends": "./.archicat/tsconfig.json",
+  "extends": ["../../tsconfig.node.json", "./.archicat/tsconfig.json"],
   "compilerOptions": {
     "rootDir": ".",
     "outDir": "./dist"
-  }
+  },
+  "include": ["main.ts", "src", "test"]
 }
 ```
 
-User aliases belong in `archicat.config.ts`, not in `compilerOptions.paths`.
+Archicat does not inspect or enforce the consumer `tsconfig.json`. User aliases that should be part of the generated Archicat layer belong in `archicat.config.ts`.
 
 ## Output