@dxos/plugin-preview 0.8.4-main.2e9d522 → 0.8.4-main.3c1ae3b

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dxos/plugin-preview",
-  "version": "0.8.4-main.2e9d522",
+  "version": "0.8.4-main.3c1ae3b",
   "description": "Preview plugin",
   "homepage": "https://dxos.org",
   "bugs": "https://github.com/dxos/dxos/issues",
@@ -10,6 +10,7 @@
   "type": "module",
   "exports": {
     ".": {
+      "source": "./src/index.ts",
       "types": "./dist/types/src/index.d.ts",
       "browser": "./dist/lib/browser/index.mjs"
     }
@@ -23,40 +24,44 @@
     "src"
   ],
   "dependencies": {
+    "@effect-atom/atom-react": "^0.3.4",
     "@preact-signals/safe-react": "^0.9.0",
-    "@dxos/app-framework": "0.8.4-main.2e9d522",
-    "@dxos/async": "0.8.4-main.2e9d522",
-    "@dxos/client": "0.8.4-main.2e9d522",
-    "@dxos/echo": "0.8.4-main.2e9d522",
-    "@dxos/echo-schema": "0.8.4-main.2e9d522",
-    "@dxos/keys": "0.8.4-main.2e9d522",
-    "@dxos/log": "0.8.4-main.2e9d522",
-    "@dxos/lit-ui": "0.8.4-main.2e9d522",
-    "@dxos/plugin-attention": "0.8.4-main.2e9d522",
-    "@dxos/plugin-client": "0.8.4-main.2e9d522",
-    "@dxos/plugin-deck": "0.8.4-main.2e9d522",
-    "@dxos/react-client": "0.8.4-main.2e9d522",
-    "@dxos/react-ui": "0.8.4-main.2e9d522",
-    "@dxos/react-ui-form": "0.8.4-main.2e9d522",
-    "@dxos/react-ui-stack": "0.8.4-main.2e9d522",
-    "@dxos/react-ui-editor": "0.8.4-main.2e9d522",
-    "@dxos/react-ui-table": "0.8.4-main.2e9d522",
-    "@dxos/react-ui-theme": "0.8.4-main.2e9d522",
-    "@dxos/schema": "0.8.4-main.2e9d522",
-    "@dxos/util": "0.8.4-main.2e9d522"
+    "@dxos/app-graph": "0.8.4-main.3c1ae3b",
+    "@dxos/app-framework": "0.8.4-main.3c1ae3b",
+    "@dxos/async": "0.8.4-main.3c1ae3b",
+    "@dxos/lit-ui": "0.8.4-main.3c1ae3b",
+    "@dxos/echo": "0.8.4-main.3c1ae3b",
+    "@dxos/client": "0.8.4-main.3c1ae3b",
+    "@dxos/keys": "0.8.4-main.3c1ae3b",
+    "@dxos/log": "0.8.4-main.3c1ae3b",
+    "@dxos/plugin-attention": "0.8.4-main.3c1ae3b",
+    "@dxos/plugin-client": "0.8.4-main.3c1ae3b",
+    "@dxos/plugin-space": "0.8.4-main.3c1ae3b",
+    "@dxos/react-ui": "0.8.4-main.3c1ae3b",
+    "@dxos/react-ui-editor": "0.8.4-main.3c1ae3b",
+    "@dxos/react-client": "0.8.4-main.3c1ae3b",
+    "@dxos/plugin-deck": "0.8.4-main.3c1ae3b",
+    "@dxos/react-ui-menu": "0.8.4-main.3c1ae3b",
+    "@dxos/react-ui-stack": "0.8.4-main.3c1ae3b",
+    "@dxos/react-ui-form": "0.8.4-main.3c1ae3b",
+    "@dxos/react-ui-table": "0.8.4-main.3c1ae3b",
+    "@dxos/react-ui-theme": "0.8.4-main.3c1ae3b",
+    "@dxos/schema": "0.8.4-main.3c1ae3b",
+    "@dxos/types": "0.8.4-main.3c1ae3b",
+    "@dxos/util": "0.8.4-main.3c1ae3b"
   },
   "devDependencies": {
-    "effect": "3.17.0",
-    "react": "~18.2.0",
-    "react-dom": "~18.2.0",
-    "vite": "5.4.7",
-    "@dxos/random": "0.8.4-main.2e9d522",
-    "@dxos/storybook-utils": "0.8.4-main.2e9d522"
+    "effect": "3.18.3",
+    "react": "~19.2.0",
+    "react-dom": "~19.2.0",
+    "vite": "7.1.9",
+    "@dxos/random": "0.8.4-main.3c1ae3b",
+    "@dxos/storybook-utils": "0.8.4-main.3c1ae3b"
   },
   "peerDependencies": {
     "effect": "^3.13.3",
-    "react": "~18.2.0",
-    "react-dom": "~18.2.0"
+    "react": "^19.0.0",
+    "react-dom": "^19.0.0"
   },
   "publishConfig": {
     "access": "public"

package/src/PreviewPlugin.tsx

@@ -4,32 +4,31 @@
 
 import { Capabilities, Events, contributes, defineModule, definePlugin } from '@dxos/app-framework';
 import { ClientCapabilities, ClientEvents } from '@dxos/plugin-client';
-import { DataType } from '@dxos/schema';
+import { Organization, Person } from '@dxos/types';
 
 import { PreviewPopover, ReactSurface } from './capabilities';
 import { meta } from './meta';
 import { translations } from './translations';
 
-export const PreviewPlugin = () =>
-  definePlugin(meta, [
-    defineModule({
-      id: `${meta.id}/module/translations`,
-      activatesOn: Events.SetupTranslations,
-      activate: () => contributes(Capabilities.Translations, translations),
-    }),
-    defineModule({
-      id: `${meta.id}/module/schema`,
-      activatesOn: ClientEvents.SetupSchema,
-      activate: () => [contributes(ClientCapabilities.Schema, [DataType.Person, DataType.Organization])],
-    }),
-    defineModule({
-      id: `${meta.id}/module/preview-popover`,
-      activatesOn: Events.Startup,
-      activate: PreviewPopover,
-    }),
-    defineModule({
-      id: `${meta.id}/module/react-surface`,
-      activatesOn: Events.SetupReactSurface,
-      activate: ReactSurface,
-    }),
-  ]);
+export const PreviewPlugin = definePlugin(meta, () => [
+  defineModule({
+    id: `${meta.id}/module/translations`,
+    activatesOn: Events.SetupTranslations,
+    activate: () => contributes(Capabilities.Translations, translations),
+  }),
+  defineModule({
+    id: `${meta.id}/module/schema`,
+    activatesOn: ClientEvents.SetupSchema,
+    activate: () => [contributes(ClientCapabilities.Schema, [Person.Person, Organization.Organization])],
+  }),
+  defineModule({
+    id: `${meta.id}/module/preview-popover`,
+    activatesOn: Events.Startup,
+    activate: PreviewPopover,
+  }),
+  defineModule({
+    id: `${meta.id}/module/react-surface`,
+    activatesOn: Events.SetupReactSurface,
+    activate: ReactSurface,
+  }),
+]);

package/src/capabilities/preview-popover.ts

@@ -2,14 +2,14 @@
 // Copyright 2025 DXOS.org
 //
 
-import { Capabilities, LayoutAction, contributes, createIntent, type PluginContext } from '@dxos/app-framework';
+import { Capabilities, LayoutAction, type PluginContext, contributes, createIntent } from '@dxos/app-framework';
 import { addEventListener } from '@dxos/async';
-import { type Client, resolveRef } from '@dxos/client';
-import { parseId, type Space } from '@dxos/client/echo';
+import { type Client } from '@dxos/client';
+import { type Space, parseId } from '@dxos/client/echo';
 import { DXN } from '@dxos/keys';
-import { type DxRefTagActivate } from '@dxos/lit-ui';
 import { log } from '@dxos/log';
 import { ClientCapabilities } from '@dxos/plugin-client';
+import { DX_ANCHOR_ACTIVATE, type DxAnchorActivate } from '@dxos/react-ui';
 import { type PreviewLinkRef, type PreviewLinkTarget } from '@dxos/react-ui-editor';
 
 const customEventOptions = { capture: true, passive: false };
@@ -20,21 +20,16 @@ const handlePreviewLookup = async (
   { ref, label }: PreviewLinkRef,
 ): Promise<PreviewLinkTarget | null> => {
   try {
-    const dxn = DXN.parse(ref);
-    if (!dxn) {
-      return null;
-    }
-
-    const object = await resolveRef(client, dxn, defaultSpace);
+    const object = await defaultSpace.db.makeRef(DXN.parse(ref)).load();
     return { label, object };
-  } catch (err) {
+  } catch {
     return null;
   }
 };
 
 export default (context: PluginContext) => {
   // TODO(wittjosiah): Factor out lookup handlers to other plugins to make not ECHO-specific.
-  const handleDxRefTagActivate = async ({ refId, label, trigger }: DxRefTagActivate) => {
+  const handleAnchorActivate = async ({ refId, label, trigger }: DxAnchorActivate) => {
     const { dispatchPromise: dispatch } = context.getCapability(Capabilities.IntentDispatcher);
     const client = context.getCapability(ClientCapabilities.Client);
     const [layout] = context.getCapabilities(Capabilities.Layout);
@@ -62,8 +57,8 @@ export default (context: PluginContext) => {
   if (document.defaultView) {
     cleanup = addEventListener(
       document.defaultView,
-      'dx-ref-tag-activate' as any,
-      handleDxRefTagActivate,
+      DX_ANCHOR_ACTIVATE as any,
+      handleAnchorActivate,
       customEventOptions,
     );
   } else {

package/src/capabilities/react-surface.tsx

@@ -2,161 +2,120 @@
 // Copyright 2025 DXOS.org
 //
 
-import { Effect } from 'effect';
 import React, { useCallback } from 'react';
 
-import {
-  Capabilities,
-  LayoutAction,
-  Surface,
-  contributes,
-  createIntent,
-  createSurface,
-  useIntentDispatcher,
-} from '@dxos/app-framework';
-import { fullyQualifiedId, getSchema, getSpace } from '@dxos/client/echo';
-import { Filter, Obj } from '@dxos/echo';
-import { type JsonPath, setValue } from '@dxos/echo-schema';
-import { AttentionAction } from '@dxos/plugin-attention/types';
-import { ATTENDABLE_PATH_SEPARATOR, DeckAction } from '@dxos/plugin-deck/types';
-import { useQuery, useSpace } from '@dxos/react-client/echo';
-import { useTranslation } from '@dxos/react-ui';
-import { Form } from '@dxos/react-ui-form';
-import { Card } from '@dxos/react-ui-stack';
-import { TableView } from '@dxos/react-ui-table/types';
-import { descriptionMessage, mx } from '@dxos/react-ui-theme';
-import { DataType } from '@dxos/schema';
+import { Capabilities, LayoutAction, contributes, createIntent, createSurface } from '@dxos/app-framework';
+import { Surface, SurfaceCardRole, useIntentDispatcher } from '@dxos/app-framework/react';
+import { getSpace } from '@dxos/client/echo';
+import { Obj } from '@dxos/echo';
+import { useActiveSpace } from '@dxos/plugin-space';
+import { type ProjectionModel } from '@dxos/schema';
+import { Organization, Person, Project, Task } from '@dxos/types';
 
-import { ContactCard, OrganizationCard, ProjectCard } from '../components';
-import { PREVIEW_PLUGIN } from '../meta';
+import { FormCard, OrganizationCard, PersonCard, ProjectCard, TaskCard } from '../cards';
+import { meta } from '../meta';
+import { type CardPreviewProps } from '../types';
 
 export default () =>
   contributes(Capabilities.ReactSurface, [
     //
     // Specific schema types.
+    // TODO(burdon): Create helpers and factor out.
     //
-    createSurface({
-      id: `${PREVIEW_PLUGIN}/schema-popover--contact`,
-      role: ['card--popover', 'card--intrinsic', 'card--transclusion', 'card--extrinsic', 'card'],
-      filter: (data): data is { subject: DataType.Person } => Obj.instanceOf(DataType.Person, data.subject),
+
+    // TODO(burdon): Infer Role type.
+    createSurface<{ subject: Person.Person }>({
+      id: `${meta.id}/schema-popover--contact`,
+      role: SurfaceCardRole.literals as any,
+      filter: (data): data is { subject: Person.Person } => Obj.instanceOf(Person.Person, data.subject),
       component: ({ data, role }) => {
-        const { dispatch } = useIntentDispatcher();
+        const { dispatchPromise: dispatch } = useIntentDispatcher();
         const space = getSpace(data.subject);
-        const defaultSpace = useSpace();
-
-        const currentSpaceOrgs = useQuery(space, Filter.type(DataType.Organization));
-        const currentSpaceViews = useQuery(space, Filter.type(DataType.View));
-        const defaultSpaceViews = useQuery(defaultSpace, Filter.type(DataType.View));
-        const currentSpaceOrgTable = currentSpaceViews.find(
-          (view) =>
-            view.query.typename === DataType.Organization.typename &&
-            Obj.instanceOf(TableView, view.presentation.target),
-        );
-        const defaultSpaceOrgTable = defaultSpaceViews.find(
-          (view) =>
-            view.query.typename === DataType.Organization.typename &&
-            Obj.instanceOf(TableView, view.presentation.target),
+        const activeSpace = useActiveSpace(); // TODO(burdon): Disambiguate with space?
+        const handleSelect = useCallback<NonNullable<CardPreviewProps['onSelect']>>(
+          (object) =>
+            dispatch(
+              createIntent(LayoutAction.Open, {
+                part: 'main',
+                subject: [Obj.getDXN(object).toString()],
+                options: {
+                  workspace: space?.id,
+                },
+              }),
+            ),
+          [dispatch],
         );
 
-        // TODO(wittjosiah): Generalized way of handling related objects navigation.
-        const handleOrgClick = useCallback(
-          (org: DataType.Organization) =>
-            Effect.gen(function* () {
-              const view = currentSpaceOrgs.includes(org) ? currentSpaceOrgTable : defaultSpaceOrgTable;
-              yield* dispatch(
-                createIntent(LayoutAction.UpdatePopover, {
-                  part: 'popover',
-                  options: {
-                    state: false,
-                    anchorId: '',
-                  },
-                }),
-              );
-              if (view) {
-                const id = fullyQualifiedId(view);
-                yield* dispatch(
-                  createIntent(LayoutAction.Open, {
-                    part: 'main',
-                    subject: [id],
-                    options: { workspace: space?.id },
-                  }),
-                );
-                yield* dispatch(
-                  createIntent(DeckAction.ChangeCompanion, {
-                    primary: id,
-                    companion: [id, 'selected-objects'].join(ATTENDABLE_PATH_SEPARATOR),
-                  }),
-                );
-                yield* dispatch(
-                  createIntent(AttentionAction.Select, {
-                    contextId: id,
-                    selection: { mode: 'multi', ids: [org.id] },
-                  }),
-                );
-              }
-            }).pipe(Effect.runPromise),
-          [dispatch, currentSpaceOrgs, currentSpaceOrgTable, defaultSpaceOrgTable],
+        return (
+          <PersonCard
+            role={role as SurfaceCardRole}
+            subject={data.subject}
+            activeSpace={activeSpace}
+            onSelect={handleSelect}
+          >
+            {role === 'card--popover' && <Surface role='related' data={data} />}
+          </PersonCard>
         );
-
+      },
+    }),
+    createSurface({
+      id: `${meta.id}/schema-popover--organization`,
+      role: SurfaceCardRole.literals as any,
+      filter: (data): data is { subject: Organization.Organization } =>
+        Obj.instanceOf(Organization.Organization, data.subject),
+      component: ({ data, role }) => {
+        const activeSpace = useActiveSpace();
         return (
-          <ContactCard role={role} subject={data.subject} onOrgClick={handleOrgClick}>
+          <OrganizationCard role={role as SurfaceCardRole} subject={data.subject} activeSpace={activeSpace}>
             {role === 'card--popover' && <Surface role='related' data={data} />}
-          </ContactCard>
+          </OrganizationCard>
         );
       },
     }),
     createSurface({
-      id: `${PREVIEW_PLUGIN}/schema-popover--organization`,
-      role: ['card--popover', 'card--intrinsic', 'card--transclusion', 'card--extrinsic', 'card'],
-      filter: (data): data is { subject: DataType.Organization } => Obj.instanceOf(DataType.Organization, data.subject),
-      component: ({ data, role }) => (
-        <OrganizationCard role={role} subject={data.subject}>
-          {role === 'card--popover' && <Surface role='related' data={data} />}
-        </OrganizationCard>
-      ),
+      id: `${meta.id}/schema-popover--project`,
+      role: SurfaceCardRole.literals as any,
+      filter: (data): data is { subject: Project.Project } => Obj.instanceOf(Project.Project, data.subject),
+      component: ({ data, role }) => {
+        const activeSpace = useActiveSpace();
+        return <ProjectCard subject={data.subject} role={role as SurfaceCardRole} activeSpace={activeSpace} />;
+      },
     }),
     createSurface({
-      id: `${PREVIEW_PLUGIN}/schema-popover--project`,
-      role: ['card--popover', 'card--intrinsic', 'card--transclusion', 'card--extrinsic', 'card'],
-      filter: (data): data is { subject: DataType.Project } => Obj.instanceOf(DataType.Project, data.subject),
-      component: ({ data, role }) => <ProjectCard subject={data.subject} role={role} />,
+      id: `${meta.id}/schema-popover--task`,
+      role: SurfaceCardRole.literals as any,
+      filter: (data): data is { subject: Task.Task } => Obj.instanceOf(Task.Task, data.subject),
+      component: ({ data, role }) => {
+        return <TaskCard subject={data.subject} role={role as SurfaceCardRole} />;
+      },
     }),
 
     //
     // Fallback for any object.
     //
+
     createSurface({
-      id: `${PREVIEW_PLUGIN}/fallback-popover`,
-      role: ['card--popover', 'card--intrinsic', 'card--transclusion', 'card--extrinsic', 'card'],
+      id: `${meta.id}/fallback-popover`,
+      role: SurfaceCardRole.literals as any,
       position: 'fallback',
-      filter: (data): data is { subject: Obj.Any } => Obj.isObject(data.subject),
+      filter: (data): data is { subject: Obj.Any; projection?: ProjectionModel } => Obj.isObject(data.subject),
       component: ({ data, role }) => {
-        const schema = getSchema(data.subject);
-        const { t } = useTranslation(PREVIEW_PLUGIN);
-        if (!schema) {
-          // TODO(burdon): Use Alert.
-          return <p className={mx(descriptionMessage)}>{t('unable to create preview message')}</p>;
-        }
-
-        const handleSave = useCallback((values: any, { changed }: { changed: Record<string, boolean> }) => {
-          const changedPaths = Object.keys(changed).filter((path) => changed[path]);
-          for (const path of changedPaths) {
-            const value = values[path];
-            setValue(data.subject, path as JsonPath, value);
-          }
-        }, []);
+        return <FormCard subject={data.subject} projection={data.projection} role={role as SurfaceCardRole} />;
+      },
+    }),
 
+    createSurface({
+      id: `${meta.id}/section`,
+      role: ['section'],
+      position: 'fallback',
+      filter: (data): data is { subject: Obj.Any } => Obj.isObject(data.subject),
+      component: ({ data }) => {
         return (
-          <Card.SurfaceRoot role={role}>
-            <Form
-              schema={schema}
-              values={data.subject}
-              readonly={role === 'card--popover'}
-              onSave={handleSave}
-              autoSave
-              {...(role === 'card--intrinsic' && { outerSpacing: 'blockStart-0' })}
-            />
-          </Card.SurfaceRoot>
+          <div role='none' className='flex is-full justify-center'>
+            <div role='none' className='pbs-2 pbe-2 card-min-width card-max-width'>
+              <Surface role='card' data={data} limit={1} />
+            </div>
+          </div>
         );
       },
     }),

package/src/cards/FormCard.tsx

@@ -0,0 +1,57 @@
+//
+// Copyright 2025 DXOS.org
+//
+
+import React from 'react';
+import { useCallback } from 'react';
+
+import { Obj } from '@dxos/echo';
+import { type JsonPath, setValue } from '@dxos/echo/internal';
+import { useTranslation } from '@dxos/react-ui';
+import { Form, omitId } from '@dxos/react-ui-form';
+import { Card } from '@dxos/react-ui-stack';
+import { descriptionMessage, mx } from '@dxos/react-ui-theme';
+import { type ProjectionModel } from '@dxos/schema';
+
+import { meta } from '../meta';
+import { type CardPreviewProps } from '../types';
+
+export const FormCard = ({
+  subject,
+  projection,
+  role,
+}: CardPreviewProps<Obj.Any> & { projection?: ProjectionModel }) => {
+  const schema = Obj.getSchema(subject);
+  const { t } = useTranslation(meta.id);
+  if (!schema) {
+    // TODO(burdon): Use Alert.
+    return <p className={mx(descriptionMessage)}>{t('unable to create preview message')}</p>;
+  }
+
+  const handleSave = useCallback((values: any, { changed }: { changed: Record<string, boolean> }) => {
+    const paths = Object.keys(changed).filter((path) => changed[path]);
+    for (const path of paths) {
+      const value = values[path];
+      setValue(subject, path as JsonPath, value);
+    }
+  }, []);
+
+  return (
+    <Card.SurfaceRoot id={subject.id} role={role}>
+      <Form.Root
+        schema={omitId(schema)}
+        projection={projection}
+        values={subject}
+        layout={role === 'card--popover' ? 'static' : undefined}
+        autoSave
+        onSave={handleSave}
+      >
+        <Form.Viewport>
+          <Form.Content>
+            <Form.FieldSet />
+          </Form.Content>
+        </Form.Viewport>
+      </Form.Root>
+    </Card.SurfaceRoot>
+  );
+};

package/src/cards/OrganizationCard.tsx

@@ -0,0 +1,34 @@
+//
+// Copyright 2025 DXOS.org
+//
+
+import React from 'react';
+
+import { Card } from '@dxos/react-ui-stack';
+import { type Organization } from '@dxos/types';
+
+import { CardHeader, CardLink } from '../components';
+import { type CardPreviewProps } from '../types';
+
+export const OrganizationCard = ({
+  children,
+  subject,
+  role,
+  activeSpace,
+}: CardPreviewProps<Organization.Organization>) => {
+  const { name, image, description, website } = subject;
+
+  return (
+    <Card.SurfaceRoot id={subject.id} role={role}>
+      <Card.Poster
+        alt={name ?? ''}
+        {...(image ? { image } : { icon: 'ph--building-office--regular' })}
+        classNames={!image && 'opacity-50'}
+      />
+      <CardHeader label={name} subject={subject} activeSpace={activeSpace} />
+      {description && <Card.Text classNames='line-clamp-2'>{description}</Card.Text>}
+      {website && <CardLink label={website} href={website} />}
+      {children}
+    </Card.SurfaceRoot>
+  );
+};

package/src/cards/PersonCard.tsx

@@ -0,0 +1,63 @@
+//
+// Copyright 2025 DXOS.org
+//
+
+import React, { Fragment } from 'react';
+
+import { Avatar, Icon } from '@dxos/react-ui';
+import { Card, cardHeading, cardText } from '@dxos/react-ui-stack';
+import { mx } from '@dxos/react-ui-theme';
+import { type Person } from '@dxos/types';
+
+import { CardRow, CardSubjectMenu, gridRow } from '../components';
+import { type CardPreviewProps } from '../types';
+
+export const PersonCard = ({ children, role, subject, activeSpace, onSelect }: CardPreviewProps<Person.Person>) => {
+  const { fullName, image, organization: { target: organization } = {}, emails = [] } = subject;
+
+  return (
+    <Card.SurfaceRoot id={subject.id} role={role}>
+      <Avatar.Root>
+        <Card.Text role='group' classNames={mx('grid gap-2 grid-cols-[1fr_min-content]')}>
+          <div role='none' className={mx(gridRow, 'grid-rows-2')}>
+            {activeSpace ? <CardSubjectMenu subject={subject} activeSpace={activeSpace} /> : <div />}
+            <Avatar.Label asChild>
+              <h2 className={mx(cardHeading, 'grow truncate')}>{fullName}</h2>
+            </Avatar.Label>
+          </div>
+          <Avatar.Content
+            imgSrc={image}
+            icon='ph--user--regular'
+            size={16}
+            classNames={['text-subdued', !image && 'opacity-50']}
+            hue='neutral'
+            variant='square'
+          />
+        </Card.Text>
+      </Avatar.Root>
+      {organization?.name && (
+        <CardRow
+          icon='ph--buildings--regular'
+          label={organization.name}
+          onClick={onSelect ? () => onSelect(organization) : undefined}
+        />
+      )}
+      {emails.length > 0 && (
+        <dl className={mx(cardText, gridRow, '[&_dt]:text-subdued [&_dt]:pbs-0.5 [&_dd]:min-is-0')}>
+          {emails.map(({ label, value }) => (
+            <Fragment key={value}>
+              <dt>
+                <span className='sr-only'>{label}</span>
+                <Icon icon='ph--at--regular' size={5} />
+              </dt>
+              <dd key={value} className='col-span-2 break-words'>
+                {value}
+              </dd>
+            </Fragment>
+          ))}
+        </dl>
+      )}
+      {children}
+    </Card.SurfaceRoot>
+  );
+};

package/src/cards/ProjectCard.tsx

@@ -0,0 +1,24 @@
+//
+// Copyright 2025 DXOS.org
+//
+
+import React from 'react';
+
+import { Obj } from '@dxos/echo';
+import { Card } from '@dxos/react-ui-stack';
+import { type Project } from '@dxos/types';
+
+import { CardHeader } from '../components';
+import { type CardPreviewProps } from '../types';
+
+export const ProjectCard = ({ subject, role, activeSpace }: CardPreviewProps<Project.Project>) => {
+  const { name, image, description } = subject;
+
+  return (
+    <Card.SurfaceRoot id={subject.id} role={role}>
+      {image && <Card.Poster image={image} alt={Obj.getLabel(subject) ?? ''} aspect='auto' />}
+      <CardHeader label={name} subject={subject} activeSpace={activeSpace} />
+      {description && <Card.Text classNames='line-clamp-2'>{description}</Card.Text>}
+    </Card.SurfaceRoot>
+  );
+};