@dxos/react-ui 0.1.0

package/src/components/Heading/Heading.tsx

@@ -0,0 +1,28 @@
+//
+// Copyright 2022 DXOS.org
+//
+
+import cx from 'classnames';
+import React, { createElement, PropsWithChildren, ReactNode } from 'react';
+
+export interface HeadingProps extends React.ComponentProps<'h1'> {
+  level?: 1 | 2 | 3 | 4 | 5 | 6;
+  children?: ReactNode;
+}
+
+const levelClassNameMap = new Map<number, string>([
+  [1, 'text-5xl'],
+  [2, 'text-4xl'],
+  [3, 'text-3xl'],
+  [4, 'text-2xl'],
+  [5, 'text-xl'],
+  [6, 'text-lg']
+]);
+
+export const Heading = ({ level, ...props }: PropsWithChildren<HeadingProps>) => {
+  const resolvedLevel = level || 1;
+  return createElement(`h${resolvedLevel}`, {
+    ...props,
+    className: cx('font-bold font-display', levelClassNameMap.get(resolvedLevel), props.className)
+  });
+};

package/src/components/Heading/index.ts

@@ -0,0 +1,5 @@
+//
+// Copyright 2022 DXOS.org
+//
+
+export * from './Heading';

package/src/components/Input/Input.stories.tsx

@@ -0,0 +1,91 @@
+//
+// Copyright 2022 DXOS.org
+//
+
+import '@dxosTheme';
+import React from 'react';
+
+import { templateForComponent } from '../../testing';
+import { Input, InputProps } from './Input';
+
+export default {
+  title: 'react-ui/Input',
+  component: Input,
+  argTypes: {
+    description: { control: 'text' },
+    validationValence: {
+      control: 'select',
+      options: ['success', 'info', 'warning', 'error']
+    }
+  }
+};
+
+const Template = (props: InputProps) => {
+  return <Input {...props} />;
+};
+
+export const Default = templateForComponent(Template)({ label: '' });
+Default.args = {
+  label: 'Hello',
+  placeholder: 'This is an input',
+  disabled: false,
+  description: undefined,
+  labelVisuallyHidden: false,
+  descriptionVisuallyHidden: false,
+  validationMessage: '',
+  validationValence: undefined
+};
+
+export const Disabled = () => (
+  <Template
+    {...{
+      label: 'Disabled',
+      placeholder: 'This is a disabled input',
+      disabled: true
+    }}
+  />
+);
+
+export const LabelVisuallyHidden = () => (
+  <Template
+    {...{
+      label: 'The label is for screen readers',
+      labelVisuallyHidden: true,
+      placeholder: 'The label for this input exists but is only read by screen readers'
+    }}
+  />
+);
+
+export const InputWithDescription = () => (
+  <Template
+    {...{
+      label: 'Described input',
+      placeholder: 'This input has an accessible description',
+      description: 'This helper text is accessibly associated with the input.'
+    }}
+  />
+);
+
+export const InputWithErrorAndDescription = () => (
+  <Template
+    {...{
+      label: 'Described invalid input',
+      placeholder: 'This input has both an accessible description and a validation error',
+      description: 'This description is identified separately in the accessibility tree.',
+      validationValence: 'error',
+      validationMessage: 'The input has an error.'
+    }}
+  />
+);
+
+export const InputWithValidationAndDescription = () => (
+  <Template
+    {...{
+      label: 'Described input with validation message',
+      placeholder: 'This input is styled to express a validation valence',
+      description: 'This description is extra.',
+      validationValence: 'success',
+      validationMessage: 'This validation message is really part of the description.'
+    }}
+  />
+);

package/src/components/Input/Input.tsx

