Generate Barrel Files

Generate barrel index.ts files for TypeScript directories to simplify imports.

Note: Generation commands (model gen, aptx functions, react-query, vue-query) automatically update barrel files after generation. Use this command only for manual fixes or special cases.

When to Use This Command

Scenario	Action
Normal generation	Barrel files are auto-updated - no action needed
Fixing corrupted barrel files	Use this command
Processing non-standard directory structures	Use this command
One-time batch updates across multiple directories	Use this command

Prerequisites

pnpm add -D @aptx/frontend-tk-cli

Usage

pnpm exec aptx-ft barrel gen -i <input-dir>

Alternative (without pnpm):

npx aptx-ft barrel gen -i ./src/functions

Workflow

1. Ask user for target directory path
2. Show complete command and confirm with user
3. Execute and report results

Common Directories

Directory	Purpose
./src/functions	Function modules
./src/api	API modules
./src	Entire source directory

Examples

# Generate for functions directory
pnpm exec aptx-ft barrel gen -i ./src/functions

# Generate for entire src directory
pnpm exec aptx-ft barrel gen -i ./src

# Generate for specific module
pnpm exec aptx-ft barrel gen -i ./src/api

Output

Recursively scans directory and generates barrel files at all levels:

src/
├── index.ts                    # Exports functions, react-query, spec
├── functions/
│   ├── index.ts                # Exports application, assignment, ...
│   └── application/
│       └── index.ts            # Exports getXXX, setXXX, ...
├── react-query/
│   ├── index.ts                # Exports application, assignment, ...
│   └── application/
│       └── index.ts            # Exports *.query.ts, *.mutation.ts
└── spec/
    └── ...

Boundaries

• Only generates index.ts barrel files, no other code
• Subdirectory index.ts files are overwritten
• Root index.ts is NOT overwritten if it exists with different content (protects manual entry files)
• Automatically skips node_modules and hidden directories (starting with .)
• Only processes .ts files, not .tsx, .js, etc.