@node-core/ui-components 1.0.1-ed840c2c5b3a7f7a58ec6d75280c2b34129fb5dc → 1.0.1-f1580a0a3365d3d4d0236b80ce9eff447d2890dd

package/Common/AvatarGroup/index.tsx

@@ -1,83 +0,0 @@
-'use client';
-
-import classNames from 'classnames';
-import type { FC } from 'react';
-import { useState, useMemo } from 'react';
-
-import type { AvatarProps } from '#ui/Common/AvatarGroup/Avatar';
-import Avatar from '#ui/Common/AvatarGroup/Avatar';
-import avatarstyles from '#ui/Common/AvatarGroup/Avatar/index.module.css';
-import AvatarOverlay from '#ui/Common/AvatarGroup/Overlay';
-import Tooltip from '#ui/Common/Tooltip';
-import type { LinkLike } from '#ui/types';
-
-import styles from './index.module.css';
-
-type AvatarGroupProps = {
-  avatars: Array<AvatarProps>;
-  limit?: number;
-  isExpandable?: boolean;
-  size?: AvatarProps['size'];
-  container?: HTMLElement;
-  as?: LinkLike;
-};
-
-const AvatarGroup: FC<AvatarGroupProps> = ({
-  avatars,
-  limit = 10,
-  isExpandable = true,
-  size = 'small',
-  container,
-  as,
-}) => {
-  const [showMore, setShowMore] = useState(false);
-
-  const renderAvatars = useMemo(
-    () => avatars.slice(0, showMore ? avatars.length : limit),
-    [avatars, limit, showMore]
-  );
-
-  const handleShowMoreClick = isExpandable
-    ? () => setShowMore(prev => !prev)
-    : undefined;
-
-  return (
-    <div className={classNames(styles.avatarGroup, styles[size])}>
-      {renderAvatars.map(avatar => (
-        <Tooltip
-          key={avatar.nickname}
-          asChild
-          container={container}
-          content={<AvatarOverlay {...avatar} as={as} />}
-        >
-          <Avatar
-            {...avatar}
-            size={size}
-            className={classNames({
-              'cursor-pointer': avatar.url,
-              'pointer-events-none': !avatar.url,
-            })}
-            as={as}
-          />
-        </Tooltip>
-      ))}
-
-      {avatars.length > limit && (
-        <span
-          onClick={handleShowMoreClick}
-          className={classNames(
-            avatarstyles.avatar,
-            avatarstyles[size],
-            'cursor-pointer'
-          )}
-        >
-          <span className={avatarstyles.item}>
-            {`${showMore ? '-' : '+'}${avatars.length - limit}`}
-          </span>
-        </span>
-      )}
-    </div>
-  );
-};
-
-export default AvatarGroup;

package/Common/Badge/index.stories.tsx

@@ -1,38 +0,0 @@
-import type { Meta as MetaObj, StoryObj } from '@storybook/react';
-
-import Badge from '#ui/Common/Badge';
-
-type Story = StoryObj<typeof Badge>;
-type Meta = MetaObj<typeof Badge>;
-
-export const Default: Story = {
-  args: {
-    kind: 'default',
-  },
-};
-
-export const Error: Story = {
-  args: {
-    kind: 'error',
-  },
-};
-
-export const Warning: Story = {
-  args: {
-    kind: 'warning',
-  },
-};
-
-export const Small: Story = {
-  args: {
-    size: 'small',
-  },
-};
-
-export const Medium: Story = {
-  args: {
-    size: 'medium',
-  },
-};
-
-export default { component: Badge, args: { children: 'Badge' } } as Meta;

package/Common/Badge/index.tsx

@@ -1,35 +0,0 @@
-import classNames from 'classnames';
-import type { FC, HTMLAttributes, PropsWithChildren } from 'react';
-
-import styles from './index.module.css';
-
-type BadgeKind = 'default' | 'warning' | 'error';
-
-type BadgeProps = HTMLAttributes<HTMLSpanElement> & {
-  size?: 'small' | 'medium';
-  kind?: BadgeKind;
-};
-
-const Badge: FC<PropsWithChildren<BadgeProps>> = ({
-  kind = 'default',
-  size = 'medium',
-  className,
-  children,
-  ...props
-}) => {
-  return (
-    <span
-      className={classNames(
-        styles.badge,
-        styles[kind],
-        styles[size],
-        className
-      )}
-      {...props}
-    >
-      {children}
-    </span>
-  );
-};
-
-export default Badge;

package/Common/BadgeGroup/index.stories.tsx

