sidebars.ts

import type { SidebarsConfig } from '@docusaurus/plugin-content-docs';

/**
 * Creating a sidebar enables you to:
 - create an ordered group of docs
 - render a sidebar for each doc of that group
 - provide next/previous navigation

 The sidebars can be generated from the filesystem, or explicitly defined here.

 Create as many sidebars as you want.
 */
type SidebarItems = Extract<SidebarsConfig[string], unknown[]>;
type SidebarCategory = SidebarItems extends (infer U)[] ? Extract<U, { type: 'category' }> : never;

const typedocItems: SidebarItems = JSON.parse(
  JSON.stringify(require('./docs/api/typedoc-sidebar.cjs')),
  function (key, value) {
    if (key === 'id' && typeof value === 'string') {
      return value.replace(/\\/g, '/');
    }
    return value;
  }
);

function findSidebarCategory(items: SidebarItems, label: string): SidebarCategory {
  return items.find((item): item is SidebarCategory =>
    typeof item === 'object' &&
    item.type === 'category' &&
    item.label === label
  );
}

const sidebars: SidebarsConfig = {
  docs: [
    'intro',
    {
      type: 'category',
      label: 'Concepts',
      link: {
        type: 'generated-index',
      },
      collapsed: false,
      items: [{type: 'autogenerated', dirName: 'concepts'}],
    },
    {
      type: 'category',
      label: 'Components',
      link: {
        type: 'generated-index',
      },
      items: [{type: 'autogenerated', dirName: 'components'}],
    },
    {
      type: 'category',
      label: 'Examples',
      link: {
        type: 'generated-index',
      },
      collapsed: false,
      items: [{type: 'autogenerated', dirName: 'examples'}],
    },
  ],

  api: [
    {
      type: 'doc',
      id: 'api/index',
      label: 'Package Modules',
    },
    {
      ...findSidebarCategory(typedocItems, 'workspace'),
      label: '@reactodia/workspace',
      collapsed: false,
    },
    {
      ...findSidebarCategory(typedocItems, 'layout-sync'),
      label: '/layout-sync',
    },
    {
      ...findSidebarCategory(typedocItems, 'layout.worker'),
      label: '/layout.worker',
    },
    {
      ...findSidebarCategory(typedocItems, 'legacy-styles'),
      label: '/legacy-styles',
    },
  ],
};

export default sidebars;