README.md

📦 Sort Component Imports Builder

An Angular builder that automatically sorts the imports array within @Component decorators using TypeScript AST analysis. ✨

📋 Example Output

@Component({
  selector: 'app-root',
  imports: [
    RouterOutlet,
    ThemeColorSelectComponent,
    ThemeTypeSelectComponent,
    ToolbarComponent,
    ToolbarLogoComponent,
    ToolbarMenuComponent,
  ],
  ...
})

Imports are sorted alphabetically.

🚀 Quick Start

📝 Add to angular.json

{
  ...,
  "projects": {
    "your-project-name": {
      ...,
      "architect": {
        ...,
        "sort-imports": {
          "builder": "ngx-devkit-builders:sort-imports",
          "options": {
            "dryRun": false,
            "verbose": false,
            "includeDirectives": true
          }
        }
      }
    }
  }
}

▶️ Run the builder

# Sort imports in a specific project
ng run your-project-name:sort-imports

# Dry run to preview changes
ng run your-project-name:sort-imports --dryRun=true

# Verbose output with detailed import information
ng run your-project-name:sort-imports --verbose=true

# Components only (exclude directives)
ng run your-project-name:sort-imports --includeDirectives=false

⚙️ Options

Option	Type	Default	Description
project	string	-	The name of the project to sort imports for
dryRun	boolean	false	Run without making changes to files
verbose	boolean	false	Show detailed output
includeDirectives	boolean	true	Include directives in addition to components