feat: create toc component (nodejs#8560)

* feat: create toc component

* refactor(ui-components): review

* fix: custom anchor component

* refactor: review

* feat: i18n prop

* choire: patch version

* review(ui-components): some nits

Author: araujogui

packages/ui-components/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@node-core/ui-components",
-  "version": "1.5.5",
+  "version": "1.5.6",
   "type": "module",
   "exports": {
     "./*": [

packages/ui-components/src/Common/TableOfContents/index.module.css

@@ -0,0 +1,39 @@
+@reference "../../styles/index.css";
+
+.details {
+  @apply my-2
+    block
+    rounded-md
+    bg-neutral-200
+    lg:hidden
+    dark:bg-neutral-900;
+
+  .summary {
+    @apply px-4
+      py-2;
+  }
+
+  .list {
+    @apply space-y-1
+      px-4
+      pb-2;
+  }
+
+  .link {
+    @apply text-sm
+      font-semibold
+      text-neutral-900
+      underline
+      hover:text-neutral-700
+      dark:text-white
+      dark:hover:text-neutral-500;
+  }
+
+  .depthThree {
+    @apply pl-2;
+  }
+
+  .depthFour {
+    @apply pl-4;
+  }
+}

packages/ui-components/src/Common/TableOfContents/index.stories.tsx

@@ -0,0 +1,65 @@
+import TableOfContents from '#ui/Common/TableOfContents';
+
+import type { Meta as MetaObj, StoryObj } from '@storybook/react-webpack5';
+
+type Story = StoryObj<typeof TableOfContents>;
+type Meta = MetaObj<typeof TableOfContents>;
+
+export const Default: Story = {};
+
+export const CustomDepth: Story = {
+  args: {
+    minDepth: 1,
+    maxDepth: 6,
+  },
+};
+
+export default {
+  component: TableOfContents,
+  args: {
+    ariaLabel: 'Table of Contents',
+    summaryTitle: 'On this page',
+    headings: [
+      {
+        value: 'OpenSSL update assessment, and Node.js project plans',
+        depth: 1,
+        data: { id: 'heading-1' },
+      },
+      {
+        value: 'Summary',
+        depth: 2,
+        data: { id: 'summary' },
+      },
+      {
+        value: 'Analysis',
+        depth: 2,
+        data: { id: 'analysis' },
+      },
+      {
+        value: 'The c_rehash script allows command injection (CVE-2022-2068)',
+        depth: 3,
+        data: { id: 'the_c_rehash' },
+      },
+      {
+        value: 'Contact and future updates',
+        depth: 3,
+        data: { id: 'contact_and_future_updates' },
+      },
+      {
+        value: 'Email',
+        depth: 4,
+        data: { id: 'email' },
+      },
+      {
+        value: 'Slack',
+        depth: 4,
+        data: { id: 'slack' },
+      },
+      {
+        value: '#node-website',
+        depth: 5, // h5s do not get shown
+        data: { id: 'node-website' },
+      },
+    ],
+  },
+} as Meta;

packages/ui-components/src/Common/TableOfContents/index.tsx

@@ -0,0 +1,55 @@
+import classNames from 'classnames';
+
+import { LinkLike } from '#ui/types';
+
+import type { Heading } from '@vcarl/remark-headings';
+import type { ComponentProps, FC } from 'react';
+
+import styles from './index.module.css';
+
+const depthClasses: Record<number, string> = {
+  3: styles.depthThree,
+  4: styles.depthFour,
+};
+
+type TableOfContentsProps = ComponentProps<'details'> & {
+  headings: Array<Heading>;
+  summaryTitle: string;
+  minDepth?: number;
+  maxDepth?: number;
+  as?: LinkLike;
+};
+
+const TableOfContents: FC<TableOfContentsProps> = ({
+  headings,
+  summaryTitle,
+  minDepth = 2,
+  className,
+  maxDepth = 4,
+  as: Component = 'a',
+  ...props
+}) => {
+  const filteredHeadings = headings.filter(
+    ({ depth }) => depth >= minDepth && depth <= maxDepth
+  );
+
+  return (
+    <details className={classNames(styles.details, className)} {...props}>
+      <summary className={styles.summary}>{summaryTitle}</summary>
+      <ul className={styles.list}>
+        {filteredHeadings.map((head, index) => (
+          <li key={head.data?.id ?? index}>
+            <Component
+              href={head.data?.id && `#${head.data.id}`}
+              className={classNames(styles.link, depthClasses[head.depth])}
+            >
+              {head.value}
+            </Component>
+          </li>
+        ))}
+      </ul>
+    </details>
+  );
+};
+
+export default TableOfContents;