@dxos/react-ui 0.8.4-main.ef1bc66f44 → 0.8.4-main.effb148878

package/src/components/Card/Card.stories.tsx

@@ -0,0 +1,172 @@
+//
+// Copyright 2025 DXOS.org
+//
+
+import { type Meta, type StoryObj } from '@storybook/react-vite';
+import React, { useRef } from 'react';
+
+import { random } from '@dxos/random';
+import { Icon } from '@dxos/react-ui';
+import { withLayout, withTheme } from '@dxos/react-ui/testing';
+
+import { Card } from './Card';
+
+random.seed(0);
+
+type DefaultStoryProps = {
+  title: string;
+  description?: string;
+  image?: string;
+  fullWidth?: boolean;
+};
+
+const DefaultStory = ({ title, description, image, fullWidth }: DefaultStoryProps) => {
+  const handleRef = useRef<HTMLButtonElement>(null);
+  console.log(title);
+  return (
+    <Card.Root fullWidth={fullWidth}>
+      <Card.Header>
+        <Card.DragHandle ref={handleRef} />
+        <Card.Title>{title}</Card.Title>
+        <Card.ActionIconButton action='close' onClick={() => console.log('close')} />
+      </Card.Header>
+      <Card.Body>
+        <Card.Poster alt='Card.Poster' image={image} />
+        <Card.Row icon='ph--dot-outline--regular'>
+          <Card.Text>Card.Text (default)</Card.Text>
+        </Card.Row>
+        <Card.Row icon='ph--dot-outline--regular'>
+          <Card.Text variant='description'>
+            Card.Text (description)
+            <br />
+            {description}
+          </Card.Text>
+        </Card.Row>
+        <Card.Action label='Card.Action' onClick={() => console.log('action')} />
+        <Card.Link label='Card.Link' href='https://dxos.org' />
+      </Card.Body>
+    </Card.Root>
+  );
+};
+
+const meta = {
+  title: 'ui/react-ui-core/components/Card',
+  render: DefaultStory,
+  decorators: [withTheme(), withLayout({ layout: 'centered', classNames: 'grid w-[30rem] place-items-center' })],
+} satisfies Meta<typeof DefaultStory>;
+
+export default meta;
+
+type Story = StoryObj<typeof meta>;
+
+const image = random.image.url();
+
+export const Default: Story = {
+  args: {
+    title: random.commerce.productName(),
+    description: random.lorem.paragraph(3),
+    image,
+  },
+};
+
+export const FullWidth: Story = {
+  args: {
+    title: random.commerce.productName(),
+    description: random.lorem.paragraph(3),
+    image,
+    fullWidth: true,
+  },
+};
+
+export const Simple: Story = {
+  args: {
+    title: random.commerce.productName(),
+  },
+  render: ({ title }) => {
+    const handleRef = useRef<HTMLButtonElement>(null);
+    return (
+      <Card.Root>
+        <Card.Header>
+          <Card.DragHandle ref={handleRef} />
+          <Card.Title>{title}</Card.Title>
+          <Card.ActionIconButton action='close' onClick={() => console.log('close')} />
+        </Card.Header>
+      </Card.Root>
+    );
+  },
+};
+
+export const Section: Story = {
+  args: {
+    title: random.commerce.productName(),
+  },
+  render: ({ title }) => {
+    const handleRef = useRef<HTMLButtonElement>(null);
+    return (
+      <Card.Root>
+        <Card.Header>
+          <Card.DragHandle ref={handleRef} />
+          <Card.Title>{title}</Card.Title>
+          <Card.ActionIconButton action='close' onClick={() => console.log('close')} />
+        </Card.Header>
+        <Card.Body>
+          <Card.Section title='Recent'>
+            <Card.Action label='First action' icon='ph--calendar-dot--regular' onClick={() => console.log('1')} />
+            <Card.Action label='Second action' icon='ph--calendar-dot--regular' onClick={() => console.log('2')} />
+          </Card.Section>
+          <Card.Section title='Upcoming'>
+            <Card.Action label='Third action' icon='ph--calendar-dot--regular' onClick={() => console.log('3')} />
+          </Card.Section>
+        </Card.Body>
+      </Card.Root>
+    );
+  },
+};
+
+export const Description: Story = {
+  args: {
+    title: random.commerce.productName(),
+    description: random.lorem.paragraph(3),
+  },
+  render: ({ title, description }) => {
+    const handleRef = useRef<HTMLButtonElement>(null);
+    return (
+      <Card.Root>
+        <Card.Header>
+          <Card.DragHandle ref={handleRef} />
+          <Card.Title>{title}</Card.Title>
+          <Card.ActionIconButton action='close' onClick={() => console.log('close')} />
+        </Card.Header>
+        <Card.Body>
+          <Card.Row>
+            <Card.Text variant='description'>{description}</Card.Text>
+          </Card.Row>
+        </Card.Body>
+      </Card.Root>
+    );
+  },
+};
+
+export const Mock = () => (
+  <div className='grid grid-cols-[2rem_1fr_2rem] w-full dx-card-min-width dx-card-max-width border border-separator rounded-xs'>
+    <div className='grid grid-cols-subgrid col-span-full'>
+      <div className='grid h-[var(--dx-rail-item)] w-[var(--dx-rail-item)] place-items-center'>
+        <Icon icon='ph--dots-six-vertical--regular' />
+      </div>
+      <div className='p-1 whitespace-normal break-words text-description items-center'>
+        This line is very very long and it should wrap.
+      </div>
+      <div className='grid h-[var(--dx-rail-item)] w-[var(--dx-rail-item)] place-items-center'>
+        <Icon icon='ph--x--regular' />
+      </div>
+    </div>
+    <div className='grid grid-cols-subgrid col-span-3'>
+      <div className='grid h-[var(--dx-rail-item)] w-[var(--dx-rail-item)] place-items-center'>
+        <Icon icon='ph--dots-six-vertical--regular' />
+      </div>
+      <div className='p-1 text-description items-center col-span-2'>
+        This line is very very long and it should wrap.
+      </div>
+    </div>
+  </div>
+);

