feat(cli): improve progress output with live updates

.github/workflows/ci.yml

@@ -22,7 +22,7 @@ jobs:
       - name: Setup Node
         uses: actions/setup-node@v4
         with:
-          node-version: 22
+          node-version: 18
           cache: pnpm
 
       - name: Install dependencies

AGENTS.md

@@ -38,6 +38,9 @@ pnpm.
 
 - Use `node:` specifiers for built-in modules.
 - Keep modules small and single-purpose; prefer focused helpers in `src/`.
+- Prefer early returns to reduce nested control flow.
+- Avoid `else if` branches when early returns or separate conditionals are clearer.
+- Avoid type casts when a safe type guard or discriminated union can be used.
 - Place shared types in `src/types/` and import them via `import type`.
 - Use `index.ts` barrels for public entrypoints.
 

build.config.ts

@@ -1,16 +1,58 @@
+import path from "node:path";
 import { defineBuildConfig } from "unbuild";
 
 export default defineBuildConfig({
 	entries: [
 		{ input: "src/cli/index", name: "cli" },
 		{ input: "src/api", name: "api" },
-		{ input: "src/lock", name: "lock" },
+		{ input: "src/cache/lock", name: "lock" },
+		{
+			builder: "mkdist",
+			input: "./src",
+			outDir: "./dist/esm",
+		},
 	],
 	declaration: true,
 	clean: true,
 	sourcemap: true,
 	rollup: {
 		emitCJS: false,
+		alias: {
+			entries: [
+				{
+					find: /^#cache\/(.*)$/,
+					replacement: path.resolve("src/cache/$1"),
+				},
+				{
+					find: /^#cli\/(.*)$/,
+					replacement: path.resolve("src/cli/$1"),
+				},
+				{
+					find: /^#commands\/(.*)$/,
+					replacement: path.resolve("src/commands/$1"),
+				},
+				{
+					find: /^#config\/(.*)$/,
+					replacement: path.resolve("src/config/$1"),
+				},
+				{
+					find: "#config",
+					replacement: path.resolve("src/config/index"),
+				},
+				{
+					find: /^#core\/(.*)$/,
+					replacement: path.resolve("src/$1"),
+				},
+				{
+					find: /^#git\/(.*)$/,
+					replacement: path.resolve("src/git/$1"),
+				},
+				{
+					find: /^#types\/(.*)$/,
+					replacement: path.resolve("src/types/$1"),
+				},
+			],
+		},
 		inlineDependencies: ["picocolors"],
 		esbuild: {
 			minify: true,

docs.config.schema.json

@@ -58,14 +58,6 @@
 				"ignoreHidden": {
 					"type": "boolean"
 				},
-				"allowHosts": {
-					"minItems": 1,
-					"type": "array",
-					"items": {
-						"type": "string",
-						"minLength": 1
-					}
-				},
 				"toc": {
 					"anyOf": [
 						{
@@ -79,6 +71,14 @@
 				},
 				"unwrapSingleRootDir": {
 					"type": "boolean"
+				},
+				"allowHosts": {
+					"minItems": 1,
+					"type": "array",
+					"items": {
+						"type": "string",
+						"minLength": 1
+					}
 				}
 			},
 			"additionalProperties": false
@@ -88,22 +88,6 @@
 			"items": {
 				"type": "object",
 				"properties": {
-					"id": {
-						"type": "string",
-						"minLength": 1
-					},
-					"repo": {
-						"type": "string",
-						"minLength": 1
-					},
-					"targetDir": {
-						"type": "string",
-						"minLength": 1
-					},
-					"targetMode": {
-						"type": "string",
-						"enum": ["symlink", "copy"]
-					},
 					"ref": {
 						"type": "string",
 						"minLength": 1
@@ -113,6 +97,7 @@
 						"enum": ["materialize"]
 					},
 					"include": {
+						"minItems": 1,
 						"type": "array",
 						"items": {
 							"type": "string",
@@ -126,6 +111,10 @@
 							"minLength": 1
 						}
 					},
+					"targetMode": {
+						"type": "string",
+						"enum": ["symlink", "copy"]
+					},
 					"required": {
 						"type": "boolean"
 					},
@@ -140,6 +129,32 @@
 					"ignoreHidden": {
 						"type": "boolean"
 					},
+					"toc": {
+						"anyOf": [
+							{
+								"type": "boolean"
+							},
+							{
+								"type": "string",
+								"enum": ["tree", "compressed"]
+							}
+						]
+					},
+					"unwrapSingleRootDir": {
+						"type": "boolean"
+					},
+					"id": {
+						"type": "string",
+						"minLength": 1
+					},
+					"repo": {
+						"type": "string",
+						"minLength": 1
+					},
+					"targetDir": {
+						"type": "string",
+						"minLength": 1
+					},
 					"integrity": {
 						"type": "object",
 						"properties": {
@@ -160,20 +175,6 @@
 						},
 						"required": ["type", "value"],
 						"additionalProperties": false
-					},
-					"toc": {
-						"anyOf": [
-							{
-								"type": "boolean"
-							},
-							{
-								"type": "string",
-								"enum": ["tree", "compressed"]
-							}
-						]
-					},
-					"unwrapSingleRootDir": {
-						"type": "boolean"
 					}
 				},
 				"required": ["id", "repo"],

package.json

@@ -34,7 +34,8 @@
 	"files": [
 		"bin",
 		"dist/cli.mjs",
-		"dist/chunks/*.mjs",
+		"dist/esm/**/*.mjs",
+		"dist/esm/**/*.d.ts",
 		"dist/lock.mjs",
 		"dist/shared/*.mjs",
 		"README.md",
@@ -49,32 +50,70 @@
 		"test": "pnpm build && node --test",
 		"test:coverage": "pnpm build && c8 --include dist --exclude bin --reporter=text node --test",
 		"bench": "pnpm build && node scripts/benchmarks/run.mjs",
+		"complexity": "node scripts/complexity/run.mjs",
 		"schema:build": "node scripts/generate-schema.mjs",
 		"size": "size-limit",
 		"test:watch": "node --test --watch",
 		"typecheck": "tsc --noEmit",
 		"prepare": "simple-git-hooks"
 	},
+	"imports": {
+		"#cache/*": {
+			"types": "./dist/esm/cache/*.d.ts",
+			"default": "./dist/esm/cache/*.mjs"
+		},
+		"#cli/*": {
+			"types": "./dist/esm/cli/*.d.ts",
+			"default": "./dist/esm/cli/*.mjs"
+		},
+		"#commands/*": {
+			"types": "./dist/esm/commands/*.d.ts",
+			"default": "./dist/esm/commands/*.mjs"
+		},
+		"#core/*": {
+			"types": "./dist/esm/*.d.ts",
+			"default": "./dist/esm/*.mjs"
+		},
+		"#config": {
+			"types": "./dist/esm/config/index.d.ts",
+			"default": "./dist/esm/config/index.mjs"
+		},
+		"#config/*": {
+			"types": "./dist/esm/config/*.d.ts",
+			"default": "./dist/esm/config/*.mjs"
+		},
+		"#git/*": {
+			"types": "./dist/esm/git/*.d.ts",
+			"default": "./dist/esm/git/*.mjs"
+		},
+		"#types/*": {
+			"types": "./dist/esm/types/*.d.ts",
+			"default": "./dist/esm/types/*.mjs"
+		}
+	},
 	"dependencies": {
 		"@clack/prompts": "^1.0.0",
 		"cac": "^6.7.14",
+		"cli-truncate": "^4.0.0",
 		"execa": "^9.6.1",
 		"fast-glob": "^3.3.2",
+		"log-update": "^7.0.2",
 		"picocolors": "^1.1.1",
-		"picomatch": "^2.3.1",
+		"picomatch": "^4.0.3",
 		"zod": "^4.3.6"
 	},
 	"devDependencies": {
-		"@biomejs/biome": "^2.3.8",
-		"@size-limit/file": "^11.2.0",
-		"@types/node": "^24.2.1",
+		"@biomejs/biome": "^2.3.14",
+		"@size-limit/file": "^12.0.0",
+		"@types/node": "^25.2.0",
 		"bumpp": "^10.3.2",
 		"c8": "^10.1.3",
 		"jiti": "^2.5.1",
 		"lint-staged": "^16.2.7",
 		"simple-git-hooks": "^2.13.1",
-		"size-limit": "^11.2.0",
+		"size-limit": "^12.0.0",
 		"tinybench": "^6.0.0",
+		"ts-complex": "^1.0.0",
 		"typescript": "^5.9.3",
 		"unbuild": "^3.6.1"
 	},
@@ -84,6 +123,11 @@
 			"limit": "10 kB"
 		}
 	],
+	"complexity": {
+		"maxCyclomatic": 20,
+		"minMaintainability": 60,
+		"top": 10
+	},
 	"simple-git-hooks": {
 		"pre-commit": "pnpm lint-staged && pnpm typecheck"
 	},