@node-core/ui-components 1.0.1-c0bc4dd7eb49f97f35ce0983849d17702404c76a → 1.0.1-da75492230302b0f459aab323d2f6fdac6269a06

package/Common/BaseCodeBox/index.tsx

@@ -1,122 +0,0 @@
-'use client';
-
-import { DocumentDuplicateIcon } from '@heroicons/react/24/outline';
-import classNames from 'classnames';
-import type { FC, PropsWithChildren, ReactElement } from 'react';
-import { Fragment, isValidElement, useRef } from 'react';
-
-import BaseButton from '#ui/Common/BaseButton';
-import type { LinkLike } from '#ui/types';
-
-import styles from './index.module.css';
-
-// Transforms a code element with plain text content into a more structured
-// format for rendering with line numbers
-const transformCode = <T extends ReactElement<PropsWithChildren>>(
-  code: T,
-  language: string
-): ReactElement<HTMLElement> | T => {
-  if (!isValidElement(code)) {
-    // Early return when the `CodeBox` child is not a valid element since the
-    // type is a ReactNode, and can assume any value
-    return code;
-  }
-
-  const content = code.props?.children;
-
-  if (code.type !== 'code' || typeof content !== 'string') {
-    // There is no need to transform an element that is not a code element or
-    // a content that is not a string
-    return code;
-  }
-
-  // Note that since we use `.split` we will have an extra entry
-  // being an empty string, so we need to remove it
-  const lines = content.split('\n');
-
-  const extraStyle = language.length === 0 ? { fontFamily: 'monospace' } : {};
-
-  return (
-    <code style={extraStyle}>
-      {lines
-        .flatMap((line, lineIndex) => {
-          const columns = line.split(' ');
-
-          return [
-            <span key={lineIndex} className="line">
-              {columns.map((column, columnIndex) => (
-                <Fragment key={columnIndex}>
-                  <span>{column}</span>
-                  {columnIndex < columns.length - 1 && <span> </span>}
-                </Fragment>
-              ))}
-            </span>,
-            // Add a break line so the text content is formatted correctly
-            // when copying to clipboard
-            '\n',
-          ];
-        })
-        // Here we remove that empty line from before and
-        // the last flatMap entry which is an `\n`
-        .slice(0, -2)}
-    </code>
-  );
-};
-
-interface CodeBoxProps {
-  language: string;
-  className?: string;
-  onCopy: (text: string) => void;
-  as?: LinkLike;
-  buttonText: string;
-  showCopyButton?: boolean;
-}
-
-const BaseCodeBox: FC<PropsWithChildren<CodeBoxProps>> = ({
-  children,
-  language,
-  className,
-  onCopy,
-  buttonText,
-  as = 'a',
-  showCopyButton = true,
-}: PropsWithChildren<CodeBoxProps>) => {
-  const containerRef = useRef<HTMLPreElement>(null);
-
-  const handleCopy = (): void => {
-    const text = containerRef.current?.textContent;
-    if (text) {
-      onCopy(text);
-    }
-  };
-
-  return (
-    <div className={styles.root}>
-      <pre
-        ref={containerRef}
-        className={classNames(styles.content, className)}
-        tabIndex={0}
-      >
-        {transformCode(children as ReactElement<PropsWithChildren>, language)}
-      </pre>
-      {language && (
-        <div className={styles.footer}>
-          <span className={styles.language}>{language}</span>
-          {showCopyButton && (
-            <BaseButton
-              as={as}
-              className={styles.action}
-              kind="neutral"
-              onClick={handleCopy}
-            >
-              <DocumentDuplicateIcon className={styles.icon} />
-              {buttonText}
-            </BaseButton>
-          )}
-        </div>
-      )}
-    </div>
-  );
-};
-
-export default BaseCodeBox;

package/Common/BaseCrossLink/index.stories.tsx

@@ -1,38 +0,0 @@
-import type { Meta as MetaObj, StoryObj } from '@storybook/react';
-
-import BaseCrossLink from '#ui/Common/BaseCrossLink';
-
-type Story = StoryObj<typeof BaseCrossLink>;
-type Meta = MetaObj<typeof BaseCrossLink>;
-
-export const Prev: Story = {
-  args: {
-    type: 'previous',
-    text: 'How to install Node.js',
-    link: 'https://nodejs.dev/en/learn/how-to-install-nodejs/',
-  },
-  decorators: [
-    Story => (
-      <div className="w-[305px]">
-        <Story />
-      </div>
-    ),
-  ],
-};
-
-export const Next: Story = {
-  args: {
-    type: 'next',
-    text: 'How much JavaScript do you need to know to use Node.js?',
-    link: 'https://nodejs.dev/en/learn/how-much-javascript-do-you-need-to-know-to-use-nodejs/',
-  },
-  decorators: [
-    Story => (
-      <div className="w-[305px]">
-        <Story />
-      </div>
-    ),
-  ],
-};
-
-export default { component: BaseCrossLink } as Meta;