@@ -0,0 +1,132 @@
+//
+// Copyright 2022 DXOS.org
+//
+
+import cx from 'classnames';
+import React, { ChangeEvent, ComponentProps, ReactNode, useCallback, useState, useTransition } from 'react';
+
+import { useId } from '../../hooks';
+import { MessageValence } from '../../props';
+import {
+  defaultDescription,
+  defaultDisabled,
+  defaultFocus,
+  defaultHover,
+  defaultPlaceholder,
+  valenceColorText,
+  valenceInputBorder
+} from '../../styles';
+
+export type InputSize = 'md' | 'lg';
+
+export interface InputProps extends Omit<ComponentProps<'input'>, 'value' | 'onChange' | 'size'> {
+  label: ReactNode;
+  labelVisuallyHidden?: boolean;
+  description?: ReactNode;
+  descriptionVisuallyHidden?: boolean;
+  initialValue?: string;
+  onChange?: (value: string) => void;
+  disabled?: boolean;
+  size?: InputSize;
+  validationMessage?: ReactNode;
+  validationValence?: MessageValence;
+}
+
+const sizeMap = new Map<InputSize, string>([
+  ['md', ''],
+  ['lg', 'text-base']
+]);
+
+export const Input = ({
+  label,
+  labelVisuallyHidden,
+  placeholder,
+  description,
+  descriptionVisuallyHidden,
+  required,
+  initialValue,
+  onChange,
+  disabled,
+  className,
+  size,
+  validationMessage,
+  validationValence,
+  ...inputProps
+}: InputProps) => {
+  const inputId = inputProps.id || useId('input');
+  const descriptionId = useId('input-description');
+  const validationId = useId('input-validation');
+
+  const [_isPending, startTransition] = useTransition();
+
+  const [internalValue, setInternalValue] = useState<string>(initialValue?.toString() || '');
+
+  const onInternalChange = useCallback(
+    (e: ChangeEvent<HTMLInputElement>) => {
+      const nextValue = e.target?.value || '';
+      setInternalValue(nextValue);
+      onChange &&
+        startTransition(() => {
+          onChange(nextValue);
+        });
+    },
+    [onChange]
+  );
+
+  const isInvalid = !!validationMessage && validationValence === 'error';
+
+  return (
+    <div className={cx('my-4', className)} role='none'>
+      <label
+        htmlFor={inputId}
+        className={cx(
+          'block mb-1 text-sm font-medium text-neutral-900 dark:text-neutral-100',
+          labelVisuallyHidden && 'sr-only'
+        )}
+      >
+        {label}
+      </label>
+      <input
+        id={inputId}
+        {...inputProps}
+        className={cx(
+          defaultFocus,
+          defaultPlaceholder,
+          defaultHover({ disabled }),
+          sizeMap.get(size ?? 'md'),
+          'bg-white/50 border text-neutral-900 text-sm rounded-lg block w-full px-2.5 py-2 dark:bg-neutral-700/50 dark:text-white',
+          valenceInputBorder(validationMessage ? validationValence : undefined),
+          disabled && defaultDisabled
+        )}
+        {...(required && { required: true })}
+        {...(disabled && { disabled: true })}
+        {...(placeholder && { placeholder })}
+        {...(description && { 'aria-describedby': descriptionId })}
+        {...(isInvalid && {
+          'aria-invalid': 'true',
+          'aria-errormessage': validationId
+        })}
+        value={internalValue}
+        onChange={onInternalChange}
+      />
+      {(description || validationMessage) && (
+        <p
+          {...(!isInvalid && { id: descriptionId })}
+          className={cx(descriptionVisuallyHidden && !isInvalid && 'sr-only')}
+        >
+          {validationMessage && (
+            <span id={validationId} className={valenceColorText(validationValence)}>
+              {validationMessage}{' '}
+            </span>
+          )}
+          <span
+            {...(isInvalid && { id: descriptionId })}
+            className={cx(defaultDescription, descriptionVisuallyHidden && 'sr-only')}
+          >
+            {description}
+          </span>
+        </p>
+      )}
+    </div>
+  );
+};

package/src/components/Input/index.ts

@@ -0,0 +1,5 @@
+//
+// Copyright 2022 DXOS.org
+//
+
+export * from './Input';

package/src/components/Loading/Loading.stories.tsx

