@node-core/ui-components 1.0.1-cc5c2626b0639fe2088a736f54169ea3e10ed325 → 1.0.1-e1f87bde264af01e260a8efa4fab1749a2c6bc29

package/Common/Breadcrumbs/BreadcrumbRoot/index.tsx

@@ -1,20 +0,0 @@
-import type { FC, PropsWithChildren, ComponentProps } from 'react';
-
-import styles from './index.module.css';
-
-const BreadcrumbRoot: FC<PropsWithChildren<ComponentProps<'nav'>>> = ({
-  children,
-  ...props
-}) => (
-  <nav aria-label="breadcrumb" {...props}>
-    <ol
-      itemScope
-      itemType="https://schema.org/BreadcrumbList"
-      className={styles.list}
-    >
-      {children}
-    </ol>
-  </nav>
-);
-
-export default BreadcrumbRoot;

package/Common/Breadcrumbs/BreadcrumbTruncatedItem/index.tsx

@@ -1,9 +0,0 @@
-import BreadcrumbItem from '#ui/Common/Breadcrumbs/BreadcrumbItem';
-
-const BreadcrumbTruncatedItem = () => (
-  <BreadcrumbItem disableMicrodata>
-    <button disabled>…</button>
-  </BreadcrumbItem>
-);
-
-export default BreadcrumbTruncatedItem;

package/Common/Breadcrumbs/index.stories.tsx

@@ -1,94 +0,0 @@
-import type { Meta as MetaObj, StoryObj } from '@storybook/react';
-
-import Breadcrumbs from '#ui/Common/Breadcrumbs';
-
-type Story = StoryObj<typeof Breadcrumbs>;
-type Meta = MetaObj<typeof Breadcrumbs>;
-
-export const Default: Story = {
-  args: {
-    links: [
-      {
-        label: 'Learn',
-        href: '/learn',
-      },
-      {
-        label: 'Getting Started',
-        href: '/learn/getting-started',
-      },
-      {
-        label: 'Introduction to Node.js',
-        href: '/learn/getting-started/intro',
-      },
-    ],
-  },
-};
-
-export const Linkless: Story = {
-  args: {
-    links: [
-      {
-        label: 'Learn',
-        href: '',
-      },
-      {
-        label: 'Getting Started',
-        href: '',
-      },
-      {
-        label: 'Introduction to Node.js',
-        href: '',
-      },
-    ],
-  },
-};
-
-export const Truncate: Story = {
-  args: {
-    links: [
-      {
-        label: 'Learn',
-        href: '/learn',
-      },
-      {
-        label: 'Getting Started',
-        href: '/learn/getting-started',
-      },
-      {
-        label: 'Introduction to Node.js',
-        href: '/learn/getting-started/intro',
-      },
-      {
-        label: 'Installation',
-        href: '/learn/getting-started/intro/installation',
-      },
-      {
-        label: 'Documentation',
-        href: '/learn/getting-started/intro/installation/documentation',
-      },
-    ],
-    maxLength: 1,
-  },
-};
-
-export const HiddenHome: Story = {
-  args: {
-    hideHome: true,
-    links: [
-      {
-        label: 'Learn',
-        href: '/learn',
-      },
-      {
-        label: 'Getting Started',
-        href: '/learn/getting-started',
-      },
-      {
-        label: 'Introduction to Node.js',
-        href: '/learn/getting-started/intro',
-      },
-    ],
-  },
-};
-
-export default { component: Breadcrumbs } as Meta;

package/Common/Breadcrumbs/index.tsx

