@node-core/ui-components 0.0.1 → 1.0.1-df203d0fe21ee5d80d258c60dc821e8ac0601ce4

package/Common/Separator/index.tsx

@@ -0,0 +1,27 @@
+'use client';
+
+import * as SeparatorPrimitive from '@radix-ui/react-separator';
+import classNames from 'classnames';
+import type { FC, ComponentProps } from 'react';
+
+import styles from './index.module.css';
+
+const Separator: FC<ComponentProps<typeof SeparatorPrimitive.Root>> = ({
+  className,
+  orientation = 'horizontal',
+  decorative = true,
+  ...props
+}) => (
+  <SeparatorPrimitive.Root
+    decorative={decorative}
+    orientation={orientation}
+    className={classNames(
+      styles.root,
+      orientation === 'horizontal' ? styles.horizontal : styles.vertical,
+      className
+    )}
+    {...props}
+  />
+);
+
+export default Separator;

package/Common/Skeleton/index.module.css

@@ -0,0 +1,30 @@
+@reference "../../styles/index.css";
+
+.skeleton {
+  @apply outline-hidden
+    dark:animate-pulse-dark
+    pointer-events-none
+    animate-pulse
+    cursor-default
+    select-none
+    rounded-md
+    border-none
+    bg-clip-border
+    text-transparent
+    shadow-none;
+}
+
+.skeleton[data-inline-skeleton] {
+  @apply leading-none;
+}
+
+.skeleton:empty {
+  @apply block
+    h-3;
+}
+
+.skeleton > *,
+.skeleton::after,
+.skeleton::before {
+  @apply invisible;
+}

package/Common/Skeleton/index.tsx

@@ -0,0 +1,39 @@
+import classNames from 'classnames';
+import type { FC, PropsWithChildren } from 'react';
+import { isValidElement } from 'react';
+
+import styles from './index.module.css';
+
+type SkeletonProps = { hide?: boolean; loading?: boolean; className?: string };
+
+const Skeleton: FC<PropsWithChildren<SkeletonProps>> = ({
+  children,
+  className,
+  hide = false,
+  loading = true,
+}) => {
+  // This can be used to completely hide the children after the Skeleton has loaded
+  // If certain criterias do not match. This is useful for conditional rendering without
+  // changing the actual tree that the Skeleton is wrapping
+  if (!loading && hide) {
+    return null;
+  }
+
+  // If we finished loading, we can hide the Skeleton and render the children tree
+  if (!loading) {
+    return children;
+  }
+
+  return (
+    <span
+      tabIndex={-1}
+      aria-hidden="true"
+      className={classNames(styles.skeleton, className)}
+      data-inline-skeleton={isValidElement(children) ? undefined : true}
+    >
+      {children}
+    </span>
+  );
+};
+
+export default Skeleton;

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

@@ -0,0 +1,52 @@
+import { describe, it } from 'node:test';
+import assert from 'node:assert/strict';
+
+import * as TabsPrimitive from '@radix-ui/react-tabs';
+import { render, screen } from '@testing-library/react';
+import userEvent from '@testing-library/user-event';
+
+import Tabs from '../index';
+
+const Sut = ({ addons }) => {
+  const tabs = [
+    { key: 'package', label: 'Package Manager' },
+    { key: 'prebuilt', label: 'Prebuilt Installer' },
+    { key: 'source', label: 'Source Code' },
+  ];
+
+  return (
+    <Tabs tabs={tabs} defaultValue="package" addons={addons}>
+      <TabsPrimitive.Content value="package">
+        Package Manager
+      </TabsPrimitive.Content>
+      <TabsPrimitive.Content value="prebuilt">
+        Prebuilt Installer
+      </TabsPrimitive.Content>
+      <TabsPrimitive.Content value="source">Source Code</TabsPrimitive.Content>
+    </Tabs>
+  );
+};
+
+describe('Tabs', () => {
+  it('should render the correct number of tabs', async () => {
+    render(<Sut />);
+
+    assert.strictEqual(screen.getAllByRole('tab').length, 3);
+  });
+
+  it('should render the correct tab content when clicked', async () => {
+    render(<Sut />);
+
+    assert.equal(screen.getByRole('tabpanel').textContent, 'Package Manager');
+
+    await userEvent.click(screen.getByRole('tab', { name: 'Source Code' }));
+
+    assert.equal(screen.getByRole('tabpanel').textContent, 'Source Code');
+  });
+
+  it('should render the given addons', async () => {
+    render(<Sut addons={<a href="/">addon</a>} />);
+
+    assert.ok(screen.getByRole('link', { name: 'addon' }).ownerDocument);
+  });
+});

package/Common/Tabs/index.module.css

