Allow setting a default grouping direction via 'defaultGroup()'

[levizandbergenTO]

Feature description

When using ->defaultGroup() on a table, the grouping direction is always initialized to asc. There is no API to configure the default direction.

Use case

A table with records naturally sorted descending (newest first) may look like this:

  ->defaultSort('created_at', 'desc')
  ->defaultGroup('order_id')                                                                                                                                                                                                                                                                                       
  ->groups([
      Group::make('order_id')                                                                                                                                                                                                                                                                                      
          ->orderQueryUsing(
              fn (Builder $query, string $direction) =>
                  $query->orderBy('created_at', $direction)
          ),                                                                                                                                                                                                                                                                                                       
  ])

The defaultSort has no effect on group ordering. The group direction is hardcoded to asc in InteractsWithTable::bootedInteractsWithTable():

  // packages/tables/src/Concerns/InteractsWithTable.php
  $this->tableGrouping = "{$this->getTable()->getDefaultGroup()->getId()}:asc";        

Proposed solution

Add a defaultGroupingDirection() method on Table, or accept a direction parameter in defaultGroup():

  // Option A — separate method                                                                                                                                                                                                                                                                                    
  ->defaultGroup('order_id')
  ->defaultGroupingDirection('desc')

  // Option B — second parameter
  ->defaultGroup('order_id', 'desc')

The value would then be read in bootedInteractsWithTable() instead of the hardcoded 'asc'.

Workaround

Currently this requires overriding bootedInteractsWithTable() in the resource's ListRecords page:

  public function bootedInteractsWithTable(): void
  {                                                                                                                                                                                                                                                                                                                
      parent::bootedInteractsWithTable();
                                                                                                                                                                                                                                                                                                                   
      if ($this->shouldMountInteractsWithTable) {           
          $this->tableGrouping = 'order_id:desc';
      }
  }

This works but relies on framework internals.

Filament version

5.x