@dxos/react-ui-stack 0.8.4-main.f5c0578 → 0.8.4-main.fcfe5033a5

package/src/components/deprecated/LayoutControls.tsx

@@ -1,109 +0,0 @@
-//
-// Copyright 2024 DXOS.org
-//
-
-import React, { forwardRef } from 'react';
-
-import { ButtonGroup, type ButtonGroupProps, type ButtonProps, IconButton, useTranslation } from '@dxos/react-ui';
-
-import { translationKey } from '../../translations';
-
-export type LayoutControlEvent = 'solo' | 'close' | `${'pin' | 'increment'}-${'start' | 'end'}`;
-export type LayoutControlHandler = (event: LayoutControlEvent) => void;
-
-export type LayoutCapabilities = {
-  incrementStart?: boolean;
-  incrementEnd?: boolean;
-  solo?: boolean;
-};
-
-export type LayoutControlsProps = Omit<ButtonGroupProps, 'onClick'> & {
-  onClick?: LayoutControlHandler;
-  variant?: 'hide-disabled' | 'default';
-  close?: boolean | 'minify-start' | 'minify-end';
-  capabilities: LayoutCapabilities;
-  isSolo?: boolean;
-  pin?: 'start' | 'end' | 'both';
-};
-
-const LayoutControl = ({ icon, label, ...props }: Omit<ButtonProps, 'children'> & { label: string; icon: string }) => {
-  return <IconButton iconOnly icon={icon} label={label} tooltipSide='bottom' variant='ghost' {...props} />;
-};
-
-export const LayoutControls = forwardRef<HTMLDivElement, LayoutControlsProps>(
-  (
-    { onClick, variant = 'default', capabilities: can, isSolo, pin, close = false, children, ...props },
-    forwardedRef,
-  ) => {
-    const { t } = useTranslation(translationKey);
-    const buttonClassNames = variant === 'hide-disabled' ? 'disabled:hidden !p-1' : '!p-1';
-
-    return (
-      <ButtonGroup {...props} ref={forwardedRef}>
-        {pin && !isSolo && ['both', 'start'].includes(pin) && (
-          <LayoutControl
-            label={t('pin start label')}
-            variant='ghost'
-            classNames={buttonClassNames}
-            onClick={() => onClick?.('pin-start')}
-            icon='ph--caret-line-left--regular'
-          />
-        )}
-
-        {can.solo && (
-          <LayoutControl
-            label={t('solo layout label')}
-            classNames={buttonClassNames}
-            onClick={() => onClick?.('solo')}
-            icon={isSolo ? 'ph--arrows-in--regular' : 'ph--arrows-out--regular'}
-          />
-        )}
-
-        {!isSolo && can.solo && (
-          <>
-            <LayoutControl
-              label={t('increment start label')}
-              disabled={!can.incrementStart}
-              classNames={buttonClassNames}
-              onClick={() => onClick?.('increment-start')}
-              icon='ph--caret-left--regular'
-            />
-            <LayoutControl
-              label={t('increment end label')}
-              disabled={!can.incrementEnd}
-              classNames={buttonClassNames}
-              onClick={() => onClick?.('increment-end')}
-              icon='ph--caret-right--regular'
-            />
-          </>
-        )}
-
-        {pin && !isSolo && ['both', 'end'].includes(pin) && (
-          <LayoutControl
-            label={t('pin end label')}
-            classNames={buttonClassNames}
-            onClick={() => onClick?.('pin-end')}
-            icon='ph--caret-line-right--regular'
-          />
-        )}
-
-        {close && !isSolo && (
-          <LayoutControl
-            label={t(`${typeof close === 'string' ? 'minify' : 'close'} label`)}
-            classNames={buttonClassNames}
-            onClick={() => onClick?.('close')}
-            data-testid='layoutHeading.close'
-            icon={
-              close === 'minify-start'
-                ? 'ph--caret-line-left--regular'
-                : close === 'minify-end'
-                  ? 'ph--caret-line-right--regular'
-                  : 'ph--x--regular'
-            }
-          />
-        )}
-        {children}
-      </ButtonGroup>
-    );
-  },
-);

package/src/exemplars/Card/Card.stories.tsx