@@ -0,0 +1,54 @@
+@reference "../../styles/index.css";
+
+.tabsRoot {
+  @apply grid
+    max-w-full;
+
+  .tabsList {
+    @apply font-open-sans
+      scrollbar-thin
+      flex
+      gap-2
+      overflow-x-auto;
+
+    .tabsTrigger {
+      @apply whitespace-nowrap
+        border-b-2
+        border-b-transparent
+        px-1
+        pb-[11px]
+        text-sm
+        font-semibold
+        text-neutral-800
+        dark:text-neutral-200;
+
+      .tabSecondaryLabel {
+        @apply pl-1
+          text-neutral-500
+          dark:text-neutral-800;
+      }
+
+      &[data-state='active'] {
+        @apply border-b-green-600
+          text-green-600
+          dark:border-b-green-400
+          dark:text-green-400;
+
+        .tabSecondaryLabel {
+          @apply text-green-800
+            dark:text-green-600;
+        }
+      }
+    }
+
+    .addons {
+      @apply ml-auto
+        border-b-2
+        border-b-transparent
+        px-1
+        pb-[11px]
+        text-sm
+        font-semibold;
+    }
+  }
+}

package/Common/Tabs/index.stories.tsx

@@ -0,0 +1,50 @@
+import * as TabsPrimitive from '@radix-ui/react-tabs';
+import type { Meta as MetaObj, StoryObj } from '@storybook/react';
+import type { ComponentProps } from 'react';
+
+import Tabs from '#ui/Common/Tabs';
+
+type Story = StoryObj<typeof Tabs>;
+type Meta = MetaObj<typeof Tabs>;
+
+const defaultArgs: ComponentProps<typeof Tabs> = {
+  defaultValue: 'prebuilt',
+  tabs: [
+    {
+      key: 'package',
+      label: 'Package Manager',
+    },
+    {
+      key: 'prebuilt',
+      label: 'Prebuilt Installer',
+    },
+    {
+      key: 'source',
+      label: 'Source Code',
+    },
+  ],
+  children: (
+    <>
+      <TabsPrimitive.Content value="package">
+        Package Manager
+      </TabsPrimitive.Content>
+      <TabsPrimitive.Content value="prebuilt">
+        Prebuilt Installer
+      </TabsPrimitive.Content>
+      <TabsPrimitive.Content value="source">Source Code</TabsPrimitive.Content>
+    </>
+  ),
+};
+
+export const Default: Story = {
+  args: defaultArgs,
+};
+
+export const WithAddon: Story = {
+  args: {
+    ...defaultArgs,
+    addons: 'addon',
+  },
+};
+
+export default { component: Tabs } as Meta;

package/Common/Tabs/index.tsx

@@ -0,0 +1,54 @@
+import * as TabsPrimitive from '@radix-ui/react-tabs';
+import classNames from 'classnames';
+import type { FC, PropsWithChildren, ReactNode } from 'react';
+
+import styles from './index.module.css';
+
+type Tab = {
+  key: string;
+  label: string;
+  secondaryLabel?: string;
+  value?: string;
+};
+
+type TabsProps = TabsPrimitive.TabsProps & {
+  tabs: Array<Tab>;
+  addons?: ReactNode;
+  triggerClassName?: string;
+};
+
+const Tabs: FC<PropsWithChildren<TabsProps>> = ({
+  tabs,
+  addons,
+  triggerClassName,
+  children,
+  ...props
+}) => (
+  <TabsPrimitive.Root
+    {...props}
+    className={classNames(styles.tabsRoot, props.className)}
+  >
+    <TabsPrimitive.List className={styles.tabsList}>
+      {tabs.map(tab => (
+        <TabsPrimitive.Trigger
+          key={tab.key}
+          value={tab.value ?? tab.key}
+          className={classNames(styles.tabsTrigger, triggerClassName)}
+        >
+          {tab.label}
+          {tab.secondaryLabel ? (
+            <span className={styles.tabSecondaryLabel}>
+              {tab.secondaryLabel}
+            </span>
+          ) : null}
+        </TabsPrimitive.Trigger>
+      ))}
+
+      {addons && <div className={styles.addons}>{addons}</div>}
+    </TabsPrimitive.List>
+
+    {children}
+  </TabsPrimitive.Root>
+);
+
+export default Tabs;

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