@@ -1,81 +0,0 @@
-import type { FC } from 'react';
-import { useMemo } from 'react';
-
-import BreadcrumbHomeLink from '#ui/Common/Breadcrumbs/BreadcrumbHomeLink';
-import BreadcrumbItem from '#ui/Common/Breadcrumbs/BreadcrumbItem';
-import BreadcrumbLink from '#ui/Common/Breadcrumbs/BreadcrumbLink';
-import BreadcrumbRoot from '#ui/Common/Breadcrumbs/BreadcrumbRoot';
-import BreadcrumbTruncatedItem from '#ui/Common/Breadcrumbs/BreadcrumbTruncatedItem';
-import type { FormattedMessage, LinkLike } from '#ui/types';
-
-export type BreadcrumbLink = {
-  label: FormattedMessage;
-  href: string | undefined;
-};
-
-type BreadcrumbsProps = {
-  links: Array<BreadcrumbLink>;
-  maxLength?: number;
-  hideHome?: boolean;
-  as: LinkLike;
-  homeLinkAriaLabel?: string;
-};
-
-const Breadcrumbs: FC<BreadcrumbsProps> = ({
-  links = [],
-  maxLength = 5,
-  hideHome = false,
-  as = 'a',
-  homeLinkAriaLabel,
-}) => {
-  const totalLength = links.length + +!hideHome;
-  const lengthOffset = maxLength - totalLength;
-  const isOverflow = lengthOffset < 0;
-
-  const items = useMemo(
-    () =>
-      links.map((link, index, items) => {
-        const position = index + 1;
-        const isLastItem = index === items.length - 1;
-        const hidden =
-          // We add 1 here to take into account of the truncated breadcrumb.
-          position <= Math.abs(lengthOffset) + 1 && isOverflow && !isLastItem;
-
-        return (
-          <BreadcrumbItem
-            key={link.label.toString()}
-            hidden={hidden}
-            hideSeparator={isLastItem}
-            position={position + +!hideHome}
-          >
-            {link.href || isLastItem ? (
-              <BreadcrumbLink
-                as={as}
-                href={link.href || undefined}
-                active={isLastItem}
-              >
-                {link.label}
-              </BreadcrumbLink>
-            ) : (
-              <span className="opacity-70">{link.label}</span>
-            )}
-          </BreadcrumbItem>
-        );
-      }),
-    [hideHome, isOverflow, lengthOffset, links]
-  );
-
-  return (
-    <BreadcrumbRoot>
-      {!hideHome && (
-        <BreadcrumbItem position={1}>
-          <BreadcrumbHomeLink as={as} aria-label={homeLinkAriaLabel} />
-        </BreadcrumbItem>
-      )}
-      {isOverflow && <BreadcrumbTruncatedItem />}
-      {items}
-    </BreadcrumbRoot>
-  );
-};
-
-export default Breadcrumbs;

package/Common/ChangeHistory/index.stories.tsx