package/Common/BaseCrossLink/index.tsx

@@ -1,46 +0,0 @@
-import classNames from 'classnames';
-import type { FC } from 'react';
-
-import PrevNextArrow from '#ui/Common/BasePagination/PrevNextArrow';
-import type { LinkLike, FormattedMessage } from '#ui/types';
-
-import styles from './index.module.css';
-
-export type CrossLinkProps = {
-  type: 'previous' | 'next';
-  text: FormattedMessage;
-  label: string;
-  link: string;
-  as: LinkLike;
-};
-
-const BaseCrossLink: FC<CrossLinkProps> = ({
-  type,
-  label,
-  text,
-  link,
-  as: Component = 'a',
-}) => {
-  return (
-    <Component className={styles.crossLink} href={link}>
-      <span
-        className={classNames(styles.header, {
-          [styles.reverse]: type === 'next',
-        })}
-      >
-        <PrevNextArrow className={styles.icon} type={type} />
-        {label}
-      </span>
-
-      <span
-        className={classNames(styles.content, {
-          [styles.reverse]: type === 'next',
-        })}
-      >
-        {text}
-      </span>
-    </Component>
-  );
-};
-
-export default BaseCrossLink;

package/Common/BaseLinkTabs/index.stories.tsx

@@ -1,34 +0,0 @@
-import type { Meta as MetaObj, StoryObj } from '@storybook/react';
-
-import BaseLinkTabs from '#ui/Common/BaseLinkTabs';
-
-type Story = StoryObj<typeof BaseLinkTabs>;
-type Meta = MetaObj<typeof BaseLinkTabs>;
-
-export const Default: Story = {
-  args: {
-    label: 'Select Tab',
-    tabs: [
-      {
-        key: 'package',
-        label: 'Package Manager',
-        link: '/package-manager',
-      },
-      {
-        key: 'prebuilt',
-        label: 'Prebuilt Installer',
-        link: '/prebuilt-installer',
-      },
-      {
-        key: 'source',
-        label: 'Source Code',
-        link: '/source-code',
-      },
-    ],
-    activeTab: 'prebuilt',
-    children: <p>Tab content goes here</p>,
-    onSelect: console.log,
-  },
-};
-
-export default { component: BaseLinkTabs } as Meta;

package/Common/BaseLinkTabs/index.tsx

@@ -1,53 +0,0 @@
-import type { FC, PropsWithChildren } from 'react';
-
-import Select from '#ui/Common/Select';
-import type { LinkLike } from '#ui/types';
-
-import styles from './index.module.css';
-
-type LinkTab = { key: string; label: string; link: string };
-
-export type LinkTabsProps = PropsWithChildren<{
-  label?: string;
-  tabs: Array<LinkTab>;
-  activeTab: string;
-  as?: LinkLike;
-  onSelect: (value: string) => void;
-}>;
-
-const BaseLinkTabs: FC<LinkTabsProps> = ({
-  tabs,
-  label,
-  activeTab,
-  children,
-  as: Component = 'a',
-  onSelect,
-}) => (
-  <>
-    <div className={styles.tabsList}>
-      {tabs.map(tab => (
-        <Component
-          key={tab.key}
-          href={tab.link}
-          className={styles.tabsTrigger}
-          data-state={tab.key === activeTab ? 'active' : 'inactive'}
-        >
-          {tab.label}
-        </Component>
-      ))}
-    </div>
-
-    <div className={styles.tabsSelect}>
-      <Select
-        label={label}
-        defaultValue={tabs.find(tab => tab.key === activeTab)?.link}
-        values={tabs.map(tab => ({ label: tab.label, value: tab.link }))}
-        onChange={onSelect}
-      />
-    </div>
-
-    {children}
-  </>
-);
-
-export default BaseLinkTabs;

package/Common/BasePagination/Ellipsis/index.stories.tsx

@@ -1,10 +0,0 @@
-import type { Meta as MetaObj, StoryObj } from '@storybook/react';
-
-import Ellipsis from '#ui/Common/BasePagination/Ellipsis';
-
-type Story = StoryObj<typeof Ellipsis>;
-type Meta = MetaObj<typeof Ellipsis>;
-
-export const Default: Story = {};
-
-export default { component: Ellipsis } as Meta;

package/Common/BasePagination/Ellipsis/index.tsx

@@ -1,11 +0,0 @@
-import type { FC } from 'react';
-
-import styles from './index.module.css';
-
-const Ellipsis: FC = () => (
-  <span aria-hidden="true" className={styles.ellipsis}>
-    ...
-  </span>
-);
-
-export default Ellipsis;

