@dxos/plugin-preview 0.8.4-main.28f8d3d → 0.8.4-main.406dc2a

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dxos/plugin-preview",
-  "version": "0.8.4-main.28f8d3d",
+  "version": "0.8.4-main.406dc2a",
   "description": "Preview plugin",
   "homepage": "https://dxos.org",
   "bugs": "https://github.com/dxos/dxos/issues",
@@ -24,40 +24,43 @@
     "src"
   ],
   "dependencies": {
+    "@effect-rx/rx-react": "0.42.4",
     "@preact-signals/safe-react": "^0.9.0",
-    "@dxos/app-framework": "0.8.4-main.28f8d3d",
-    "@dxos/async": "0.8.4-main.28f8d3d",
-    "@dxos/client": "0.8.4-main.28f8d3d",
-    "@dxos/echo": "0.8.4-main.28f8d3d",
-    "@dxos/keys": "0.8.4-main.28f8d3d",
-    "@dxos/lit-ui": "0.8.4-main.28f8d3d",
-    "@dxos/log": "0.8.4-main.28f8d3d",
-    "@dxos/echo-schema": "0.8.4-main.28f8d3d",
-    "@dxos/plugin-attention": "0.8.4-main.28f8d3d",
-    "@dxos/plugin-client": "0.8.4-main.28f8d3d",
-    "@dxos/react-client": "0.8.4-main.28f8d3d",
-    "@dxos/react-ui": "0.8.4-main.28f8d3d",
-    "@dxos/plugin-deck": "0.8.4-main.28f8d3d",
-    "@dxos/react-ui-editor": "0.8.4-main.28f8d3d",
-    "@dxos/react-ui-form": "0.8.4-main.28f8d3d",
-    "@dxos/react-ui-theme": "0.8.4-main.28f8d3d",
-    "@dxos/react-ui-stack": "0.8.4-main.28f8d3d",
-    "@dxos/schema": "0.8.4-main.28f8d3d",
-    "@dxos/react-ui-table": "0.8.4-main.28f8d3d",
-    "@dxos/util": "0.8.4-main.28f8d3d"
+    "@dxos/async": "0.8.4-main.406dc2a",
+    "@dxos/app-framework": "0.8.4-main.406dc2a",
+    "@dxos/client": "0.8.4-main.406dc2a",
+    "@dxos/echo": "0.8.4-main.406dc2a",
+    "@dxos/app-graph": "0.8.4-main.406dc2a",
+    "@dxos/keys": "0.8.4-main.406dc2a",
+    "@dxos/log": "0.8.4-main.406dc2a",
+    "@dxos/plugin-attention": "0.8.4-main.406dc2a",
+    "@dxos/lit-ui": "0.8.4-main.406dc2a",
+    "@dxos/plugin-client": "0.8.4-main.406dc2a",
+    "@dxos/plugin-deck": "0.8.4-main.406dc2a",
+    "@dxos/plugin-space": "0.8.4-main.406dc2a",
+    "@dxos/react-ui": "0.8.4-main.406dc2a",
+    "@dxos/react-client": "0.8.4-main.406dc2a",
+    "@dxos/react-ui-editor": "0.8.4-main.406dc2a",
+    "@dxos/react-ui-form": "0.8.4-main.406dc2a",
+    "@dxos/react-ui-menu": "0.8.4-main.406dc2a",
+    "@dxos/react-ui-table": "0.8.4-main.406dc2a",
+    "@dxos/react-ui-theme": "0.8.4-main.406dc2a",
+    "@dxos/schema": "0.8.4-main.406dc2a",
+    "@dxos/util": "0.8.4-main.406dc2a",
+    "@dxos/react-ui-stack": "0.8.4-main.406dc2a"
   },
   "devDependencies": {
-    "effect": "3.17.7",
-    "react": "~18.2.0",
-    "react-dom": "~18.2.0",
-    "vite": "5.4.7",
-    "@dxos/random": "0.8.4-main.28f8d3d",
-    "@dxos/storybook-utils": "0.8.4-main.28f8d3d"
+    "effect": "3.18.3",
+    "react": "~19.2.0",
+    "react-dom": "~19.2.0",
+    "vite": "7.1.9",
+    "@dxos/storybook-utils": "0.8.4-main.406dc2a",
+    "@dxos/random": "0.8.4-main.406dc2a"
   },
   "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