@@ -1,130 +0,0 @@
-import type { Meta as MetaObj, StoryObj } from '@storybook/react';
-
-import ChangeHistory from '#ui/Common/ChangeHistory';
-
-type Story = StoryObj<typeof ChangeHistory>;
-type Meta = MetaObj<typeof ChangeHistory>;
-
-const SAMPLE_CHANGES = [
-  {
-    versions: ['v15.4.0'],
-    label: 'No longer experimental',
-    url: 'https://github.com/nodejs/node/pull/12345',
-  },
-  {
-    versions: ['v15.0.0', 'v14.17.0'],
-    label: 'Added in v15.0.0, v14.17.0',
-    url: 'https://github.com/nodejs/node/pull/67890',
-  },
-  {
-    versions: ['v16.0.0'],
-    label: 'Deprecated in 16',
-  },
-];
-
-const LARGE_SAMPLE_CHANGES = [
-  {
-    versions: ['v20.0.0'],
-    label: 'Breaking change in v20',
-    url: 'https://github.com/nodejs/node/pull/50001',
-  },
-  {
-    versions: ['v19.8.0'],
-    label: 'Performance improvement',
-    url: 'https://github.com/nodejs/node/pull/49999',
-  },
-  {
-    versions: ['v19.0.0'],
-    label: 'API redesign',
-    url: 'https://github.com/nodejs/node/pull/49000',
-  },
-  {
-    versions: ['v18.17.0', 'v18.16.1'],
-    label: 'Security fix backported',
-    url: 'https://github.com/nodejs/node/pull/48500',
-  },
-  {
-    versions: ['v18.0.0'],
-    label: 'Major version release',
-    url: 'https://github.com/nodejs/node/pull/47000',
-  },
-  {
-    versions: ['v17.9.0'],
-    label: 'Experimental feature added',
-    url: 'https://github.com/nodejs/node/pull/46500',
-  },
-  {
-    versions: ['v17.0.0'],
-    label: 'Node.js 17 release',
-    url: 'https://github.com/nodejs/node/pull/45000',
-  },
-  {
-    versions: ['v16.15.0', 'v16.14.2'],
-    label: 'Bug fix release',
-    url: 'https://github.com/nodejs/node/pull/44000',
-  },
-  {
-    versions: ['v16.0.0'],
-    label: 'Deprecated in v16',
-    url: 'https://github.com/nodejs/node/pull/43000',
-  },
-  {
-    versions: ['v15.14.0'],
-    label: 'Feature enhancement',
-    url: 'https://github.com/nodejs/node/pull/42000',
-  },
-  {
-    versions: ['v15.0.0', 'v14.17.0'],
-    label: 'Initial implementation',
-    url: 'https://github.com/nodejs/node/pull/41000',
-  },
-  {
-    versions: ['v14.18.0'],
-    label: 'Documentation update',
-    url: 'https://github.com/nodejs/node/pull/40000',
-  },
-  {
-    versions: ['v14.0.0'],
-    label: 'Added to stable API',
-    url: 'https://github.com/nodejs/node/pull/39000',
-  },
-  {
-    versions: ['v13.14.0'],
-    label: 'Experimental flag removed',
-    url: 'https://github.com/nodejs/node/pull/38000',
-  },
-  {
-    versions: ['v12.22.0', 'v12.21.0'],
-    label: 'Backported to LTS',
-    url: 'https://github.com/nodejs/node/pull/37000',
-  },
-  {
-    versions: ['v12.0.0'],
-    label: 'First experimental version',
-    url: 'https://github.com/nodejs/node/pull/36000',
-  },
-];
-
-export const Default: Story = {
-  render: args => (
-    <div className="right-0 flex justify-end">
-      <ChangeHistory {...args} />
-    </div>
-  ),
-  args: {
-    changes: SAMPLE_CHANGES,
-  },
-};
-
-export const LargeHistory: Story = {
-  render: args => (
-    <div className="right-0 flex justify-end">
-      <ChangeHistory {...args} />
-    </div>
-  ),
-  args: {
-    changes: LARGE_SAMPLE_CHANGES,
-  },
-};
-
-export default { component: ChangeHistory } as Meta;

package/Common/ChangeHistory/index.tsx

@@ -1,67 +0,0 @@
-import { ChevronDownIcon, ClockIcon } from '@heroicons/react/24/outline';
-import classNames from 'classnames';
-import type { FC, ComponentProps } from 'react';
-
-import type { LinkLike } from '#ui/types.js';
-
-import styles from './index.module.css';
-
-export type HistoryChange = {
-  versions: Array<string>;
-  label: string;
-  url?: string;
-};
-
-type ChangeHistoryProps = ComponentProps<'div'> & {
-  label: string;
-  changes: Array<HistoryChange>;
-  as?: LinkLike;
-};
-
-const ChangeHistory: FC<ChangeHistoryProps> = ({
-  label = 'History',
-  changes = [],
-  className,
-  as: As = 'a',
-  'aria-label': ariaLabel = label,
-  ...props
-}) => (
-  <div className={classNames('relative', 'inline-block', className)} {...props}>
-    <details className="group">
-      <summary className={styles.summary} role="button" aria-haspopup="menu">
-        <ClockIcon className="size-4" />
-        <span>{label}</span>
-        <ChevronDownIcon className="size-3 group-open:rotate-180 motion-safe:transition-transform" />
-      </summary>
-      <div
-        className={styles.dropdownContentWrapper}
-        role="menu"
-        aria-label={ariaLabel}
-      >
-        <div className={styles.dropdownContentInner}>
-          {changes.map((change, index) => {
-            const MenuItem = change.url ? As : 'div';
-
-            return (
-              <MenuItem
-                key={index}
-                className={styles.dropdownItem}
-                role="menuitem"
-                tabIndex={0}
-                aria-label={`${change.label}: ${change.versions.join(', ')}`}
-                href={change.url}
-              >
-                <div className={styles.dropdownLabel}>{change.label}</div>
-                <div className={styles.dropdownVersions}>
-                  {change.versions.join(', ')}
-                </div>
-              </MenuItem>
-            );
-          })}
-        </div>
-      </div>
-    </details>
-  </div>
-);
-
-export default ChangeHistory;