package/src/components/Card/Card.theme.ts

@@ -0,0 +1,101 @@
+//
+// Copyright 2025 DXOS.org
+//
+
+import { mx } from '@dxos/ui-theme';
+import { type ComponentFunction, type Density, type Theme } from '@dxos/ui-types';
+
+export type CardStyleProps = {
+  border?: boolean;
+  fullWidth?: boolean;
+  srOnly?: boolean;
+  variant?: 'default' | 'subtitle' | 'description';
+  density?: Density;
+  truncate?: boolean;
+  padding?: boolean;
+};
+
+const root: ComponentFunction<CardStyleProps> = ({ border, fullWidth }, ...etc) =>
+  mx(
+    'dx-card dx-card-min-width dx-card-max-width min-h-(--dx-rail-item) group/card relative overflow-hidden',
+    border &&
+      'bg-card-surface border border-separator dark:border-subdued-separator rounded-sm dx-focus-ring-group-y-indicator',
+    fullWidth && 'max-w-none!',
+    ...etc,
+  );
+
+const header: ComponentFunction<CardStyleProps> = (_, ...etc) =>
+  mx(
+    'dx-card__header dx-density-md bg-transparent p-0! gap-0! col-span-3 grid! grid-cols-subgrid! [contain:none]',
+    ...etc,
+  );
+
+const title: ComponentFunction<CardStyleProps> = (_props, ...etc) => mx('dx-card__title grow truncate', ...etc);
+
+const body: ComponentFunction<CardStyleProps> = (_props, ...etc) => mx('dx-card__body contents pb-1 last:pb-0', ...etc);
+
+const text: ComponentFunction<CardStyleProps> = ({ variant = 'default', truncate: _truncate }, ...etc) =>
+  mx(
+    'dx-card__text items-center overflow-hidden',
+    variant === 'default' && 'py-1',
+    variant === 'description' && 'py-1.5 text-description',
+    ...etc,
+  );
+
+const textSpan: ComponentFunction<CardStyleProps> = ({ variant = 'default', truncate }, ...etc) =>
+  mx(variant === 'description' && 'text-sm text-description line-clamp-3', truncate && 'truncate', ...etc);
+
+const poster: ComponentFunction<CardStyleProps> = (_props, ...etc) =>
+  mx('dx-card__poster col-span-3 max-h-[200px]', ...etc);
+
+const posterIcon: ComponentFunction<CardStyleProps> = (_props, ...etc) =>
+  mx('dx-card__poster-icon col-span-3 grid place-items-center bg-input-surface text-subdued max-h-[200px]', ...etc);
+
+const action: ComponentFunction<CardStyleProps> = (_props, ...etc) =>
+  mx('dx-card__acztion col-span-3 !grid grid-cols-subgrid p-0! w-full text-start overflow-hidden', ...etc);
+
+const actionLabel: ComponentFunction<CardStyleProps> = (_props, ...etc) =>
+  mx('dx-card__action-label min-w-0 flex-1 truncate', ...etc);
+
+const link: ComponentFunction<CardStyleProps> = (_props, ...etc) =>
+  mx('dx-card__link col-span-3 !grid grid-cols-subgrid group p-0! dx-button dx-focus-ring min-h-1!', ...etc);
+
+const linkLabel: ComponentFunction<CardStyleProps> = (_props, ...etc) =>
+  mx('dx-card__link-label min-w-0 flex-1 truncate', ...etc);
+
+const row: ComponentFunction<CardStyleProps> = ({ fullWidth }, ...etc) =>
+  mx('dx-card__row', fullWidth ? 'col-span-full' : 'col-span-3 grid grid-cols-subgrid', ...etc);
+
+// NOTE: Direct children that lack an explicit `col-*` utility default to the
+// Column.Root center track (via `--dx-col`); see `ui-theme`'s `css/components/card.css`.
+const section: ComponentFunction<CardStyleProps> = (_props, ...etc) =>
+  mx('dx-card__section col-span-full grid grid-cols-subgrid', ...etc);
+
+const sectionTitle: ComponentFunction<CardStyleProps> = (_props, ...etc) =>
+  mx('dx-card__section-title col-start-2 col-span-full py-2 text-xs text-description font-medium uppercase', ...etc);
+
+const iconBlock: ComponentFunction<CardStyleProps> = ({ padding }, ...etc) =>
+  mx(
+    'dx-card__icon-block grid h-[var(--dx-rail-item)] w-[var(--dx-rail-item)] place-items-center',
+    padding && '[&>*]:p-1',
+    ...etc,
+  );
+
+export const cardTheme: Theme<CardStyleProps> = {
+  root,
+  header,
+  title,
+  body,
+  row,
+  section,
+  'section-title': sectionTitle,
+  text,
+  'text-span': textSpan,
+  poster,
+  'poster-icon': posterIcon,
+  action,
+  'action-label': actionLabel,
+  link,
+  'link-label': linkLabel,
+  'icon-block': iconBlock,
+};