package/Common/BasePagination/PaginationListItem/__tests__/index.test.jsx

@@ -1,58 +0,0 @@
-import { describe, it } from 'node:test';
-import assert from 'node:assert/strict';
-
-import { render, screen } from '@testing-library/react';
-
-import { isVisible } from '../../../../../../tests/utilities.mjs';
-
-import PaginationListItem from '#ui/Common/BasePagination/PaginationListItem';
-
-function renderPaginationListItem({
-  url,
-  pageNumber,
-  currentPage,
-  totalPages,
-}) {
-  render(
-    <PaginationListItem
-      url={url}
-      pageNumber={pageNumber}
-      currentPage={currentPage}
-      totalPages={totalPages}
-    />
-  );
-}
-
-describe('PaginationListItem', () => {
-  it('Renders the list item correctly, including the corresponding ARIA attributes', () => {
-    const pageNumber = 1;
-    const totalPages = 10;
-    const url = 'http://';
-
-    renderPaginationListItem({
-      url,
-      currentPage: 1,
-      pageNumber,
-      totalPages,
-    });
-
-    const listItem = screen.getByRole('listitem');
-
-    assert.ok(isVisible());
-    assert.equal(listItem.getAttribute('aria-posinset'), String(pageNumber));
-    assert.equal(listItem.getAttribute('aria-setsize'), String(totalPages));
-
-    assert.equal(screen.getByRole('link').getAttribute('href'), url);
-  });
-
-  it('Assigns aria-current="page" attribute to the link when the current page is equal to the page number', () => {
-    renderPaginationListItem({
-      url: 'http://',
-      currentPage: 1,
-      pageNumber: 1,
-      totalPages: 10,
-    });
-
-    assert.equal(screen.getByRole('link').getAttribute('aria-current'), 'page');
-  });
-});

package/Common/BasePagination/PaginationListItem/index.stories.tsx

@@ -1,40 +0,0 @@
-import type { Meta as MetaObj, StoryObj } from '@storybook/react';
-
-import PaginationListItem from '#ui/Common/BasePagination/PaginationListItem';
-
-type Story = StoryObj<typeof PaginationListItem>;
-type Meta = MetaObj<typeof PaginationListItem>;
-
-export const Default: Story = {
-  args: {
-    url: '#',
-    pageNumber: 1,
-    currentPage: 2,
-    totalPages: 2,
-  },
-  decorators: [
-    Story => (
-      <ul className="list-none">
-        <Story />
-      </ul>
-    ),
-  ],
-};
-
-export const CurrentPage: Story = {
-  args: {
-    url: '#',
-    pageNumber: 1,
-    currentPage: 1,
-    totalPages: 1,
-  },
-  decorators: [
-    Story => (
-      <ul className="list-none">
-        <Story />
-      </ul>
-    ),
-  ],
-};
-
-export default { component: PaginationListItem } as Meta;

package/Common/BasePagination/PaginationListItem/index.tsx

@@ -1,39 +0,0 @@
-import type { FC } from 'react';
-
-import type { LinkLike } from '#ui/types';
-
-import styles from './index.module.css';
-
-export type PaginationListItemProps = {
-  url: string;
-  pageNumber: number;
-  // One-based number of the current page
-  currentPage: number;
-  totalPages: number;
-  as?: LinkLike;
-  label: string;
-};
-
-const PaginationListItem: FC<PaginationListItemProps> = ({
-  url,
-  pageNumber,
-  currentPage,
-  totalPages,
-  as: Component = 'a',
-  label,
-}) => {
-  return (
-    <li key={pageNumber} aria-setsize={totalPages} aria-posinset={pageNumber}>
-      <Component
-        href={url}
-        aria-label={label}
-        className={styles.listItem}
-        {...(pageNumber === currentPage && { 'aria-current': 'page' })}
-      >
-        <span>{pageNumber}</span>
-      </Component>
-    </li>
-  );
-};
-
-export default PaginationListItem;

package/Common/BasePagination/PrevNextArrow.tsx

@@ -1,15 +0,0 @@
-import { ChevronLeftIcon, ChevronRightIcon } from '@heroicons/react/24/solid';
-import type { FC, SVGAttributes } from 'react';
-
-type PrevNextArrowProps = {
-  type: 'previous' | 'next';
-} & SVGAttributes<SVGSVGElement>;
-
-const PrevNextArrow: FC<PrevNextArrowProps> = ({ type, ...extra }) => {
-  const ChevronComponent =
-    type === 'previous' ? ChevronLeftIcon : ChevronRightIcon;
-
-  return <ChevronComponent {...extra} />;
-};
-
-export default PrevNextArrow;

package/Common/BasePagination/__tests__/index.test.jsx