@@ -0,0 +1,35 @@
+import { describe, it, beforeEach } from 'node:test';
+import assert from 'node:assert/strict';
+
+import { render, screen } from '@testing-library/react';
+import userEvent from '@testing-library/user-event';
+
+import ThemeToggle from '../';
+
+let mockCurrentTheme = 'light';
+
+const toggleTheme = () => {
+  mockCurrentTheme = mockCurrentTheme === 'light' ? 'dark' : 'light';
+};
+
+describe('ThemeToggle', () => {
+  let toggle;
+
+  beforeEach(() => {
+    mockCurrentTheme = 'light';
+
+    render(<ThemeToggle onClick={toggleTheme} />);
+    toggle = screen.getByRole('button');
+  });
+
+  it('switches dark theme to light theme', async () => {
+    mockCurrentTheme = 'dark';
+    await userEvent.click(toggle);
+    assert.equal(mockCurrentTheme, 'light');
+  });
+
+  it('switches light theme to dark theme', async () => {
+    await userEvent.click(toggle);
+    assert.equal(mockCurrentTheme, 'dark');
+  });
+});

package/Common/ThemeToggle/index.module.css

@@ -0,0 +1,15 @@
+@reference "../../styles/index.css";
+
+.themeToggle {
+  @apply size-9
+    rounded-md
+    p-2
+    text-neutral-700
+    motion-safe:transition-colors
+    dark:text-neutral-300;
+
+  &:hover {
+    @apply bg-neutral-100
+      dark:bg-neutral-900;
+  }
+}

package/Common/ThemeToggle/index.stories.tsx

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

package/Common/ThemeToggle/index.tsx

@@ -0,0 +1,15 @@
+import { MoonIcon, SunIcon } from '@heroicons/react/24/outline';
+import type { FC, ButtonHTMLAttributes } from 'react';
+
+import styles from './index.module.css';
+
+const ThemeToggle: FC<ButtonHTMLAttributes<HTMLButtonElement>> = props => {
+  return (
+    <button type="button" className={styles.themeToggle} {...props}>
+      <MoonIcon className="block dark:hidden" height="20" />
+      <SunIcon className="hidden dark:block" height="20" />
+    </button>
+  );
+};
+
+export default ThemeToggle;

package/Common/Tooltip/index.module.css

@@ -0,0 +1,43 @@
+@reference "../../styles/index.css";
+
+.content {
+  @apply rounded-md
+    border
+    bg-white
+    text-sm
+    font-medium
+    text-neutral-900
+    shadow-lg
+    dark:bg-neutral-950
+    dark:text-white;
+
+  &.default {
+    @apply border-neutral-200
+      dark:border-neutral-900;
+
+    .arrow {
+      @apply fill-neutral-200
+        dark:fill-neutral-900;
+    }
+  }
+
+  &.error {
+    @apply border-danger-400
+      dark:border-danger-900;
+
+    .arrow {
+      @apply fill-danger-400
+        dark:fill-danger-900;
+    }
+  }
+
+  &.warning {
+    @apply border-warning-400
+      dark:border-warning-900;
+
+    .arrow {
+      @apply fill-warning-400
+        dark:fill-warning-900;
+    }
+  }
+}

package/Common/Tooltip/index.stories.tsx

@@ -0,0 +1,73 @@
+import type { Meta as MetaObj, StoryObj } from '@storybook/react';
+
+import Tooltip from '#ui/Common/Tooltip';
+
+type Story = StoryObj<typeof Tooltip>;
+type Meta = MetaObj<typeof Tooltip>;
+
+const defaultProps = {
+  children: <a>Rocket Turtle</a>,
+  content: <div className="p-3">🚀 🐢</div>,
+};
+
+export const Default: Story = {
+  args: defaultProps,
+};
+
+export const Warning: Story = {
+  args: {
+    ...defaultProps,
+    kind: 'warning',
+  },
+};
+
+export const Error: Story = {
+  args: {
+    ...defaultProps,
+    kind: 'error',
+  },
+};
+
+export const LeftSide: Story = {
+  args: {
+    ...defaultProps,
+    side: 'left',
+  },
+  decorators: [
+    Story => (
+      <div className="flex w-72 justify-end">
+        <Story />
+      </div>
+    ),
+  ],
+};
+
+export const RightSide: Story = {
+  args: {
+    ...defaultProps,
+    side: 'left',
+  },
+  decorators: [
+    Story => (
+      <div className="flex w-72 justify-start">
+        <Story />
+      </div>
+    ),
+  ],
+};
+
+export const TopSide: Story = {
+  args: {
+    ...defaultProps,
+    side: 'top',
+  },
+  decorators: [
+    Story => (
+      <div className="flex h-72 items-end">
+        <Story />
+      </div>
+    ),
+  ],
+};
+
+export default { component: Tooltip } as Meta;

package/Common/Tooltip/index.tsx

