Function buildSectionsFromPages

packages/dev/s2-docs/src/searchUtils.tsx:203–235

(pages: Page[], library: Library)

 * Sorts sections with 'Components' first.
 */
export function buildSectionsFromPages(pages: Page[], library: Library): Section[] {
  const filteredPages = pages.filter(
    page => getLibraryFromPage(page) === library && !page.exports?.hideFromSearch
  );

  const components = filteredPages.map(transformPageToComponentItem);

  const sectionNames = Array.from(new Set(components.map(c => c.section || 'Components')));

  return sectionNames
    .map(sectionName => ({
      id: sectionName.toLowerCase(),
      name: sectionName,
      children: components.filter(c => (c.section || 'Components') === sectionName)
    }))
    .sort((a, b) => {
      if (a.id === 'components') {
        return -1;
      }
      if (b.id === 'components') {
        return 1;
      }
      let ai = END_SECTIONS.indexOf(a.id);
      let bi = END_SECTIONS.indexOf(b.id);
      if (ai >= 0) {
        return bi < 0 ? 1 : ai - bi;
      }
      if (bi >= 0) {
        return ai < 0 ? -1 : bi - ai;
      }
      return a.name.localeCompare(b.name);
    });
}

/**
 * Gets items for a given section selection (handles 'all' and specific sections).