@@ -0,0 +1,34 @@
+//
+// Copyright 2022 DXOS.org
+//
+
+import '@dxosTheme';
+import React from 'react';
+
+import { templateForComponent } from '../../testing';
+import { Loading, LoadingProps } from './Loading';
+
+export default {
+  title: 'react-ui/Loading',
+  component: Loading,
+  argTypes: {
+    size: {
+      control: 'select',
+      options: ['sm', 'md', 'lg', 'xl']
+    },
+    color: {
+      control: 'select',
+      options: ['primary', 'neutral']
+    }
+  }
+};
+
+const Template = (props: LoadingProps) => <Loading {...props} />;
+
+export const Default = templateForComponent(Template)({ label: 'Loading' });
+Default.args = { label: 'Loading', size: 'md', color: 'primary' };
+
+export const Small = () => <Template label='Loading' size={'sm'} />;
+export const Neutral = () => <Template label='Loading' color={'neutral'} />;
+export const Large = () => <Template label='Loading' size={'lg'} />;
+export const ExtraLarge = () => <Template label='Loading' size={'xl'} />;

package/src/components/Loading/Loading.tsx

@@ -0,0 +1,59 @@
+//
+// Copyright 2022 DXOS.org
+//
+
+import cx from 'classnames';
+import React from 'react';
+
+import { useId } from '../../hooks';
+
+export type LoadingSize = 'sm' | 'md' | 'lg' | 'xl';
+
+export type LoadingColor = 'primary' | 'neutral';
+
+export interface LoadingProps {
+  label: string;
+  size?: LoadingSize;
+  color?: LoadingColor;
+  className?: string;
+}
+
+const sizeMap = new Map<LoadingSize, string>([
+  ['sm', 'w-4 h-4'],
+  ['md', 'w-8 h-8'],
+  ['lg', 'w-12 h-12'],
+  ['xl', 'w-16 h-16']
+]);
+
+export const Loading = ({ size, color, className, label }: LoadingProps & { label: string }) => {
+  const labelId = useId('loading-label');
+  const sizeClassName = sizeMap.get(size ?? 'md');
+  return (
+    <div role='status' className={cx('flex justify-center p-4', className)} aria-labelledby={labelId}>
+      <svg
+        role='none'
+        aria-hidden='true'
+        className={cx(
+          sizeClassName,
+          'text-neutral-200/50 animate-spin dark:text-neutral-600/50',
+          color === 'neutral' ? 'fill-neutral-400' : 'fill-primary-400'
+        )}
+        viewBox='0 0 100 101'
+        fill='none'
+        xmlns='http://www.w3.org/2000/svg'
+      >
+        <path
+          d='M100 50.5908C100 78.2051 77.6142 100.591 50 100.591C22.3858 100.591 0 78.2051 0 50.5908C0 22.9766 22.3858 0.59082 50 0.59082C77.6142 0.59082 100 22.9766 100 50.5908ZM9.08144 50.5908C9.08144 73.1895 27.4013 91.5094 50 91.5094C72.5987 91.5094 90.9186 73.1895 90.9186 50.5908C90.9186 27.9921 72.5987 9.67226 50 9.67226C27.4013 9.67226 9.08144 27.9921 9.08144 50.5908Z'
+          fill='currentColor'
+        />
+        <path
+          d='M93.9676 39.0409C96.393 38.4038 97.8624 35.9116 97.0079 33.5539C95.2932 28.8227 92.871 24.3692 89.8167 20.348C85.8452 15.1192 80.8826 10.7238 75.2124 7.41289C69.5422 4.10194 63.2754 1.94025 56.7698 1.05124C51.7666 0.367541 46.6976 0.446843 41.7345 1.27873C39.2613 1.69328 37.813 4.19778 38.4501 6.62326C39.0873 9.04874 41.5694 10.4717 44.0505 10.1071C47.8511 9.54855 51.7191 9.52689 55.5402 10.0491C60.8642 10.7766 65.9928 12.5457 70.6331 15.2552C75.2735 17.9648 79.3347 21.5619 82.5849 25.841C84.9175 28.9121 86.7997 32.2913 88.1811 35.8758C89.083 38.2158 91.5421 39.6781 93.9676 39.0409Z'
+          fill='currentFill'
+        />
+      </svg>
+      <span className='sr-only' id={labelId}>
+        {label}
+      </span>
+    </div>
+  );
+};