@@ -1,35 +0,0 @@
-import type { Meta as MetaObj, StoryObj } from '@storybook/react';
-
-import BadgeGroup from '#ui/Common/BadgeGroup';
-
-type Story = StoryObj<typeof BadgeGroup>;
-type Meta = MetaObj<typeof BadgeGroup>;
-
-export const Default: Story = {
-  args: {
-    href: '/',
-    children: 'OpenJS Foundation Certification 2023',
-    kind: 'default',
-    badgeText: 'New',
-  },
-};
-
-export const Error: Story = {
-  args: {
-    href: '/',
-    children: 'OpenJS Foundation Certification 2023',
-    kind: 'error',
-    badgeText: 'New',
-  },
-};
-
-export const Warning: Story = {
-  args: {
-    href: '/',
-    children: 'OpenJS Foundation Certification 2023',
-    kind: 'warning',
-    badgeText: 'New',
-  },
-};
-
-export default { component: BadgeGroup } as Meta;

package/Common/BadgeGroup/index.tsx

@@ -1,35 +0,0 @@
-import ArrowRightIcon from '@heroicons/react/24/solid/ArrowRightIcon';
-import type { ComponentProps, FC, PropsWithChildren } from 'react';
-
-import Badge from '#ui/Common/Badge';
-import type { LinkLike } from '#ui/types';
-
-import styles from './index.module.css';
-
-type BadgeGroupKind = 'default' | 'warning' | 'error';
-
-type BadgeGroupProps = {
-  kind?: BadgeGroupKind;
-  badgeText?: string;
-  as: LinkLike;
-} & ComponentProps<LinkLike>;
-
-const BadgeGroup: FC<PropsWithChildren<BadgeGroupProps>> = ({
-  kind = 'default',
-  badgeText,
-  children,
-  as: Component = 'a',
-  ...args
-}) => (
-  <Component className={`${styles.wrapper} ${styles[kind]}`} {...args}>
-    {badgeText && (
-      <Badge kind={kind} className={styles.badge}>
-        {badgeText}
-      </Badge>
-    )}
-    <span className={styles.message}>{children}</span>
-    {args.href && <ArrowRightIcon className={styles.icon} />}
-  </Component>
-);
-
-export default BadgeGroup;

package/Common/Banner/index.stories.tsx

@@ -1,29 +0,0 @@
-import type { Meta as MetaObj, StoryObj } from '@storybook/react';
-
-import Banner from '#ui/Common/Banner';
-
-type Story = StoryObj<typeof Banner>;
-type Meta = MetaObj<typeof Banner>;
-
-export const Default: Story = {
-  args: {
-    children: 'Lorem ipsum dolor sit amet, consectetur adipiscing elit.',
-    type: 'default',
-  },
-};
-
-export const Error: Story = {
-  args: {
-    children: 'Lorem ipsum dolor sit amet, consectetur adipiscing elit.',
-    type: 'error',
-  },
-};
-
-export const Warning: Story = {
-  args: {
-    children: 'Lorem ipsum dolor sit amet, consectetur adipiscing elit.',
-    type: 'warning',
-  },
-};
-
-export default { component: Banner } as Meta;

package/Common/Banner/index.tsx

@@ -1,18 +0,0 @@
-import type { FC, PropsWithChildren } from 'react';
-
-import styles from './index.module.css';
-
-export type BannerProps = {
-  type?: 'default' | 'warning' | 'error';
-};
-
-const Banner: FC<PropsWithChildren<BannerProps>> = ({
-  type = 'default',
-  children,
-}) => (
-  <div className={`${styles.banner} ${styles[type] || styles.default}`}>
-    {children}
-  </div>
-);
-
-export default Banner;

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

@@ -1,52 +0,0 @@
-import { describe, it } from 'node:test';
-import assert from 'node:assert/strict';
-
-import { render, screen } from '@testing-library/react';
-
-import ActiveLink from '..';
-
-describe('ActiveLink', () => {
-  it('renders as localized link', async () => {
-    render(
-      <ActiveLink className="link" activeClassName="active" href="/link">
-        Link
-      </ActiveLink>
-    );
-
-    assert.equal(
-      (await screen.findByText('Link')).getAttribute('href'),
-      '/link'
-    );
-  });
-
-  it('ignores active class when href not matches location.href', async () => {
-    render(
-      <ActiveLink className="link" activeClassName="active" href="/not-link">
-        Link
-      </ActiveLink>
-    );
-
-    assert.equal(
-      (await screen.findByText('Link')).getAttribute('class'),
-      'link'
-    );
-  });
-
-  it('sets active class when href matches location.href', async () => {
-    render(
-      <ActiveLink
-        className="link"
-        activeClassName="active"
-        href="/link"
-        pathname="/link"
-      >
-        Link
-      </ActiveLink>
-    );
-
-    assert.equal(
-      (await screen.findByText('Link')).getAttribute('class'),
-      'link active'
-    );
-  });
-});

package/Common/BaseActiveLink/index.tsx