@@ -1,78 +0,0 @@
-//
-// Copyright 2025 DXOS.org
-//
-
-import '@dxos-theme';
-
-import { type Meta, type StoryObj } from '@storybook/react-vite';
-import React from 'react';
-
-import { faker } from '@dxos/random';
-import { withTheme } from '@dxos/storybook-utils';
-
-import { Card } from './Card';
-
-// Set a seed for reproducible random values
-faker.seed(0);
-
-type CardStoryProps = {
-  title: string;
-  description: string;
-  image: string;
-  showImage: boolean;
-  showIcon: boolean;
-};
-
-const meta: Meta<CardStoryProps> = {
-  title: 'ui/react-ui-stack/Card',
-  decorators: [withTheme],
-  argTypes: {
-    title: {
-      control: 'text',
-      description: 'Card title',
-    },
-    description: {
-      control: 'text',
-      description: 'Card description',
-    },
-    image: {
-      control: 'text',
-      description: 'URL for the poster image',
-    },
-    showImage: {
-      control: 'boolean',
-      description: 'Whether to show the image',
-    },
-    showIcon: {
-      control: 'boolean',
-      description: 'Whether to show an icon (when image is not shown)',
-    },
-  },
-  args: {
-    title: faker.commerce.productName(),
-    description: faker.lorem.paragraph(),
-    image: faker.image.url(),
-    showImage: true,
-    showIcon: true,
-  },
-};
-
-export default meta;
-
-export const Default: StoryObj<CardStoryProps> = {
-  render: ({ title, description, image, showImage, showIcon }: CardStoryProps) => (
-    <div className='max-is-md'>
-      <Card.StaticRoot>
-        <Card.Toolbar>
-          <Card.DragHandle toolbarItem />
-          <Card.ToolbarSeparator variant='gap' />
-          <Card.ToolbarIconButton iconOnly variant='ghost' icon='ph--x--regular' label={'remove card label'} />
-        </Card.Toolbar>
-        {showImage && <Card.Poster alt={title} image={image} />}
-        {!showImage && showIcon && <Card.Poster alt={title} icon='ph--building-office--regular' />}
-        <Card.Heading>{title}</Card.Heading>
-        {description && <Card.Text classNames='line-clamp-2'>{description}</Card.Text>}
-      </Card.StaticRoot>
-    </div>
-  ),
-};

package/src/exemplars/Card/Card.tsx