package/src/components/Loading/index.ts

@@ -0,0 +1,5 @@
+//
+// Copyright 2022 DXOS.org
+//
+
+export * from './Loading';

package/src/components/Main/Main.tsx

@@ -0,0 +1,14 @@
+//
+// Copyright 2022 DXOS.org
+//
+
+import cx from 'classnames';
+import React, { ComponentProps, PropsWithChildren } from 'react';
+
+export const Main = ({ children, className, ...mainProps }: PropsWithChildren<ComponentProps<'main'>>) => {
+  return (
+    <main {...mainProps} className={cx('mt-8 px-8 space-y-4', className)}>
+      {children}
+    </main>
+  );
+};

package/src/components/Main/index.ts

@@ -0,0 +1,5 @@
+//
+// Copyright 2022 DXOS.org
+//
+
+export * from './Main';

package/src/components/NavMenu/NavMenu.stories.tsx

@@ -0,0 +1,54 @@
+//
+// Copyright 2022 DXOS.org
+//
+
+import '@dxosTheme';
+import React from 'react';
+
+import { templateForComponent } from '../../testing';
+import { NavMenu, NavMenuProps } from './NavMenu';
+
+export default {
+  title: 'react-ui/NavMenu',
+  component: NavMenu
+};
+
+const Template = (props: NavMenuProps) => {
+  return <NavMenu {...props} />;
+};
+
+export const Default = templateForComponent(Template)({ items: [] });
+Default.args = {
+  items: [
+    {
+      triggerLinkProps: { href: '#Hello' },
+      children: 'Hello',
+      active: true
+    },
+    {
+      children: 'How’s it going?',
+      content: (
+        <div className='w-[21rem] lg:w-[23rem] p-3'>
+          <div className='grid grid-cols-6 gap-4'>
+            <div className='col-span-2 w-full bg-gray-100 dark:bg-gray-900 p-4 rounded-md'></div>
+
+            <div className='col-span-4 w-full flex flex-col space-y-3 bg-gray-100 dark:bg-gray-900 p-4 rounded-md'>
+              <div className='w-full bg-white dark:bg-gray-700 h-12 rounded-md'></div>
+              <div className='w-full bg-white dark:bg-gray-700 h-12 rounded-md'></div>
+              <div className='w-full bg-white dark:bg-gray-700 h-12 rounded-md'></div>
+              <div className='w-full bg-white dark:bg-gray-700 h-12 rounded-md'></div>
+            </div>
+          </div>
+        </div>
+      )
+    },
+    {
+      triggerLinkProps: { href: '#Goodbye' },
+      tooltip: {
+        content: 'More info about Goodbye',
+        sideOffset: 8
+      },
+      children: 'Goodbye'
+    }
+  ]
+};

package/src/components/NavMenu/NavMenu.tsx