@@ -10,26 +10,25 @@ 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, [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,
+  }),
+]);

package/src/capabilities/preview-popover.ts

@@ -4,12 +4,12 @@
 
 import { Capabilities, LayoutAction, type PluginContext, contributes, createIntent } from '@dxos/app-framework';
 import { addEventListener } from '@dxos/async';
-import { type Client, resolveRef } from '@dxos/client';
+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.ref(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 handleDxAnchorActivate = 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,
+      handleDxAnchorActivate,
       customEventOptions,
     );
   } else {

package/src/capabilities/react-surface.tsx

@@ -2,7 +2,6 @@
 // Copyright 2025 DXOS.org
 //
 
-import { Effect } from 'effect';
 import React, { useCallback } from 'react';
 
 import {
@@ -15,20 +14,18 @@ import {
   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 { Obj } from '@dxos/echo';
+import { type JsonPath, setValue } from '@dxos/echo/internal';
+import { useActiveSpace } from '@dxos/plugin-space';
 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 { DataType, type ProjectionModel } from '@dxos/schema';
 
 import { ContactCard, OrganizationCard, ProjectCard } from '../components';
-import { PREVIEW_PLUGIN } from '../meta';
+import { TaskCard } from '../components/TaskCard';
+import { meta } from '../meta';
 
 export default () =>
   contributes(Capabilities.ReactSurface, [
@@ -36,103 +33,76 @@ export default () =>
     // Specific schema types.
     //
     createSurface({
-      id: `${PREVIEW_PLUGIN}/schema-popover--contact`,
+      id: `${meta.id}/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),
       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),
-        );
-
-        // TODO(wittjosiah): Generalized way of handling related objects navigation.
+        const activeSpace = useActiveSpace();
         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],
+            dispatch(
+              createIntent(LayoutAction.Open, {
+                part: 'main',
+                subject: [fullyQualifiedId(org)],
+                options: {
+                  workspace: space?.id,
+                },
+              }),
+            ),
+          [dispatch],
         );
 
         return (
-          <ContactCard role={role} subject={data.subject} onOrgClick={handleOrgClick}>
+          <ContactCard role={role} subject={data.subject} activeSpace={activeSpace} onOrgClick={handleOrgClick}>
             {role === 'card--popover' && <Surface role='related' data={data} />}
           </ContactCard>
         );
       },
     }),
     createSurface({
-      id: `${PREVIEW_PLUGIN}/schema-popover--organization`,
+      id: `${meta.id}/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>
-      ),
+      component: ({ data, role }) => {
+        const activeSpace = useActiveSpace();
+
+        return (
+          <OrganizationCard role={role} subject={data.subject} activeSpace={activeSpace}>
+            {role === 'card--popover' && <Surface role='related' data={data} />}
+          </OrganizationCard>
+        );
+      },
     }),
     createSurface({
-      id: `${PREVIEW_PLUGIN}/schema-popover--project`,
+      id: `${meta.id}/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} />,
+      component: ({ data, role }) => {
+        const activeSpace = useActiveSpace();
+
+        return <ProjectCard subject={data.subject} role={role} activeSpace={activeSpace} />;
+      },
+    }),
+    createSurface({
+      id: `${meta.id}/schema-popover--task`,
+      role: ['card--popover', 'card--intrinsic', 'card--transclusion', 'card--extrinsic', 'card'],
+      filter: (data): data is { subject: DataType.Task } => Obj.instanceOf(DataType.Task, data.subject),
+      component: ({ data, role }) => <TaskCard subject={data.subject} role={role} />,
     }),
 
     //
     // Fallback for any object.
     //
     createSurface({
-      id: `${PREVIEW_PLUGIN}/fallback-popover`,
+      id: `${meta.id}/fallback-popover`,
       role: ['card--popover', 'card--intrinsic', 'card--transclusion', 'card--extrinsic', 'card'],
       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);
+        const { t } = useTranslation(meta.id);
         if (!schema) {
           // TODO(burdon): Use Alert.
           return <p className={mx(descriptionMessage)}>{t('unable to create preview message')}</p>;
@@ -150,8 +120,9 @@ export default () =>
           <Card.SurfaceRoot role={role}>
             <Form
               schema={schema}
+              projection={data.projection}
               values={data.subject}
-              readonly={role === 'card--popover'}
+              readonly={role === 'card--popover' ? 'static' : false}
               onSave={handleSave}
               autoSave
               {...(role === 'card--intrinsic' && { outerSpacing: 'blockStart-0' })}

package/src/components/CardSubjectMenu.tsx

@@ -0,0 +1,82 @@
+//
+// Copyright 2025 DXOS.org
+//
+
+import { Rx } from '@effect-rx/rx-react';
+import React from 'react';
+
+import { LayoutAction, createIntent, useIntentDispatcher } from '@dxos/app-framework';
+import { ACTION_TYPE } from '@dxos/app-graph';
+import { Obj } from '@dxos/echo';
+import { SpaceAction } from '@dxos/plugin-space/types';
+import { type Space, fullyQualifiedId } from '@dxos/react-client/echo';
+import { IconButton, type IconButtonProps, useTranslation } from '@dxos/react-ui';
+import { type ActionGraphProps, DropdownMenu, MenuProvider, useMenuActions } from '@dxos/react-ui-menu';
+
+import { meta } from '../meta';
+
+const useSubjectMenuGroupItems = (subject: Obj.Any, activeSpace?: Space) => {
+  const { dispatchPromise: dispatch } = useIntentDispatcher();
+  const result: ActionGraphProps = { edges: [], nodes: [] };
+
+  result.nodes.push({
+    type: ACTION_TYPE,
+    id: `${subject.id}/open`,
+    data: () => dispatch(createIntent(LayoutAction.Open, { part: 'main', subject: [fullyQualifiedId(subject)] })),
+    properties: {
+      label: ['open object label', { ns: meta.id }],
+      icon: 'ph--arrow-right--regular',
+    },
+  });
+
+  if (activeSpace && Obj.getDXN(subject).asQueueDXN()) {
+    result.nodes.push({
+      type: ACTION_TYPE,
+      id: `${subject.id}/add-to-space`,
+      // TODO(wittjosiah): Update reference to point to db object when adding?
+      data: () => dispatch(createIntent(SpaceAction.AddObject, { object: subject, target: activeSpace, hidden: true })),
+      properties: {
+        label: ['add object to space label', { ns: meta.id }],
+        icon: 'ph--file-plus--regular',
+      },
+    });
+  }
+
+  result.nodes.forEach(({ id: target }) => {
+    result.edges.push({ source: 'root', target });
+  });
+
+  return useMenuActions(Rx.make(result));
+};
+
+/**
+ * This is a generic menu for objects that tries to infer common actions.
+ */
+export const CardSubjectMenu = ({
+  subject,
+  activeSpace,
+  ...props
+}: Omit<IconButtonProps, 'icon' | 'label'> & { subject: Obj.Any; activeSpace?: Space }) => {
+  const { t } = useTranslation(meta.id);
+  const menuProps = useSubjectMenuGroupItems(subject, activeSpace);
+
+  if (!activeSpace) {
+    return null;
+  }
+
+  return (
+    <MenuProvider {...menuProps}>
+      <DropdownMenu.Root>
+        <DropdownMenu.Trigger asChild>
+          <IconButton
+            iconOnly
+            variant='ghost'
+            icon='ph--dots-three-vertical--bold'
+            label={t('more options label')}
+            {...props}
+          />
+        </DropdownMenu.Trigger>
+      </DropdownMenu.Root>
+    </MenuProvider>
+  );
+};

package/src/components/ContactCard.tsx

@@ -11,22 +11,27 @@ import { type DataType } from '@dxos/schema';
 
 import { type PreviewProps } from '../types';
 
+import { CardSubjectMenu } from './CardSubjectMenu';
+
 export const ContactCard = ({
   children,
-  subject: { fullName, image, organization, emails },
+  subject,
+  activeSpace,
   onOrgClick,
   role,
 }: PreviewProps<DataType.Person> & { onOrgClick?: (org: DataType.Organization) => void }) => {
+  const { fullName, image, organization, emails } = subject;
   const organizationName = organization && typeof organization === 'object' ? organization.target?.name : organization;
   return (
     <Card.SurfaceRoot role={role}>
       <Avatar.Root>
         <Card.Text role='group' classNames='grid gap-3 grid-cols-[min-content_1fr]'>
           <Avatar.Content imgSrc={image} icon='ph--user--regular' size={16} hue='neutral' />
-          <div role='none' className='bs-min self-center'>
+          <div role='none' className='bs-min self-center flex items-center'>
             <Avatar.Label asChild>
-              <h2 className={cardHeading}>{fullName}</h2>
+              <h2 className={mx(cardHeading, 'grow')}>{fullName}</h2>
             </Avatar.Label>
+            <CardSubjectMenu subject={subject} activeSpace={activeSpace} />
           </div>
         </Card.Text>
       </Avatar.Root>
@@ -57,6 +62,7 @@ export const ContactCard = ({
             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='break-words'>

package/src/components/OrganizationCard.tsx

@@ -5,20 +5,23 @@
 import React from 'react';
 
 import { Icon } from '@dxos/react-ui';
-import { Card } from '@dxos/react-ui-stack';
+import { Card, cardNoSpacing, cardSpacing } from '@dxos/react-ui-stack';
+import { mx } from '@dxos/react-ui-theme';
 import { type DataType } from '@dxos/schema';
 
 import { type PreviewProps } from '../types';
 
-export const OrganizationCard = ({
-  children,
-  subject: { name, image, description, website },
-  role,
-}: PreviewProps<DataType.Organization>) => {
+import { CardSubjectMenu } from './CardSubjectMenu';
+
+export const OrganizationCard = ({ children, subject, role, activeSpace }: PreviewProps<DataType.Organization>) => {
+  const { name, image, description, website } = subject;
   return (
     <Card.SurfaceRoot role={role}>
       <Card.Poster alt={name!} {...(image ? { image } : { icon: 'ph--building-office--regular' })} />
-      <Card.Heading>{name}</Card.Heading>
+      <div role='none' className={mx('flex items-center gap-2', cardSpacing)}>
+        <Card.Heading classNames={cardNoSpacing}>{name}</Card.Heading>
+        <CardSubjectMenu subject={subject} activeSpace={activeSpace} />
+      </div>
       {description && <Card.Text classNames='line-clamp-2'>{description}</Card.Text>}
       {website && (
         <Card.Chrome>
@@ -30,7 +33,7 @@ export const OrganizationCard = ({
             rel='noreferrer'
           >
             <Icon icon='ph--link--regular' size={5} classNames='text-subdued' />
-            <span className='grow'>{website}</span>
+            <span className='min-is-0 flex-1 truncate'>{website}</span>
             <Icon icon='ph--arrow-square-out--regular' />
           </a>
         </Card.Chrome>

package/src/components/ProjectCard.tsx

@@ -4,16 +4,24 @@
 
 import React from 'react';
 
-import { Card } from '@dxos/react-ui-stack';
+import { Obj } from '@dxos/echo';
+import { Card, cardNoSpacing, cardSpacing } from '@dxos/react-ui-stack';
+import { mx } from '@dxos/react-ui-theme';
 import { type DataType } from '@dxos/schema';
 
 import { type PreviewProps } from '../types';
 
-export const ProjectCard = ({ subject: { name, image, description }, role }: PreviewProps<DataType.Project>) => {
+import { CardSubjectMenu } from './CardSubjectMenu';
+
+export const ProjectCard = ({ subject, role, activeSpace }: PreviewProps<DataType.Project>) => {
+  const { name, image, description } = subject;
   return (
     <Card.SurfaceRoot role={role}>
-      {image && <Card.Poster image={image} alt={name} aspect='auto' />}
-      <Card.Heading>{name}</Card.Heading>
+      {image && <Card.Poster image={image} alt={Obj.getLabel(subject) ?? ''} aspect='auto' />}
+      <div role='none' className={mx('flex items-center gap-2', cardSpacing)}>
+        <Card.Heading classNames={cardNoSpacing}>{name}</Card.Heading>
+        <CardSubjectMenu subject={subject} activeSpace={activeSpace} />
+      </div>
       {description && <Card.Text classNames='line-clamp-2'>{description}</Card.Text>}
     </Card.SurfaceRoot>
   );

package/src/components/TaskCard.tsx

@@ -0,0 +1,46 @@
+//
+// Copyright 2025 DXOS.org
+//
+
+import * as SchemaAST from 'effect/SchemaAST';
+import React from 'react';
+
+import { type PropertyMetaAnnotation, PropertyMetaAnnotationId } from '@dxos/echo/internal';
+import { Card, cardNoSpacing, cardSpacing } from '@dxos/react-ui-stack';
+import { mx } from '@dxos/react-ui-theme';
+import { DataType } from '@dxos/schema';
+
+import { type PreviewProps } from '../types';
+
+import { CardSubjectMenu } from './CardSubjectMenu';
+
+// TODO(thure): Should this move upstream as a helper? Is there an easier way to get options?
+const getActiveStatusOption = (status?: string) => {
+  const properties = SchemaAST.getPropertySignatures(DataType.Task.ast);
+  const statusProperty = properties.find((p) => p.name === 'status');
+  const statusMeta = SchemaAST.getAnnotation<PropertyMetaAnnotation>(PropertyMetaAnnotationId)(
+    // TODO(thure): Typescript asserts `.type` doesn’t have `.types`, but in runtime it does.
+    (statusProperty!.type as any).types[0],
+  );
+  const options = // TODO(thure): Typescript asserts `statusMeta` doesn’t have `.value`, but in runtime it does.
+    (statusMeta as any).value.singleSelect.options as { id: string; title: string; color: string }[];
+  return options.find(({ id }) => id === status);
+};
+
+export const TaskCard = ({ subject, role, activeSpace }: PreviewProps<DataType.Task>) => {
+  const { title, status } = subject;
+  const statusOption = getActiveStatusOption(status);
+  return (
+    <Card.SurfaceRoot role={role}>
+      <div role='none' className={mx('flex items-center gap-2', cardSpacing)}>
+        <Card.Heading classNames={[cardNoSpacing, 'min-is-0 flex-1 truncate']}>{title}</Card.Heading>
+        {statusOption && (
+          <span className='dx-tag' data-hue={statusOption.color}>
+            {statusOption.title}
+          </span>
+        )}
+        <CardSubjectMenu subject={subject} activeSpace={activeSpace} />
+      </div>
+    </Card.SurfaceRoot>
+  );
+};

package/src/meta.ts

@@ -4,10 +4,8 @@
 
 import { type PluginMeta } from '@dxos/app-framework';
 
-export const PREVIEW_PLUGIN = 'dxos.org/plugin/preview';
-
 export const meta: PluginMeta = {
-  id: PREVIEW_PLUGIN,
+  id: 'dxos.org/plugin/preview',
   name: 'Preview',
   icon: 'ph--eye--regular',
   source: 'https://github.com/dxos/dxos/tree/main/packages/plugins/plugin-preview',