package/Common/CodeTabs/index.stories.tsx

@@ -1,73 +0,0 @@
-import * as TabsPrimitive from '@radix-ui/react-tabs';
-import type { Meta as MetaObj, StoryObj } from '@storybook/react';
-import type { FC } from 'react';
-
-import BaseCodeBox from '#ui/Common/BaseCodeBox';
-import CodeTabs from '#ui/Common/CodeTabs';
-
-type Story = StoryObj<typeof CodeTabs>;
-type Meta = MetaObj<typeof CodeTabs>;
-
-const mjsContent = `import * as http from '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 cjsContent = `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 boxProps = {
-  onCopy: console.log,
-  buttonText: '[Button Text]',
-};
-
-const TabsContent: FC = () => (
-  <>
-    <TabsPrimitive.Content key="mjs" value="mjs">
-      <BaseCodeBox language="JavaScript (MJS)" {...boxProps}>
-        <code>{mjsContent}</code>
-      </BaseCodeBox>
-    </TabsPrimitive.Content>
-    <TabsPrimitive.Content key="cjs" value="cjs">
-      <BaseCodeBox language="JavaScript (CJS)" {...boxProps}>
-        <code>{cjsContent}</code>
-      </BaseCodeBox>
-    </TabsPrimitive.Content>
-  </>
-);
-
-export const Default: Story = {};
-
-export default {
-  component: CodeTabs,
-  args: {
-    children: <TabsContent />,
-    defaultValue: 'mjs',
-    tabs: [
-      { key: 'mjs', label: 'MJS' },
-      { key: 'cjs', label: 'CJS' },
-    ],
-  },
-} as Meta;

package/Common/CodeTabs/index.tsx

@@ -1,16 +0,0 @@
-import type { ComponentProps, FC } from 'react';
-
-import Tabs from '#ui/Common/Tabs';
-
-import styles from './index.module.css';
-
-type CodeTabsProps = Pick<
-  ComponentProps<typeof Tabs>,
-  'tabs' | 'defaultValue' | 'children' | 'addons'
->;
-
-const CodeTabs: FC<CodeTabsProps> = ({ ...props }) => (
-  <Tabs {...props} className={styles.root} triggerClassName={styles.trigger} />
-);
-
-export default CodeTabs;

package/Common/DataTag/index.stories.tsx

@@ -1,40 +0,0 @@
-import type { Meta as MetaObj, StoryObj } from '@storybook/react';
-
-import DataTag, { type DataTagProps } from '#ui/Common/DataTag';
-
-type Story = StoryObj<typeof DataTag>;
-type Meta = MetaObj<typeof DataTag>;
-
-export const DataTags: Story = {
-  render: () => (
-    <div className="grid grid-cols-3 gap-6 p-6">
-      {[
-        'event',
-        'method',
-        'property',
-        'class',
-        'module',
-        'classMethod',
-        'ctor',
-        'global',
-      ]
-        .map(kind =>
-          ['sm', 'md', 'lg'].map(size => (
-            <div
-              key={`${kind}-${size}`}
-              className="flex justify-center"
-              title={kind}
-            >
-              <DataTag
-                kind={kind as DataTagProps['kind']}
-                size={size as DataTagProps['size']}
-              />
-            </div>
-          ))
-        )
-        .flat()}
-    </div>
-  ),
-};
-
-export default { component: DataTag } as Meta;

package/Common/DataTag/index.tsx

