Function toggleSort

packages/core/src/widgets/table.ts:341–354

(
  currentColumn: string | undefined,
  currentDirection: SortDirection | undefined,
  clickedColumn: string,
)

 * @returns New sort state
 */
export function toggleSort(
  currentColumn: string | undefined,
  currentDirection: SortDirection | undefined,
  clickedColumn: string,
): SortResult {
  if (currentColumn !== clickedColumn) {
    // New column: start ascending
    return Object.freeze({ column: clickedColumn, direction: "asc" });
  }

  // Same column: toggle direction
  const newDirection = currentDirection === "asc" ? "desc" : "asc";
  return Object.freeze({ column: clickedColumn, direction: newDirection });
}

/* ========== Row Key Extraction ========== */