@@ -0,0 +1,48 @@
+import * as TooltipPrimitive from '@radix-ui/react-tooltip';
+import classNames from 'classnames';
+import type { FC, PropsWithChildren, ReactNode } from 'react';
+
+import styles from './index.module.css';
+
+type TooltipProps = {
+  asChild?: boolean;
+  content: ReactNode;
+  kind?: 'default' | 'warning' | 'error';
+  side?: TooltipPrimitive.TooltipContentProps['side'];
+  container?: HTMLElement | null;
+};
+
+const Tooltip: FC<PropsWithChildren<TooltipProps>> = ({
+  kind = 'default',
+  children,
+  content,
+  asChild = false,
+  side = 'bottom',
+  container,
+}) => (
+  <TooltipPrimitive.Provider delayDuration={200}>
+    <TooltipPrimitive.Root>
+      <TooltipPrimitive.Trigger asChild={asChild}>
+        {children}
+      </TooltipPrimitive.Trigger>
+      <TooltipPrimitive.Portal container={container}>
+        <TooltipPrimitive.Content
+          side={side}
+          sideOffset={4}
+          className={classNames(styles[kind], styles.content, {
+            'mx-1.5': side === 'top' || side === 'bottom',
+          })}
+        >
+          {content}
+          <TooltipPrimitive.Arrow
+            className={styles.arrow}
+            width={14}
+            height={6}
+          />
+        </TooltipPrimitive.Content>
+      </TooltipPrimitive.Portal>
+    </TooltipPrimitive.Root>
+  </TooltipPrimitive.Provider>
+);
+
+export default Tooltip;

package/Containers/Article/index.module.css

@@ -0,0 +1,70 @@
+@reference "../../styles/index.css";
+
+.articleLayout {
+  @apply max-w-8xl
+    mx-auto
+    block
+    w-full
+    sm:grid
+    sm:grid-cols-[theme(spacing.52)_1fr]
+    sm:grid-rows-[1fr]
+    sm:overflow-visible
+    sm:[grid-template-areas:'sidebar_main''sidebar_footer']
+    md:grid-cols-[theme(spacing.64)_1fr]
+    lg:grid-cols-[theme(spacing.52)_1fr_theme(spacing.52)]
+    lg:[grid-template-areas:'sidebar_main_metabar''sidebar_footer_metabar']
+    xl:grid-cols-[theme(spacing.80)_1fr_theme(spacing.80)];
+
+  > *:nth-child(1) {
+    @apply [grid-area:sidebar]
+      lg:sticky
+      lg:top-0
+      lg:h-[100vh]
+      lg:overflow-y-auto;
+  }
+
+  > *:nth-child(2) {
+    @apply contents
+      sm:max-lg:block;
+
+    > *:first-child {
+      @apply sm:bg-gradient-subtle
+        sm:dark:bg-gradient-subtle-dark
+        xl:px-18
+        p-4
+        [grid-area:main]
+        motion-safe:scroll-smooth
+        sm:bg-fixed
+        sm:p-12;
+    }
+
+    > *:last-child {
+      @apply mt-8
+        border-t
+        [grid-area:metabar]
+        sm:mt-0
+        lg:sticky
+        lg:top-0
+        lg:max-w-xs
+        lg:border-l
+        lg:border-t-0;
+    }
+  }
+
+  > *:nth-child(3) {
+    @apply sticky
+      bottom-0
+      flex
+      w-full
+      flex-col
+      items-center
+      self-stretch
+      border-t
+      border-t-neutral-200
+      bg-white
+      py-4
+      [grid-area:footer]
+      dark:border-t-neutral-900
+      dark:bg-neutral-950;
+  }
+}

package/Containers/Article/index.stories.tsx

@@ -0,0 +1,39 @@
+import type { Meta as MetaObj, StoryObj } from '@storybook/react';
+
+import Article from '.';
+
+type Story = StoryObj<typeof Article>;
+type Meta = MetaObj<typeof Article>;
+
+const Sidebar = () => (
+  <div className="text-center">
+    <h3>Sidebar</h3>
+    <ul>
+      <li>Navigation Item 1</li>
+      <li>Navigation Item 2</li>
+      <li>Navigation Item 3</li>
+      <li>Navigation Item 4</li>
+    </ul>
+  </div>
+);
+
+export const Default: Story = {
+  args: {
+    children: (
+      <>
+        <Sidebar />
+        <div>
+          <main>
+            <p>
+              Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do
+              eiusmod tempor incididunt ut labore et dolore magna aliqua.
+            </p>
+          </main>
+          <Sidebar />
+        </div>
+      </>
+    ),
+  },
+};
+
+export default { component: Article } as Meta;

package/Containers/Article/index.tsx

@@ -0,0 +1,9 @@
+import type { FC, PropsWithChildren } from 'react';
+
+import styles from './index.module.css';
+
+const ArticleLayout: FC<PropsWithChildren> = ({ children }) => (
+  <div className={styles.articleLayout}>{children}</div>
+);
+
+export default ArticleLayout;