@@ -1,187 +0,0 @@
-//
-// Copyright 2025 DXOS.org
-//
-
-import { Primitive } from '@radix-ui/react-primitive';
-import { Slot } from '@radix-ui/react-slot';
-import React, {
-  type ComponentPropsWithRef,
-  type ComponentPropsWithoutRef,
-  type FC,
-  type PropsWithChildren,
-  forwardRef,
-} from 'react';
-
-import { Icon, IconButton, type ThemedClassName, Toolbar, type ToolbarRootProps, useTranslation } from '@dxos/react-ui';
-import { hoverableControls, mx } from '@dxos/react-ui-theme';
-
-import { StackItem } from '../../components';
-import { translationKey } from '../../translations';
-
-import { cardChrome, cardHeading, cardRoot, cardSpacing, cardText } from './fragments';
-
-type SharedCardProps = ThemedClassName<ComponentPropsWithoutRef<'div'>> & { asChild?: boolean };
-
-const CardStaticRoot = forwardRef<HTMLDivElement, SharedCardProps>(
-  ({ children, classNames, asChild, role = 'group', ...props }, forwardedRef) => {
-    const Root = asChild ? Slot : 'div';
-    const rootProps = asChild ? { classNames: [cardRoot, classNames] } : { className: mx(cardRoot, classNames), role };
-    return (
-      <Root {...props} {...rootProps} ref={forwardedRef}>
-        {children}
-      </Root>
-    );
-  },
-);
-
-/**
- * This should be used by Surface fulfillments in cases where the content may or may not already be encapsulated (e.g.
- * in a Popover) and knows this based on the `role` it receives. This will render a `Card.StaticRoot` by default, otherwise
- * it will render a `div` primitive with the appropriate styling for specific handled situations.
- */
-const CardSurfaceRoot = ({
-  role = 'never',
-  children,
-  classNames,
-}: ThemedClassName<PropsWithChildren<{ role?: string }>>) => {
-  if (['card--popover', 'card--intrinsic', 'card--extrinsic'].includes(role)) {
-    return (
-      <div
-        className={mx(
-          role === 'card--popover'
-            ? 'popover-card-width'
-            : ['card--intrinsic', 'card--extrinsic'].includes(role)
-              ? 'contents'
-              : '',
-          classNames,
-        )}
-      >
-        {children}
-      </div>
-    );
-  } else {
-    return (
-      <CardStaticRoot
-        classNames={[
-          role === 'card--transclusion' && 'mlb-[1em]',
-          role === 'card--transclusion' && hoverableControls,
-          classNames,
-        ]}
-      >
-        {children}
-      </CardStaticRoot>
-    );
-  }
-};
-
-const CardHeading = forwardRef<HTMLDivElement, SharedCardProps>(
-  ({ children, classNames, asChild, role = 'heading', ...props }, forwardedRef) => {
-    const Root = asChild ? Slot : 'div';
-    const rootProps = asChild
-      ? { classNames: [cardHeading, cardText, classNames] }
-      : { className: mx(cardHeading, cardText, classNames), role };
-    return (
-      <Root {...props} {...rootProps} ref={forwardedRef}>
-        {children}
-      </Root>
-    );
-  },
-);
-
-const CardToolbar = forwardRef<HTMLDivElement, ToolbarRootProps>(({ children, classNames, ...props }, forwardedRef) => {
-  return (
-    <Toolbar.Root {...props} classNames={['bg-transparent density-coarse', classNames]} ref={forwardedRef}>
-      {children}
-    </Toolbar.Root>
-  );
-});
-
-const CardToolbarIconButton = Toolbar.IconButton;
-const CardToolbarSeparator = Toolbar.Separator;
-
-const CardDragHandle = forwardRef<HTMLButtonElement, { toolbarItem?: boolean }>(({ toolbarItem }, forwardedRef) => {
-  const { t } = useTranslation(translationKey);
-  const Root = toolbarItem ? Toolbar.IconButton : IconButton;
-  return (
-    <Root
-      iconOnly
-      icon='ph--dots-six-vertical--regular'
-      variant='ghost'
-      label={t('drag handle label')}
-      classNames='pli-2'
-      ref={forwardedRef}
-    />
-  );
-});
-
-const CardDragPreview = StackItem.DragPreview;
-
-const CardMenu = Primitive.div as FC<ComponentPropsWithRef<'div'>>;
-
-type CardPosterProps = {
-  alt: string;
-  aspect?: 'video' | 'auto';
-} & Partial<{ image: string; icon: string }>;
-
-const CardPoster = (props: CardPosterProps) => {
-  const aspect = props.aspect === 'auto' ? 'aspect-auto' : 'aspect-video';
-  if (props.image) {
-    return (
-      <img className={`dx-card__poster ${aspect} object-cover is-full bs-auto`} src={props.image} alt={props.alt} />
-    );
-  }
-  if (props.icon) {
-    return (
-      <div
-        role='image'
-        className={`dx-card__poster grid ${aspect} place-items-center bg-inputSurface text-subdued`}
-        aria-label={props.alt}
-      >
-        <Icon icon={props.icon} size={10} />
-      </div>
-    );
-  }
-};
-
-const CardChrome = forwardRef<HTMLDivElement, SharedCardProps>(
-  ({ children, classNames, asChild, role = 'none', ...props }, forwardedRef) => {
-    const Root = asChild ? Slot : 'div';
-    const rootProps = asChild
-      ? { classNames: [cardChrome, classNames] }
-      : { className: mx(cardChrome, classNames), role };
-    return (
-      <Root {...props} {...rootProps} ref={forwardedRef}>
-        {children}
-      </Root>
-    );
-  },
-);
-
-const CardText = forwardRef<HTMLDivElement, SharedCardProps>(
-  ({ children, classNames, asChild, role = 'none', ...props }, forwardedRef) => {
-    const Root = asChild ? Slot : 'div';
-    const rootProps = asChild ? { classNames: [cardText, classNames] } : { className: mx(cardText, classNames), role };
-    return (
-      <Root {...props} {...rootProps} ref={forwardedRef}>
-        {children}
-      </Root>
-    );
-  },
-);
-
-export const Card = {
-  StaticRoot: CardStaticRoot,
-  SurfaceRoot: CardSurfaceRoot,
-  Heading: CardHeading,
-  Toolbar: CardToolbar,
-  ToolbarIconButton: CardToolbarIconButton,
-  ToolbarSeparator: CardToolbarSeparator,
-  DragHandle: CardDragHandle,
-  DragPreview: CardDragPreview,
-  Menu: CardMenu,
-  Poster: CardPoster,
-  Chrome: CardChrome,
-  Text: CardText,
-};
-
-export { cardRoot, cardHeading, cardText, cardChrome, cardSpacing };

package/src/exemplars/Card/CardDragPreview.tsx