@@ -1,39 +0,0 @@
-import classNames from 'classnames';
-import type { FC } from 'react';
-
-import styles from './index.module.css';
-
-export type DataTagProps = {
-  kind:
-    | 'event'
-    | 'method'
-    | 'property'
-    | 'class'
-    | 'module'
-    | 'classMethod'
-    | 'global'
-    | 'ctor';
-  size?: 'lg' | 'md' | 'sm';
-};
-
-// These symbols match up with the types used in
-// node core, and the ones defined at
-// https://github.com/nodejs/api-docs-tooling/blob/main/src/types.d.ts#L22 (`HeadingMetadataEntry['type']`)
-const symbolMap = {
-  event: 'E',
-  method: 'M',
-  property: 'P',
-  class: 'C',
-  module: 'M',
-  classMethod: 'S',
-  global: 'G',
-  ctor: 'C',
-} as const;
-
-const DataTag: FC<DataTagProps> = ({ kind, size = 'md' }) => (
-  <div className={classNames(styles.dataTag, styles[size], styles[kind])}>
-    <span>{symbolMap[kind]}</span>
-  </div>
-);
-
-export default DataTag;

package/Common/GlowingBackdrop/index.stories.tsx

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

package/Common/GlowingBackdrop/index.tsx

@@ -1,13 +0,0 @@
-import type { FC } from 'react';
-
-import HexagonGrid from '#ui/Icons/HexagonGrid';
-
-import styles from './index.module.css';
-
-const GlowingBackdrop: FC = () => (
-  <div className={styles.glowingBackdrop}>
-    <HexagonGrid />
-  </div>
-);
-
-export default GlowingBackdrop;

package/Common/LanguageDropDown/index.stories.tsx

@@ -1,19 +0,0 @@
-import type { Meta as MetaObj, StoryObj } from '@storybook/react';
-
-import LanguageDropDown from '#ui/Common/LanguageDropDown';
-
-type Story = StoryObj<typeof LanguageDropDown>;
-type Meta = MetaObj<typeof LanguageDropDown>;
-
-export const Default: Story = {
-  args: {
-    availableLanguages: [
-      { name: 'English', code: 'en', localName: 'English' },
-      { name: 'French', code: 'fr', localName: 'Français' },
-      { name: 'Spanish', code: 'es', localName: 'Español' },
-    ],
-    currentLanguage: 'en',
-  },
-};
-
-export default { component: LanguageDropDown } as Meta;

package/Common/LanguageDropDown/index.tsx

@@ -1,56 +0,0 @@
-import { LanguageIcon } from '@heroicons/react/24/outline';
-import * as DropdownMenu from '@radix-ui/react-dropdown-menu';
-import classNames from 'classnames';
-import type { FC } from 'react';
-
-import type { SimpleLocaleConfig } from '#ui/types';
-
-import styles from './index.module.css';
-
-type LanguageDropDownProps = {
-  onChange?: (newLocale: SimpleLocaleConfig) => void;
-  currentLanguage: string;
-  availableLanguages: Array<SimpleLocaleConfig>;
-  ariaLabel: string;
-};
-
-const LanguageDropdown: FC<LanguageDropDownProps> = ({
-  onChange = () => {},
-  currentLanguage,
-  availableLanguages,
-  ariaLabel,
-}) => {
-  return (
-    <DropdownMenu.Root>
-      <DropdownMenu.Trigger asChild>
-        <button className={styles.languageDropdown} aria-label={ariaLabel}>
-          <LanguageIcon height="20" />
-        </button>
-      </DropdownMenu.Trigger>
-
-      <DropdownMenu.Portal>
-        <DropdownMenu.Content
-          align="start"
-          className={styles.dropDownContent}
-          sideOffset={5}
-        >
-          <div>
-            {availableLanguages.map(({ name, code, localName }) => (
-              <DropdownMenu.Item
-                key={code}
-                onClick={() => onChange({ name, code, localName })}
-                className={classNames(styles.dropDownItem, {
-                  [styles.currentDropDown]: code === currentLanguage,
-                })}
-              >
-                {localName}
-              </DropdownMenu.Item>
-            ))}
-          </div>
-        </DropdownMenu.Content>
-      </DropdownMenu.Portal>
-    </DropdownMenu.Root>
-  );
-};
-
-export default LanguageDropdown;