@@ -1,180 +0,0 @@
-import { describe, it } from 'node:test';
-import assert from 'node:assert/strict';
-
-import { render, screen } from '@testing-library/react';
-
-import { isVisible } from '../../../../../tests/utilities.mjs';
-
-import BasePagination from '#ui/Common/BasePagination';
-
-const getPageLabel = number => number.toString();
-const labels = {
-  aria: 'Aria',
-  prevAria: 'Previous Aria',
-  prev: 'Previous',
-  nextAria: 'Next Aria',
-  next: 'Next',
-};
-
-function renderPagination({
-  currentPage = 1,
-  pages,
-  currentPageSiblingsCount,
-}) {
-  const parsedPages = new Array(pages)
-    .fill({ url: 'page' })
-    .map(item => ({ url: `${item.url}-${Math.random()}` }));
-
-  render(
-    <BasePagination
-      currentPage={currentPage}
-      pages={parsedPages}
-      currentPageSiblingsCount={currentPageSiblingsCount}
-      getPageLabel={getPageLabel}
-      labels={labels}
-    />
-  );
-
-  return {
-    currentPage,
-    parsedPages,
-  };
-}
-
-describe('Pagination', () => {
-  describe('Rendering', () => {
-    it('Renders the navigation buttons even if no pages are passed to it', () => {
-      renderPagination({ currentPage: 0, pages: 0 });
-
-      assert.ok(isVisible(screen.getByRole('navigation')));
-      assert.ok(
-        isVisible(
-          screen.getByRole('button', {
-            name: labels.prevAria,
-          })
-        )
-      );
-      assert.ok(
-        isVisible(
-          screen.getByRole('button', {
-            name: labels.nextAria,
-          })
-        )
-      );
-    });
-
-    it('Renders the passed pages and current page', () => {
-      const { currentPage, parsedPages } = renderPagination({
-        pages: 4,
-      });
-
-      const pageElements = screen.getAllByRole('link');
-
-      assert.equal(pageElements.length, parsedPages.length);
-
-      pageElements.forEach((page, index) => {
-        if (index + 1 === currentPage) {
-          assert.strictEqual(page.getAttribute('aria-current'), 'page');
-        }
-
-        assert.ok(isVisible(page));
-      });
-    });
-  });
-
-  describe('Ellipsis behavior', () => {
-    it('When the pages size is equal or smaller than currentPageSiblingsCount + 5, all pages are shown', () => {
-      renderPagination({
-        pages: 6,
-      });
-
-      assert.ok(!screen.queryByText('...')?.ownerDocument);
-
-      const pageElements = screen.getAllByRole('link');
-
-      assert.deepEqual(
-        pageElements.map(element => element.textContent),
-        ['1', '2', '3', '4', '5', '6']
-      );
-    });
-
-    it('Shows left ellipsis when the left sibling of the current page is at least two pages away from the first page', () => {
-      renderPagination({
-        currentPage: 5,
-        pages: 8,
-      });
-
-      assert.ok(isVisible(screen.getByText('...')));
-
-      const pageElements = screen.getAllByRole('link');
-
-      assert.deepEqual(
-        pageElements.map(element => element.textContent),
-        ['1', '4', '5', '6', '7', '8']
-      );
-    });
-
-    it('Shows right ellipsis when the right sibling of the current page is at least two pages away from the last page', () => {
-      renderPagination({
-        currentPage: 3,
-        pages: 8,
-      });
-
-      assert.ok(isVisible(screen.getByText('...')));
-
-      const pageElements = screen.getAllByRole('link');
-
-      assert.deepEqual(
-        pageElements.map(element => element.textContent),
-        ['1', '2', '3', '4', '5', '8']
-      );
-    });
-
-    it('Shows right and left ellipses when the current page siblings are both at least two pages away from the first and last pages', () => {
-      renderPagination({
-        currentPage: 5,
-        pages: 10,
-      });
-
-      assert.equal(screen.getAllByText('...').length, 2);
-
-      const pageElements = screen.getAllByRole('link');
-
-      assert.deepEqual(
-        pageElements.map(element => element.textContent),
-        ['1', '4', '5', '6', '10']
-      );
-    });
-  });
-
-  describe('Navigation buttons', () => {
-    it('Disables "Previous" button when the currentPage is equal to the first page', () => {
-      renderPagination({
-        pages: 2,
-      });
-
-      assert.ok(
-        screen
-          .getByRole('button', {
-            name: labels.prevAria,
-          })
-          .getAttribute('aria-disabled')
-      );
-    });
-
-    it('Disables "Next" button when the currentPage is equal to the last page', () => {
-      renderPagination({
-        currentPage: 2,
-        pages: 2,
-      });
-
-      assert.ok(
-        screen
-          .getByRole('button', {
-            name: labels.nextAria,
-          })
-          .getAttribute('aria-disabled')
-      );
-    });
-  });
-});