Function sortItemsForDisplay

packages/dev/s2-docs/src/searchUtils.tsx:699–731

(
  items: T[],
  searchValue: string
)

}

export function sortItemsForDisplay<T extends {name: string; href: string; date?: string}>(
  items: T[],
  searchValue: string
): T[] {
  if (searchValue.trim().length === 0) {
    return [...items].sort((a, b) => {
      const aIsIntro = a.href.endsWith('/');
      const bIsIntro = b.href.endsWith('/');

      // Date sorting for Blog/Releases
      if (a.date && b.date) {
        const aDate = new Date(a.date);
        const bDate = new Date(b.date);
        return bDate.getTime() - aDate.getTime();
      } else if (a.date && !b.date) {
        return 1;
      } else if (!a.date && b.date) {
        return -1;
      }

      // Introduction first
      if (aIsIntro && !bIsIntro) {
        return -1;
      }
      if (!aIsIntro && bIsIntro) {
        return 1;
      }
      // Sort alphabetically by name
      return a.name.localeCompare(b.name);
    });
  }
  return items;
}

export function createSearchOptions<
  T extends {name: string; tags: string[]; date?: string; section?: string}