@@ -1,22 +0,0 @@
-//
-// Copyright 2025 DXOS.org
-//
-
-import React, { type PropsWithChildren } from 'react';
-
-import { mx } from '@dxos/react-ui-theme';
-
-import { cardRoot } from './fragments';
-
-const CardDragPreviewRoot = ({ children }: PropsWithChildren<{}>) => {
-  return <div className='p-2'>{children}</div>;
-};
-
-const CardDragPreviewContent = ({ children }: PropsWithChildren<{}>) => {
-  return <div className={mx(cardRoot, 'ring-focusLine ring-neutralFocusIndicator')}>{children}</div>;
-};
-
-export const CardDragPreview = {
-  Root: CardDragPreviewRoot,
-  Content: CardDragPreviewContent,
-};

package/src/exemplars/Card/fragments.ts

@@ -1,24 +0,0 @@
-//
-// Copyright 2025 DXOS.org
-//
-
-export const cardRoot =
-  'rounded overflow-hidden bg-cardSurface border border-separator dark:border-subduedSeparator dx-focus-ring-group-y-indicator relative min-bs-[--rail-item] group/card';
-
-export const cardSpacing = 'pli-cardSpacingInline mlb-cardSpacingBlock';
-export const cardNoSpacing = 'pli-0 mlb-0';
-export const labelSpacing = 'mbs-inputSpacingBlock mbe-labelSpacingBlock';
-
-export const cardDialogContent = 'p-0 bs-content min-bs-[8rem] max-bs-full md:max-is-[32rem] overflow-hidden';
-export const cardDialogHeader = 'pli-cardSpacingInline mbs-cardSpacingBlock flex justify-between';
-export const cardDialogOverflow = 'overflow-y-auto min-bs-0 flex-1';
-export const cardDialogPaddedOverflow = `${cardDialogOverflow} plb-cardSpacingBlock`;
-export const cardDialogSearchListRoot =
-  'pli-cardSpacingInline pbs-cardSpacingBlock [&>input]:mbe-0 min-bs-0 flex-1 flex flex-col';
-
-export const cardText = cardSpacing;
-
-export const cardHeading = 'text-lg font-medium line-clamp-2 grow';
-
-export const cardChrome =
-  'pli-[--dx-cardSpacingChrome] mlb-[--dx-cardSpacingChrome] [&_.dx-button]:text-start [&_.dx-button]:is-full';

package/src/exemplars/Card/index.ts

@@ -1,7 +0,0 @@
-//
-// Copyright 2023 DXOS.org
-//
-
-export * from './Card';
-export * from './CardDragPreview';
-export * from './fragments';

package/src/exemplars/CardStack/CardStack.stories.tsx

