useSortedInterfaceMembers

TypeScript and TSX

Summary

Diagnostic Category: assist/source/useSortedInterfaceMembers
Sources:
- Inspired from perfectionist/sort-interfaces

How to enable in your editor

1
{
2
  "editor.codeActionsOnSave": {
3
    "source.action.useSortedInterfaceMembers.biome": "explicit",
4
    "source.fixAll.biome": "explicit"
5
  }
6
}

1
{
2
  "code_actions_on_format": {
3
    "source.action.useSortedInterfaceMembers.biome": true,
4
    "source.fixAll.biome": true
5
  }
6
}

Use the source action code source.action.useSortedInterfaceMembers.biome

How to configure

1
{
2
  "assist": {
3
    "actions": {
4
      "source": {
5
        "useSortedInterfaceMembers": "on"
6
      }
7
    }
8
  }
9
}

Description

Sort interface members by key.

Interface members are sorted according to their names. The rule distinguishes between two types of members:

Sortable members - Members with explicit, fixed names that can be alphabetically sorted:

Property signatures: property: type
Method signatures: method(): type
Getter signatures: get property(): type
Setter signatures: set property(value: type): void

Non-sortable members - Members without fixed names or with dynamic/computed names:

Call signatures: (): type (represents the interface as a callable function)
Construct signatures: new (): type (represents the interface as a constructor)
Index signatures: [key: string]: type (represents dynamic property access)

The rule sorts all sortable members alphabetically and places them first, followed by non-sortable members in their original order. Non-sortable members cannot be meaningfully sorted by name since they represent different interface contracts rather than named properties or methods.

Examples

Invalid

1
interface MixedMembers {
2
  z: string;
3
  a: number;
4
  (): void;  // Call signature
5
  y: boolean;
6
  new (): MixedMembers;  // Construct signature
7
  b: string;
8
  [key: string]: any;  // Index signature
9
}

code-block.ts:1:1 assist/source/useSortedInterfaceMembers  FIXABLE  ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

  ℹ The interface members are not sorted by key.
  
   > 1 │ interface MixedMembers {
       │ ^^^^^^^^^^^^^^^^^^^^^^^^
   > 2 │   z: string;
   > 3 │   a: number;
   > 4 │   (): void;  // Call signature
   > 5 │   y: boolean;
   > 6 │   new (): MixedMembers;  // Construct signature
   > 7 │   b: string;
   > 8 │   [key: string]: any;  // Index signature
   > 9 │ }
       │ ^
    10 │ 
  
  ℹ Safe fix: Sort the interface members by key.
  
     1  1 │   interface MixedMembers {
     2    │ - ··z:·string;
     3    │ - ··a:·number;
     4    │ - ··():·void;··//·Call·signature
     5    │ - ··y:·boolean;
     6    │ - ··new·():·MixedMembers;··//·Construct·signature
     7    │ - ··b:·string;
        2 │ + ··a:·number;
        3 │ + ··b:·string;
        4 │ + ··y:·boolean;
        5 │ + ··z:·string;
        6 │ + ··():·void;··//·Call·signature
        7 │ + ··new·():·MixedMembers;··//·Construct·signature
     8  8 │     [key: string]: any;  // Index signature
     9  9 │   }

Valid

1
interface MixedMembers {
2
  a: number;
3
  b: string;
4
  y: boolean;
5
  z: string;
6
  (): void;  // Non-sortable members remain in original order
7
  new (): MixedMembers;
8
  [key: string]: any;
9
}