@@ -0,0 +1,180 @@
+//
+// Copyright 2022 DXOS.org
+//
+
+import * as NavigationMenuPrimitive from '@radix-ui/react-navigation-menu';
+import cx from 'classnames';
+import React, { ComponentProps, ForwardedRef, forwardRef, ReactNode } from 'react';
+
+import { defaultFocus, defaultHover } from '../../styles';
+import { defaultButtonColors, primaryButtonColors } from '../Button';
+import { Tooltip, TooltipProps } from '../Tooltip';
+
+interface NavMenuItemSharedProps {
+  children: ReactNode;
+  active?: boolean;
+  separator?: false;
+}
+
+export interface NavMenuLinkItemProps extends NavMenuItemSharedProps {
+  triggerLinkProps: Omit<ComponentProps<typeof NavigationMenuPrimitive.Link>, 'children'>;
+  children: ReactNode;
+}
+
+export interface NavMenuTooltipLinkItemProps extends NavMenuLinkItemProps {
+  tooltip: Omit<TooltipProps, 'children'>;
+}
+
+export interface NavMenuInvokerItemProps extends NavMenuItemSharedProps {
+  content: ReactNode;
+  children: ReactNode;
+}
+
+export interface NavMenuSeparatorProps {
+  separator: true;
+}
+
+export type NavMenuItem =
+  | NavMenuTooltipLinkItemProps
+  | NavMenuLinkItemProps
+  | NavMenuInvokerItemProps
+  | NavMenuSeparatorProps;
+
+export interface NavMenuProps extends ComponentProps<typeof NavigationMenuPrimitive.Root> {
+  items: NavMenuItem[];
+}
+
+const NavMenuInvokerItem = forwardRef(
+  ({ content, children, active }: NavMenuInvokerItemProps, ref: ForwardedRef<HTMLLIElement>) => {
+    return (
+      <NavigationMenuPrimitive.Item ref={ref}>
+        <NavigationMenuPrimitive.Trigger
+          className={cx(
+            'px-3 py-2 text-sm rounded-md text-sm font-medium transition-color',
+            active ? primaryButtonColors : defaultButtonColors,
+            defaultFocus,
+            defaultHover({})
+          )}
+        >
+          {children}
+        </NavigationMenuPrimitive.Trigger>
+        <NavigationMenuPrimitive.Content
+          className={cx(
+            'absolute w-auto top-0 left-0 rounded-lg',
+            'radix-motion-from-start:animate-enter-from-left',
+            'radix-motion-from-end:animate-enter-from-right',
+            'radix-motion-to-start:animate-exit-to-left',
+            'radix-motion-to-end:animate-exit-to-right'
+          )}
+        >
+          {content}
+        </NavigationMenuPrimitive.Content>
+      </NavigationMenuPrimitive.Item>
+    );
+  }
+);
+
+const NavMenuLinkItem = forwardRef(
+  ({ triggerLinkProps, children, active }: NavMenuLinkItemProps, ref: ForwardedRef<HTMLLIElement>) => (
+    <NavigationMenuPrimitive.Item asChild ref={ref}>
+      <NavigationMenuPrimitive.Link
+        {...triggerLinkProps}
+        active={active}
+        className={cx(
+          'px-3 py-2 text-sm rounded-md transition-color',
+          active ? primaryButtonColors : defaultButtonColors,
+          active ? 'font-medium' : 'font-normal',
+          defaultFocus,
+          defaultHover({}),
+          triggerLinkProps.className
+        )}
+      >
+        {children}
+      </NavigationMenuPrimitive.Link>
+    </NavigationMenuPrimitive.Item>
+  )
+);
+
+const NavMenuTooltipLinkItem = forwardRef(
+  ({ tooltip, triggerLinkProps, active, children }: NavMenuTooltipLinkItemProps, ref: ForwardedRef<HTMLLIElement>) => (
+    <Tooltip {...tooltip}>
+      {/* todo: why does the Tooltip not show if you use <NavMenuLinkItem {…}/> here? */}
+      <NavigationMenuPrimitive.Item asChild ref={ref}>
+        <NavigationMenuPrimitive.Link
+          {...triggerLinkProps}
+          active={active}
+          className={cx(
+            'px-3 py-2 text-sm rounded-md transition-color',
+            active ? primaryButtonColors : defaultButtonColors,
+            active ? 'font-medium' : 'font-normal',
+            defaultFocus,
+            defaultHover({}),
+            triggerLinkProps.className
+          )}
+        >
+          {children}
+        </NavigationMenuPrimitive.Link>
+      </NavigationMenuPrimitive.Item>
+    </Tooltip>
+  )
+);
+
+export const NavMenuLink = NavigationMenuPrimitive.Link;
+
+export const NavMenuSeparatorItem = (_props: NavMenuSeparatorProps) => {
+  return <span role='none' className='h-5 border-l border-neutral-300 dark:border-neutral-700' />;
+};
+
+const isTooltipLinkItem = (o: any): o is NavMenuTooltipLinkItemProps => 'tooltip' in o;
+const isLinkItem = (o: any): o is NavMenuLinkItemProps => 'triggerLinkProps' in o;
+const isSeparator = (o: any): o is NavMenuSeparatorProps => 'separator' in o;
+
+export const NavMenu = ({ items, ...rootProps }: NavMenuProps) => {
+  return (
+    <NavigationMenuPrimitive.Root {...rootProps} className={cx('flex justify-center', rootProps.className)}>
+      <NavigationMenuPrimitive.List className='relative flex flex-row items-center gap-2 rounded-lg bg-white dark:bg-neutral-800 p-2 button-elevation overflow-x-auto'>
+        {items.map((item: NavMenuItem, i) => {
+          return isTooltipLinkItem(item) ? (
+            <NavMenuTooltipLinkItem key={i} {...item} />
+          ) : isLinkItem(item) ? (
+            <NavMenuLinkItem key={i} {...item} />
+          ) : isSeparator(item) ? (
+            <NavMenuSeparatorItem key={i} {...item} />
+          ) : (
+            <NavMenuInvokerItem key={i} {...item} />
+          );
+        })}
+
+        <NavigationMenuPrimitive.Indicator
+          className={cx(
+            'z-10',
+            'top-[100%] flex items-end justify-center h-2 overflow-hidden',
+            'radix-state-visible:animate-fade-in',
+            'radix-state-hidden:animate-fade-out',
+            'transition-[width_transform] duration-[250ms] ease-[ease]'
+          )}
+        >
+          <div className='top-1 relative bg-white dark:bg-neutral-800 w-2 h-2 rotate-45' />
+        </NavigationMenuPrimitive.Indicator>
+      </NavigationMenuPrimitive.List>
+
+      <div
+        className={cx('absolute flex justify-center', 'w-[140%] left-[-20%] top-[100%]')}
+        style={{
+          perspective: '2000px'
+        }}
+      >
+        <NavigationMenuPrimitive.Viewport
+          className={cx(
+            'relative mt-2 shadow-lg rounded-md bg-white dark:bg-neutral-800 overflow-hidden',
+            'w-radix-navigation-menu-viewport',
+            'h-radix-navigation-menu-viewport',
+            'radix-state-open:animate-scale-in-content',
+            'radix-state-closed:animate-scale-out-content',
+            'origin-[top_center] transition-[width_height] duration-300 ease-[ease]'
+          )}
+        />
+      </div>
+    </NavigationMenuPrimitive.Root>
+  );
+};

