Check Barrel Files Command

Check Barrel Files Command

Check for redundant barrel files (index.ts) that only re-export a single item.

Arguments

• $ARGUMENTS - The library path to check (e.g., libs/​mxsecurity/​account-page)

Problem Description

Redundant barrel files are index.ts files that:

1. Only contain a single export * from './​xxx' statement
2. Are intermediate files that add no value

Bad Pattern

libs/​scope/​domain/​features/​src/
├── index.ts                    # exports from './​lib/​my-dialog'
└── lib/
    └── my-dialog/
        ├── index.ts            # Redundant: only exports './​my-dialog.component'
        └── my-dialog.component.ts

Good Pattern

libs/​scope/​domain/​features/​src/
├── index.ts                    # exports from './​lib/​my-dialog/​my-dialog.component'
└── lib/
    └── my-dialog/
        └── my-dialog.component.ts   # No intermediate barrel file

Check Process

Step 1: Find All index.ts Files

Find all index.ts files in the target path:

find {$ARGUMENTS} -name "index.ts" -type f

Step 2: Analyze Each Barrel File

For each index.ts file found:

1. Read the file content
2. Count the number of export statements
3. If only ONE export exists, check if it exports from a folder (barrel) or a file

Step 3: Identify Redundant Barrels

A barrel file is redundant if:

• It contains only ONE export statement
• The export is export * from './​folder-name'
• The target folder has its own index.ts that also only exports one item

Step 4: Generate Report

Output a markdown report:

# Barrel File Check Report

**Path:** {$ARGUMENTS}
**Date:** {current_date}

## Summary

| Total index.ts | Redundant | OK |
|----------------|-----------|-----|
| X              | Y         | Z   |

## Redundant Barrel Files

| File | Exports | Recommendation |
|------|---------|----------------|
| `lib/​my-dialog/​index.ts` | `./​my-dialog.component` | Delete, update parent to export directly |

## Recommended Fixes

### 1. {path/​to/​redundant/​index.ts}

**Current:**
```typescript
// src/​index.ts
export * from './​lib/​my-dialog';

// lib/​my-dialog/​index.ts
export * from './​my-dialog.component';

Recommended:

// src/​index.ts
export * from './​lib/​my-dialog/​my-dialog.component';

// Delete: lib/​my-dialog/​index.ts

Valid Barrel Files (No Action Needed)

## Auto-Fix Option

After showing the report, ask the user:

> Found {N} redundant barrel files. Would you like me to fix them automatically?

If user confirms, for each redundant barrel:
1. Update the parent `index.ts` to export directly from the component file
2. Delete the redundant `index.ts` file

## Examples

### Example 1: Simple Redundant Barrel

Before: features/​src/​index.ts → export * from './​lib/​account-dialog' features/​src/​lib/​account-dialog/​index.ts → export * from './​account-dialog.component'

After: features/​src/​index.ts → export * from './​lib/​account-dialog/​account-dialog.component' (deleted: features/​src/​lib/​account-dialog/​index.ts)

### Example 2: Valid Multi-Export Barrel (Keep)

domain/​src/​index.ts: export * from './​lib/​account-page.api'; export * from './​lib/​account-page.model'; export * from './​lib/​account-page.store';

→ This is valid, do not modify