@@ -1,173 +0,0 @@
-//
-// Copyright 2025 DXOS.org
-//
-
-import '@dxos-theme';
-
-import { type Edge } from '@atlaskit/pragmatic-drag-and-drop-hitbox/closest-edge';
-import { type Meta, type StoryObj } from '@storybook/react-vite';
-import React, { useCallback, useState } from 'react';
-
-import { faker } from '@dxos/random';
-import { IconButton } from '@dxos/react-ui';
-import { withLayout, withTheme } from '@dxos/storybook-utils';
-
-import { StackItem } from '../../components';
-import { Card, CardDragPreview } from '../Card';
-
-import { CardStack } from './CardStack';
-
-// Set a seed for reproducible random values
-faker.seed(0);
-
-type CardItem = {
-  id: string;
-  title: string;
-  description: string;
-  image: string;
-};
-
-type StackItemData = {
-  id: string;
-  type?: 'column' | 'card';
-};
-
-const CardStackStory = () => {
-  const [column, setColumn] = useState<CardItem[]>(
-    faker.helpers.multiple(
-      () => ({
-        id: faker.string.uuid(),
-        title: faker.commerce.productName(),
-        description: faker.lorem.paragraph(),
-        image: faker.image.url(),
-      }),
-      { count: 12 },
-    ),
-  );
-
-  const handleRearrange = useCallback((source: StackItemData, target: StackItemData, closestEdge: Edge | null) => {
-    setColumn((prevColumn) => {
-      const newColumns = [...prevColumn];
-      // Reordering cards within a column
-      const sourceCardIndex = prevColumn.findIndex((card) => card.id === source.id);
-      const targetCardIndex = prevColumn.findIndex((card) => card.id === target.id);
-
-      if (typeof sourceCardIndex === 'number' && typeof targetCardIndex === 'number') {
-        const [movedCard] = newColumns.splice(sourceCardIndex, 1);
-
-        let insertIndex;
-        if (sourceCardIndex < targetCardIndex) {
-          insertIndex = closestEdge === 'bottom' ? targetCardIndex : targetCardIndex - 1;
-        } else {
-          insertIndex = closestEdge === 'bottom' ? targetCardIndex + 1 : targetCardIndex;
-        }
-        newColumns.splice(insertIndex, 0, movedCard);
-      }
-      return newColumns;
-    });
-  }, []);
-
-  const handleAddCard = useCallback(() => {
-    setColumn((prevColumn) => {
-      const newColumn = [...prevColumn];
-      const newCard = {
-        id: faker.string.uuid(),
-        title: faker.commerce.productName(),
-        description: faker.lorem.paragraph(),
-        image: faker.image.url(),
-      } satisfies CardItem;
-      newColumn.push(newCard);
-      console.log('[add card]', prevColumn.length, newColumn.length);
-      return newColumn;
-    });
-  }, []);
-
-  const handleRemoveCard = useCallback((cardId: string) => {
-    setColumn((prevColumn) => {
-      const newColumn = [...prevColumn];
-
-      const cardIndex = prevColumn.findIndex((card) => card.id === cardId);
-      if (cardIndex !== -1) {
-        newColumn.splice(cardIndex, 1);
-      }
-
-      return newColumn;
-    });
-  }, []);
-
-  return (
-    <CardStack.Root classNames='is-96'>
-      <CardStack.Content>
-        <CardStack.Stack id='story column' onRearrange={handleRearrange} itemsCount={column.length}>
-          {column.map((card, cardIndex, cardsArray) => {
-            const cardItem = { id: card.id, type: 'card' as const };
-            const prevCardId = cardIndex > 0 ? cardsArray[cardIndex - 1].id : undefined;
-            const nextCardId = cardIndex < cardsArray.length - 1 ? cardsArray[cardIndex + 1].id : undefined;
-
-            return (
-              <CardStack.Item asChild key={card.id}>
-                <StackItem.Root
-                  item={cardItem}
-                  focusIndicatorVariant='group'
-                  prevSiblingId={prevCardId}
-                  nextSiblingId={nextCardId}
-                >
-                  <Card.StaticRoot>
-                    <Card.Toolbar>
-                      <StackItem.DragHandle asChild>
-                        <Card.DragHandle toolbarItem />
-                      </StackItem.DragHandle>
-                      <Card.ToolbarSeparator variant='gap' />
-                      <Card.ToolbarIconButton
-                        iconOnly
-                        variant='ghost'
-                        icon='ph--x--regular'
-                        label='Remove card'
-                        onClick={() => handleRemoveCard(card.id)}
-                      />
-                    </Card.Toolbar>
-                    <Card.Poster alt={card.title} image={card.image} />
-                    <Card.Heading>{card.title}</Card.Heading>
-                    <Card.Text classNames='line-clamp-2'>{card.description}</Card.Text>
-                  </Card.StaticRoot>
-                  <StackItem.DragPreview>
-                    {({ item }) => (
-                      <CardDragPreview.Root>
-                        <CardDragPreview.Content>
-                          <Card.Toolbar>
-                            <Card.DragHandle toolbarItem />
-                          </Card.Toolbar>
-                          <Card.Poster alt={card.title} image={card.image} />
-                          <Card.Heading>{card.title}</Card.Heading>
-                          <Card.Text classNames='line-clamp-2'>{card.description}</Card.Text>
-                        </CardDragPreview.Content>
-                      </CardDragPreview.Root>
-                    )}
-                  </StackItem.DragPreview>
-                </StackItem.Root>
-              </CardStack.Item>
-            );
-          })}
-        </CardStack.Stack>
-
-        <CardStack.Footer>
-          <IconButton icon='ph--plus--regular' label='Add card' onClick={handleAddCard} classNames='is-full' />
-        </CardStack.Footer>
-
-        <CardStack.Heading>{faker.company.name()}</CardStack.Heading>
-      </CardStack.Content>
-    </CardStack.Root>
-  );
-};
-
-const meta: Meta<typeof CardStackStory> = {
-  title: 'ui/react-ui-stack/CardStack',
-  component: CardStackStory,
-  decorators: [withTheme, withLayout({ fullscreen: true })],
-};
-
-export default meta;
-
-type Story = StoryObj<typeof CardStackStory>;
-
-export const Default: Story = {};