package/src/components/NavMenu/index.ts

@@ -0,0 +1,5 @@
+//
+// Copyright 2022 DXOS.org
+//
+
+export * from './NavMenu';

package/src/components/Popover/Popover.stories.tsx

@@ -0,0 +1,45 @@
+//
+// Copyright 2022 DXOS.org
+//
+
+import '@dxosTheme';
+import cx from 'classnames';
+import React from 'react';
+
+import { defaultFocus, defaultHover, defaultActive } from '../../styles';
+import { templateForComponent } from '../../testing';
+import { Avatar } from '../Avatar';
+import { Button } from '../Button';
+import { Popover, PopoverProps } from './Popover';
+
+export default {
+  title: 'react-ui/Popover',
+  component: Popover
+};
+
+const Template = ({ children, ...props }: PopoverProps) => {
+  return <Popover {...props}>{children}</Popover>;
+};
+
+export const Default = templateForComponent(Template)({
+  openTrigger: '',
+  closeLabel: '',
+  children: ''
+});
+Default.args = {
+  openTrigger: <Button>Open popover</Button>,
+  children: 'Popover content'
+};
+
+export const AvatarTrigger = templateForComponent(Template)({
+  openTrigger: (
+    <Avatar
+      tabIndex={0}
+      label={<span className='sr-only'>Open popover</span>}
+      fallbackValue='open popover'
+      className={cx('button-elevation cursor-pointer rounded-md', defaultHover({}), defaultFocus, defaultActive)}
+    />
+  ),
+  closeLabel: 'Close',
+  children: 'Popover content'
+});