@@ -1,34 +0,0 @@
-import classNames from 'classnames';
-import type { ComponentProps, FC } from 'react';
-
-import type { LinkLike } from '#ui/types';
-
-export type ActiveLocalizedLinkProps = ComponentProps<LinkLike> & {
-  activeClassName?: string;
-  allowSubPath?: boolean;
-  pathname?: string;
-  as?: LinkLike;
-};
-
-const BaseActiveLink: FC<ActiveLocalizedLinkProps> = ({
-  activeClassName = 'active',
-  allowSubPath = false,
-  className,
-  href = '',
-  pathname = '/',
-  as: Component = 'a',
-  ...props
-}) => {
-  const finalClassName = classNames(className, {
-    [activeClassName]: allowSubPath
-      ? // When using allowSubPath we want only to check if
-        // the current pathname starts with the utmost upper level
-        // of an href (e.g. /docs/...)
-        pathname.startsWith(`/${href.toString().split('/')[1]}`)
-      : href.toString() === pathname,
-  });
-
-  return <Component className={finalClassName} href={href} {...props} />;
-};
-
-export default BaseActiveLink;

package/Common/BaseButton/index.stories.tsx

@@ -1,67 +0,0 @@
-import { ArrowRightIcon } from '@heroicons/react/24/solid';
-import type { Meta as MetaObj, StoryObj } from '@storybook/react';
-
-import BaseButton from '#ui/Common/BaseButton';
-
-type Story = StoryObj<typeof BaseButton>;
-type Meta = MetaObj<typeof BaseButton>;
-
-export const Neutral: Story = {
-  args: {
-    kind: 'neutral',
-    children: 'Download Node (LTS)',
-    disabled: false,
-    size: 'default',
-  },
-};
-
-export const Primary: Story = {
-  args: {
-    kind: 'primary',
-    children: 'Download Node (LTS)',
-    disabled: false,
-    size: 'default',
-  },
-};
-
-export const Secondary: Story = {
-  args: {
-    kind: 'secondary',
-    children: 'Download Node (LTS)',
-    disabled: false,
-    size: 'default',
-  },
-};
-
-export const Special: Story = {
-  args: {
-    kind: 'special',
-    children: 'Download Node (LTS)',
-    disabled: false,
-    size: 'default',
-  },
-};
-
-export const WithIcon: Story = {
-  args: {
-    kind: 'primary',
-    children: (
-      <>
-        Back to Home
-        <ArrowRightIcon />
-      </>
-    ),
-    disabled: false,
-    size: 'default',
-  },
-};
-
-export default {
-  component: BaseButton,
-  argTypes: {
-    size: {
-      options: ['default', 'small'],
-      control: { type: 'radio' },
-    },
-  },
-} as Meta;

package/Common/BaseButton/index.tsx

@@ -1,59 +0,0 @@
-import classNames from 'classnames';
-import type { FC, AnchorHTMLAttributes, ButtonHTMLAttributes } from 'react';
-
-import type { LinkLike } from '#ui/types';
-
-import styles from './index.module.css';
-
-export type ButtonProps = (
-  | AnchorHTMLAttributes<HTMLAnchorElement>
-  | ButtonHTMLAttributes<HTMLButtonElement>
-) & {
-  kind?: 'neutral' | 'primary' | 'secondary' | 'special';
-  size?: 'default' | 'small';
-  disabled?: boolean;
-  as?: LinkLike;
-};
-
-const BaseButton: FC<ButtonProps> = ({
-  kind = 'primary',
-  size = 'default',
-  disabled = false,
-  className,
-  as: Component = 'a',
-  ...props
-}) => {
-  if ('href' in props && Component) {
-    return (
-      <Component
-        role="button"
-        href={disabled ? undefined : props.href}
-        aria-disabled={disabled}
-        className={classNames(
-          styles.button,
-          styles[kind],
-          styles[size],
-          className
-        )}
-        tabIndex={disabled ? -1 : 0}
-        {...props}
-      />
-    );
-  }
-
-  return (
-    <button
-      disabled={disabled}
-      className={classNames(
-        styles.button,
-        styles[kind],
-        styles[size],
-        className
-      )}
-      type="button"
-      {...(props as ButtonHTMLAttributes<HTMLButtonElement>)}
-    />
-  );
-};
-
-export default BaseButton;

package/Common/BaseCodeBox/index.stories.tsx

@@ -1,39 +0,0 @@
-import type { Meta as MetaObj, StoryObj } from '@storybook/react';
-
-import BaseCodeBox from '#ui/Common/BaseCodeBox';
-
-type Story = StoryObj<typeof BaseCodeBox>;
-type Meta = MetaObj<typeof BaseCodeBox>;
-
-const content = `const http = require('http');
-
-const hostname = '127.0.0.1';
-const port = 3000;
-
-const server = http.createServer((req, res) => {
-  res.statusCode = 200;
-  res.setHeader('Content-Type', 'text/plain');
-  res.end('Hello World');
-});
-
-server.listen(port, hostname, () => {
-  console.log(\`Server running at http://\${hostname}:\${port}/\`);
-});`;
-
-const args = {
-  language: 'JavaScript (CJS)',
-  children: <code>{content}</code>,
-};
-
-export const Default: Story = {
-  args,
-};
-
-export const WithCopyButton: Story = {
-  args: {
-    ...args,
-    showCopyButton: true,
-  },
-};
-
-export default { component: BaseCodeBox } as Meta;

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;