@dxos/plugin-preview 0.8.4-main.3eb6e50203 → 0.8.4-main.422d1c7879

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dxos/plugin-preview",
-  "version": "0.8.4-main.3eb6e50203",
+  "version": "0.8.4-main.422d1c7879",
   "description": "Preview plugin",
   "homepage": "https://dxos.org",
   "bugs": "https://github.com/dxos/dxos/issues",
@@ -12,6 +12,10 @@
   "author": "DXOS.org",
   "sideEffects": true,
   "type": "module",
+  "imports": {
+    "#capabilities": "./src/capabilities/index.ts",
+    "#meta": "./src/meta.ts"
+  },
   "exports": {
     ".": {
       "source": "./src/index.ts",
@@ -20,56 +24,53 @@
     }
   },
   "types": "dist/types/src/index.d.ts",
-  "typesVersions": {
-    "*": {}
-  },
   "files": [
     "dist",
     "src"
   ],
   "dependencies": {
     "@effect-atom/atom-react": "^0.5.0",
-    "@dxos/app-framework": "0.8.4-main.3eb6e50203",
-    "@dxos/app-graph": "0.8.4-main.3eb6e50203",
-    "@dxos/app-toolkit": "0.8.4-main.3eb6e50203",
-    "@dxos/client": "0.8.4-main.3eb6e50203",
-    "@dxos/async": "0.8.4-main.3eb6e50203",
-    "@dxos/echo": "0.8.4-main.3eb6e50203",
-    "@dxos/keys": "0.8.4-main.3eb6e50203",
-    "@dxos/effect": "0.8.4-main.3eb6e50203",
-    "@dxos/log": "0.8.4-main.3eb6e50203",
-    "@dxos/lit-ui": "0.8.4-main.3eb6e50203",
-    "@dxos/plugin-attention": "0.8.4-main.3eb6e50203",
-    "@dxos/operation": "0.8.4-main.3eb6e50203",
-    "@dxos/plugin-deck": "0.8.4-main.3eb6e50203",
-    "@dxos/plugin-client": "0.8.4-main.3eb6e50203",
-    "@dxos/react-ui": "0.8.4-main.3eb6e50203",
-    "@dxos/react-client": "0.8.4-main.3eb6e50203",
-    "@dxos/react-ui-form": "0.8.4-main.3eb6e50203",
-    "@dxos/react-ui-editor": "0.8.4-main.3eb6e50203",
-    "@dxos/react-ui-menu": "0.8.4-main.3eb6e50203",
-    "@dxos/react-ui-mosaic": "0.8.4-main.3eb6e50203",
-    "@dxos/react-ui-table": "0.8.4-main.3eb6e50203",
-    "@dxos/schema": "0.8.4-main.3eb6e50203",
-    "@dxos/types": "0.8.4-main.3eb6e50203",
-    "@dxos/ui-editor": "0.8.4-main.3eb6e50203",
-    "@dxos/ui-theme": "0.8.4-main.3eb6e50203",
-    "@dxos/util": "0.8.4-main.3eb6e50203",
-    "@dxos/plugin-space": "0.8.4-main.3eb6e50203"
+    "@dxos/app-framework": "0.8.4-main.422d1c7879",
+    "@dxos/async": "0.8.4-main.422d1c7879",
+    "@dxos/app-toolkit": "0.8.4-main.422d1c7879",
+    "@dxos/client": "0.8.4-main.422d1c7879",
+    "@dxos/echo": "0.8.4-main.422d1c7879",
+    "@dxos/lit-ui": "0.8.4-main.422d1c7879",
+    "@dxos/log": "0.8.4-main.422d1c7879",
+    "@dxos/effect": "0.8.4-main.422d1c7879",
+    "@dxos/keys": "0.8.4-main.422d1c7879",
+    "@dxos/operation": "0.8.4-main.422d1c7879",
+    "@dxos/plugin-attention": "0.8.4-main.422d1c7879",
+    "@dxos/plugin-client": "0.8.4-main.422d1c7879",
+    "@dxos/react-client": "0.8.4-main.422d1c7879",
+    "@dxos/react-ui": "0.8.4-main.422d1c7879",
+    "@dxos/react-ui-editor": "0.8.4-main.422d1c7879",
+    "@dxos/react-ui-form": "0.8.4-main.422d1c7879",
+    "@dxos/react-ui-syntax-highlighter": "0.8.4-main.422d1c7879",
+    "@dxos/react-ui-table": "0.8.4-main.422d1c7879",
+    "@dxos/react-ui-mosaic": "0.8.4-main.422d1c7879",
+    "@dxos/schema": "0.8.4-main.422d1c7879",
+    "@dxos/types": "0.8.4-main.422d1c7879",
+    "@dxos/react-ui-menu": "0.8.4-main.422d1c7879",
+    "@dxos/ui-editor": "0.8.4-main.422d1c7879",
+    "@dxos/ui-theme": "0.8.4-main.422d1c7879",
+    "@dxos/util": "0.8.4-main.422d1c7879",
+    "@dxos/plugin-deck": "0.8.4-main.422d1c7879",
+    "@dxos/app-graph": "0.8.4-main.422d1c7879"
   },
   "devDependencies": {
-    "effect": "3.19.16",
+    "effect": "3.20.0",
     "react": "~19.2.3",
     "react-dom": "~19.2.3",
-    "vite": "7.1.9",
-    "@dxos/plugin-testing": "0.8.4-main.3eb6e50203",
-    "@dxos/echo-db": "0.8.4-main.3eb6e50203",
-    "@dxos/random": "0.8.4-main.3eb6e50203",
-    "@dxos/react-ui-components": "0.8.4-main.3eb6e50203",
-    "@dxos/storybook-utils": "0.8.4-main.3eb6e50203"
+    "vite": "^7.1.11",
+    "@dxos/echo-db": "0.8.4-main.422d1c7879",
+    "@dxos/plugin-testing": "0.8.4-main.422d1c7879",
+    "@dxos/random": "0.8.4-main.422d1c7879",
+    "@dxos/react-ui-components": "0.8.4-main.422d1c7879",
+    "@dxos/storybook-utils": "0.8.4-main.422d1c7879"
   },
   "peerDependencies": {
-    "effect": "3.19.16",
+    "effect": "3.20.0",
     "react": "~19.2.3",
     "react-dom": "~19.2.3"
   },

package/src/PreviewPlugin.tsx

@@ -6,8 +6,9 @@ import { ActivationEvents, Plugin } from '@dxos/app-framework';
 import { AppPlugin } from '@dxos/app-toolkit';
 import { Organization, Person } from '@dxos/types';
 
-import { PreviewPopover, ReactSurface } from './capabilities';
-import { meta } from './meta';
+import { PreviewPopover, ReactSurface } from '#capabilities';
+import { meta } from '#meta';
+
 import { translations } from './translations';
 
 export const PreviewPlugin = Plugin.define(meta).pipe(

package/src/capabilities/index.ts

@@ -2,5 +2,7 @@
 // Copyright 2025 DXOS.org
 //
 
-export * from './preview-popover';
-export * from './react-surface';
+import { Capability } from '@dxos/app-framework';
+
+export const PreviewPopover = Capability.lazy('PreviewPopover', () => import('./preview-popover'));
+export const ReactSurface = Capability.lazy('ReactSurface', () => import('./react-surface'));

package/src/capabilities/{preview-popover/preview-popover.ts → preview-popover.ts}

@@ -5,14 +5,14 @@
 import * as Effect from 'effect/Effect';
 
 import { Capabilities, Capability } from '@dxos/app-framework';
-import { AppCapabilities, LayoutOperation } from '@dxos/app-toolkit';
+import { AppCapabilities, LayoutOperation, getPersonalSpace, getSpaceIdFromPath } from '@dxos/app-toolkit';
 import { addEventListener } from '@dxos/async';
 import { type Client } from '@dxos/client';
-import { type Space, parseId } from '@dxos/client/echo';
+import { type Space } from '@dxos/client/echo';
 import { Obj } from '@dxos/echo';
 import { DXN } from '@dxos/keys';
 import { log } from '@dxos/log';
-import { ClientCapabilities } from '@dxos/plugin-client';
+import { ClientCapabilities } from '@dxos/plugin-client/types';
 import { DX_ANCHOR_ACTIVATE, type DxAnchorActivate } from '@dxos/react-ui';
 import { type PreviewLinkRef, type PreviewLinkTarget } from '@dxos/ui-editor';
 
@@ -49,10 +49,16 @@ export default Capability.makeModule(
       const { invokePromise } = capabilities.get(Capabilities.OperationInvoker);
       const client = capabilities.get(ClientCapabilities.Client);
       const registry = capabilities.get(Capabilities.AtomRegistry);
+      // Layout is optional: in standalone harnesses (Storybook, tests) no plugin contributes
+      // `AppCapabilities.Layout`, and `getAll` returns an empty array. Reading `registry.get(undefined)`
+      // would crash inside Atom's identity check (`'~atom/Serializable' in undefined`). When layout
+      // isn't available, fall through to the personal-space default.
       const [layoutAtom] = capabilities.getAll(AppCapabilities.Layout);
-      const layout = registry.get(layoutAtom);
-      const { spaceId } = parseId(layout.workspace);
-      const space = (spaceId && client.spaces.get(spaceId)) ?? client.spaces.default;
+      const spaceId = layoutAtom && getSpaceIdFromPath(registry.get(layoutAtom).workspace);
+      const space = (spaceId && client.spaces.get(spaceId)) ?? getPersonalSpace(client);
+      if (!space) {
+        return;
+      }
       const result = await handlePreviewLookup(client, space, { dxn, label });
       if (!result) {
         return;

package/src/capabilities/{react-surface/react-surface.tsx → react-surface.tsx}

@@ -7,13 +7,13 @@ import React from 'react';
 
 import { Capabilities, Capability } from '@dxos/app-framework';
 import { Surface } from '@dxos/app-framework/ui';
+import { AppSurface } from '@dxos/app-toolkit/ui';
 import { Obj } from '@dxos/echo';
-import { Card } from '@dxos/react-ui-mosaic';
+import { Card } from '@dxos/react-ui';
 import { type ProjectionModel } from '@dxos/schema';
 import { Organization, Person, Pipeline, Task } from '@dxos/types';
 
-import { FormCard, OrganizationCard, PersonCard, ProjectCard, TaskCard } from '../../cards';
-import { meta } from '../../meta';
+import { FormCard, JsonCard, OrganizationCard, PersonCard, ProjectCard, TaskCard } from '../cards';
 
 export default Capability.makeModule(() =>
   Effect.succeed(
@@ -24,38 +24,43 @@ export default Capability.makeModule(() =>
       //
 
       Surface.create<{ subject: Person.Person }>({
-        id: `${meta.id}/schema-popover--contact`,
-        role: 'card--content',
+        id: 'schema-popover--contact',
         position: 'hoist',
-        filter: (data): data is { subject: Person.Person } => Obj.instanceOf(Person.Person, data.subject),
+        filter: AppSurface.object(AppSurface.Card, Person.Person),
         component: ({ data, role }) => {
-          return <PersonCard role={role} subject={data.subject} />;
+          return (
+            <>
+              <PersonCard role={role} subject={data.subject} />
+              <Surface.Surface type={AppSurface.Related} data={data} limit={1} />
+            </>
+          );
         },
       }),
       Surface.create({
-        id: `${meta.id}/schema-popover--organization`,
-        role: 'card--content',
+        id: 'schema-popover--organization',
         position: 'hoist',
-        filter: (data): data is { subject: Organization.Organization } =>
-          Obj.instanceOf(Organization.Organization, data.subject),
+        filter: AppSurface.object(AppSurface.Card, Organization.Organization),
         component: ({ data, role }) => {
-          return <OrganizationCard role={role} subject={data.subject} />;
+          return (
+            <>
+              <OrganizationCard role={role} subject={data.subject} />
+              <Surface.Surface type={AppSurface.Related} data={data} limit={1} />
+            </>
+          );
         },
       }),
       Surface.create({
-        id: `${meta.id}/schema-popover--project`,
-        role: 'card--content',
+        id: 'schema-popover--project',
         position: 'hoist',
-        filter: (data): data is { subject: Pipeline.Pipeline } => Obj.instanceOf(Pipeline.Pipeline, data.subject),
+        filter: AppSurface.object(AppSurface.Card, Pipeline.Pipeline),
         component: ({ data, role }) => {
           return <ProjectCard role={role} subject={data.subject} />;
         },
       }),
       Surface.create({
-        id: `${meta.id}/schema-popover--task`,
-        role: 'card--content',
+        id: 'schema-popover--task',
         position: 'hoist',
-        filter: (data): data is { subject: Task.Task } => Obj.instanceOf(Task.Task, data.subject),
+        filter: AppSurface.object(AppSurface.Card, Task.Task),
         component: ({ data, role }) => {
           return <TaskCard role={role} subject={data.subject} />;
         },
@@ -66,7 +71,7 @@ export default Capability.makeModule(() =>
       //
 
       Surface.create({
-        id: `${meta.id}/fallback-popover`,
+        id: 'fallback-popover',
         role: 'card--content',
         position: 'fallback',
         filter: (data): data is { subject: Obj.Unknown; projection?: ProjectionModel } => Obj.isObject(data.subject),
@@ -76,16 +81,25 @@ export default Capability.makeModule(() =>
       }),
 
       Surface.create({
-        id: `${meta.id}/section`,
-        role: ['section'],
+        id: 'fallback-json',
+        role: 'card--content',
+        position: 'fallback',
+        filter: (data): data is Record<string, unknown> => true,
+        component: ({ data }) => {
+          return <JsonCard data={data} />;
+        },
+      }),
+
+      Surface.create({
+        id: 'section',
         position: 'fallback',
-        filter: (data): data is { subject: Obj.Unknown } => Obj.isObject(data.subject),
+        filter: AppSurface.subject(AppSurface.Section, Obj.isObject),
         component: ({ data }) => {
           return (
-            <div role='none' className='flex is-full justify-center'>
-              <div role='none' className='pbs-2 pbe-2 card-min-width card-max-width'>
+            <div role='none' className='flex w-full justify-center'>
+              <div role='none' className='pt-2 pb-2 dx-card-min-width dx-card-max-width'>
                 <Card.Root>
-                  <Surface.Surface role='card--content' data={data} limit={1} />
+                  <Surface.Surface type={AppSurface.Card} data={data} limit={1} />
                 </Card.Root>
               </div>
             </div>

package/src/cards/FormCard.tsx

@@ -2,30 +2,22 @@
 // Copyright 2025 DXOS.org
 //
 
-import React, { useCallback } from 'react';
+import React, { useCallback, useMemo } from 'react';
 
-import { useOperationInvoker } from '@dxos/app-framework/ui';
-import { LayoutOperation } from '@dxos/app-toolkit';
-import { type SurfaceComponentProps } from '@dxos/app-toolkit/ui';
+import { type AppSurface } from '@dxos/app-toolkit/ui';
 import { Obj } from '@dxos/echo';
 import { type JsonPath, splitJsonPath } from '@dxos/effect';
-import { useTranslation } from '@dxos/react-ui';
+import { Card, useTranslation } from '@dxos/react-ui';
 import { Form, omitId } from '@dxos/react-ui-form';
 import { type ProjectionModel } from '@dxos/schema';
 import { descriptionMessage, mx } from '@dxos/ui-theme';
 
-import { meta } from '../meta';
+import { meta } from '#meta';
 
-export const FormCard = ({ subject, projection }: SurfaceComponentProps & { projection?: ProjectionModel }) => {
+export const FormCard = ({ subject, projection }: AppSurface.ObjectCardProps & { projection?: ProjectionModel }) => {
   const { t } = useTranslation(meta.id);
-  const { invokePromise } = useOperationInvoker();
-  const schema = Obj.getSchema(subject);
-  const label = Obj.getLabel(subject) ?? Obj.getTypename(subject) ?? t('unable to create preview message');
-
-  const handleNavigate = useCallback(async () => {
-    await invokePromise(LayoutOperation.UpdatePopover, { state: false, anchorId: '' });
-    await invokePromise(LayoutOperation.Open, { subject: [Obj.getDXN(subject).toString()] });
-  }, [invokePromise, subject]);
+  const echoSchema = Obj.getSchema(subject);
+  const schema = useMemo(() => echoSchema && omitId(echoSchema), [echoSchema]);
 
   const handleSave = useCallback((values: any, { changed }: { changed: Record<string, boolean> }) => {
     const paths = Object.keys(changed).filter((path) => changed[path]);
@@ -39,18 +31,18 @@ export const FormCard = ({ subject, projection }: SurfaceComponentProps & { proj
   }, []);
 
   if (!schema) {
-    // TODO(burdon): Use Alert.
-    return <p className={mx(descriptionMessage)}>{t('unable to create preview message')}</p>;
+    return <p className={mx(descriptionMessage)}>{t('unable-to-create-preview.message')}</p>;
   }
 
   return (
-    <Form.Root schema={omitId(schema)} projection={projection} values={subject} autoSave onSave={handleSave}>
-      {/* TODO(burdon): Scrolling issue. Need fixed height. */}
-      <Form.Viewport>
-        <Form.Content>
-          <Form.FieldSet />
-        </Form.Content>
-      </Form.Viewport>
-    </Form.Root>
+    <Card.Content>
+      <Form.Root schema={schema} projection={projection} values={subject} autoSave onSave={handleSave}>
+        <Form.Viewport>
+          <Form.Content>
+            <Form.FieldSet />
+          </Form.Content>
+        </Form.Viewport>
+      </Form.Root>
+    </Card.Content>
   );
 };

package/src/cards/JsonCard.tsx

@@ -0,0 +1,16 @@
+//
+// Copyright 2025 DXOS.org
+//
+
+import React from 'react';
+
+import { Card } from '@dxos/react-ui';
+import { JsonHighlighter } from '@dxos/react-ui-syntax-highlighter';
+
+export const JsonCard = ({ data }: { data: unknown }) => {
+  return (
+    <Card.Content>
+      <JsonHighlighter data={data} />
+    </Card.Content>
+  );
+};

package/src/cards/OrganizationCard.tsx

@@ -4,12 +4,12 @@
 
 import React from 'react';
 
-import { type SurfaceComponentProps } from '@dxos/app-toolkit/ui';
-import { Card } from '@dxos/react-ui-mosaic';
+import { type AppSurface } from '@dxos/app-toolkit/ui';
+import { Card } from '@dxos/react-ui';
 import { type Organization } from '@dxos/types';
 
-export const OrganizationCard = ({ subject }: SurfaceComponentProps<Organization.Organization>) => {
-  const { image, description, website } = subject;
+export const OrganizationCard = ({ subject }: AppSurface.ObjectCardProps<Organization.Organization>) => {
+  const { name, image, description, website } = subject;
 
   return (
     <Card.Content>

package/src/cards/PersonCard.tsx

@@ -2,25 +2,47 @@
 // Copyright 2025 DXOS.org
 //
 
-import React from 'react';
+import * as Effect from 'effect/Effect';
+import React, { useCallback } from 'react';
 
-import { type SurfaceComponentProps } from '@dxos/app-toolkit/ui';
+import { useOperationInvoker } from '@dxos/app-framework/ui';
+import { LayoutOperation, getObjectPathFromObject, getSpacePath } from '@dxos/app-toolkit';
+import { type AppSurface } from '@dxos/app-toolkit/ui';
+import { Obj } from '@dxos/echo';
+import { runAndForwardErrors } from '@dxos/effect';
 import { Avatar } from '@dxos/react-ui';
-import { Card } from '@dxos/react-ui-mosaic';
+import { Card } from '@dxos/react-ui';
 import { type Person } from '@dxos/types';
 
-export const PersonCard = ({ subject }: SurfaceComponentProps<Person.Person>) => {
+export const PersonCard = ({ subject }: AppSurface.ObjectCardProps<Person.Person>) => {
+  const { invoke } = useOperationInvoker();
   const { image, organization: { target: organization } = {}, emails = [] } = subject;
 
+  const handleOrganizationClick = useCallback(() => {
+    if (!organization) {
+      return;
+    }
+
+    return Effect.gen(function* () {
+      const organizationPath = getObjectPathFromObject(organization);
+      const db = Obj.getDatabase(organization);
+      yield* invoke(LayoutOperation.UpdatePopover, { state: false, anchorId: '' });
+      yield* invoke(LayoutOperation.Open, {
+        subject: [organizationPath],
+        workspace: db ? getSpacePath(db.spaceId) : undefined,
+      });
+    }).pipe(runAndForwardErrors);
+  }, [invoke, organization]);
+
   return (
-    <Avatar.Root>
-      <Card.Content>
+    <Card.Content>
+      <Avatar.Root>
         {image && (
-          <Card.Row className='plb-1'>
+          <Card.Row className='py-1'>
             <Avatar.Content
               imgSrc={image}
               icon='ph--user--regular'
-              size={16}
+              size={20}
               classNames={!image && 'opacity-50'}
               hue='neutral'
               variant='square'
@@ -28,20 +50,16 @@ export const PersonCard = ({ subject }: SurfaceComponentProps<Person.Person>) =>
           </Card.Row>
         )}
         {organization?.name && (
-          <Card.Action
-            icon='ph--buildings--regular'
-            label={organization.name}
-            // onClick={onSelect ? () => onSelect(organization) : undefined}
-          />
+          <Card.Action icon='ph--buildings--regular' label={organization.name} onClick={handleOrganizationClick} />
         )}
         {emails.map(({ value }) => (
           <Card.Row key={value} icon='ph--at--regular'>
-            <Card.Text truncate className='text-primaryText'>
+            <Card.Text truncate className='text-primary-text'>
               {value}
             </Card.Text>
           </Card.Row>
         ))}
-      </Card.Content>
-    </Avatar.Root>
+      </Avatar.Root>
+    </Card.Content>
   );
 };

package/src/cards/ProjectCard.tsx

@@ -4,13 +4,13 @@
 
 import React from 'react';
 
-import { type SurfaceComponentProps } from '@dxos/app-toolkit/ui';
+import { type AppSurface } from '@dxos/app-toolkit/ui';
 import { Obj } from '@dxos/echo';
-import { Card } from '@dxos/react-ui-mosaic';
+import { Card } from '@dxos/react-ui';
 import { type Pipeline } from '@dxos/types';
 
-export const ProjectCard = ({ subject }: SurfaceComponentProps<Pipeline.Pipeline>) => {
-  const { name, image, description } = subject;
+export const ProjectCard = ({ subject }: AppSurface.ObjectCardProps<Pipeline.Pipeline>) => {
+  const { image, description } = subject;
 
   return (
     <Card.Content>

package/src/cards/TaskCard.tsx

@@ -5,23 +5,26 @@
 import * as SchemaAST from 'effect/SchemaAST';
 import React from 'react';
 
-import { type SurfaceComponentProps } from '@dxos/app-toolkit/ui';
+import { type AppSurface } from '@dxos/app-toolkit/ui';
 import { type PropertyMetaAnnotation, PropertyMetaAnnotationId } from '@dxos/echo/internal';
-import { Card } from '@dxos/react-ui-mosaic';
+import { Card } from '@dxos/react-ui';
 import { Task } from '@dxos/types';
 
-export const TaskCard = ({ subject }: SurfaceComponentProps<Task.Task>) => {
+export const TaskCard = ({ subject }: AppSurface.ObjectCardProps<Task.Task>) => {
   const { title, status } = subject;
   const statusOption = getActiveStatusOption(status);
 
   return (
     <Card.Content>
-      <Card.Heading classNames='min-is-0 flex-1 truncate'>{title}</Card.Heading>
-      {statusOption && (
-        <span className='dx-tag' data-hue={statusOption.color}>
-          {statusOption.title}
-        </span>
-      )}
+      <Card.Row>
+        {statusOption && (
+          <div>
+            <span className='dx-tag' data-hue={statusOption.color}>
+              {statusOption.title}
+            </span>
+          </div>
+        )}
+      </Card.Row>
     </Card.Content>
   );
 };
@@ -30,11 +33,12 @@ export const TaskCard = ({ subject }: SurfaceComponentProps<Task.Task>) => {
 const getActiveStatusOption = (status?: string) => {
   const properties = SchemaAST.getPropertySignatures(Task.Task.ast);
   const statusProperty = properties.find((p) => p.name === 'status');
+  // TODO(thure): Typescript asserts `.type` doesn’t have `.types`, but in runtime it does.
   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 }[];
+
+  // TODO(thure): Typescript asserts `statusMeta` doesn’t have `.value`, but in runtime it does.
+  const options = (statusMeta as any).value.singleSelect.options as { id: string; title: string; color: string }[];
   return options.find(({ id }) => id === status);
 };

package/src/cards/index.ts

@@ -3,6 +3,7 @@
 //
 
 export * from './FormCard';
+export * from './JsonCard';
 export * from './OrganizationCard';
 export * from './PersonCard';
 export * from './ProjectCard';

package/src/meta.ts

@@ -6,7 +6,7 @@ import { type Plugin } from '@dxos/app-framework';
 import { trim } from '@dxos/util';
 
 export const meta: Plugin.Meta = {
-  id: 'dxos.org/plugin/preview',
+  id: 'org.dxos.plugin.preview',
   name: 'Preview',
   description: trim`
     Rich preview panel for viewing object content without opening full editors.

package/src/stories/Card.stories.tsx

@@ -3,32 +3,32 @@
 //
 
 import { type Meta, type StoryObj } from '@storybook/react-vite';
+import React from 'react';
 
 import { withPluginManager } from '@dxos/app-framework/testing';
 import { corePlugins } from '@dxos/plugin-testing';
-import { faker } from '@dxos/random';
-import { withLayout, withTheme } from '@dxos/react-ui/testing';
+import { random } from '@dxos/random';
+import { Card } from '@dxos/react-ui';
+import { withLayout } from '@dxos/react-ui/testing';
 import { type Organization, type Person, type Pipeline, type Task } from '@dxos/types';
 
-import { FormCard, OrganizationCard, PersonCard, ProjectCard, TaskCard } from '../cards';
+import { FormCard, JsonCard, OrganizationCard, PersonCard, ProjectCard, TaskCard } from '../cards';
 import { translations } from '../translations';
-
 import { DefaultStory, createOrganization, createPerson, createProject, createTask } from './testing';
 
-faker.seed(999);
+random.seed(999);
 
 const meta = {
-  title: 'plugins/plugin-preview/Card',
+  title: 'plugins/plugin-preview/cards/Card',
   render: DefaultStory,
   decorators: [
-    withTheme(),
-    withLayout({ layout: 'column', scroll: true }),
+    withLayout({ layout: 'fullscreen' }),
     // TODO(wittjosiah): Try to write story which does not depend on plugin manager.
     withPluginManager({ plugins: corePlugins() }),
   ],
   parameters: {
-    translations,
     layout: 'fullscreen',
+    translations,
   },
   tags: ['cards'],
 } satisfies Meta<typeof DefaultStory>;
@@ -74,3 +74,34 @@ export const _Task: StoryObj<typeof DefaultStory<Task.Task>> = {
     image: true,
   },
 };
+
+export const _Json = {
+  render: () => {
+    const data = {
+      subject: {
+        id: random.string.uuid(),
+        name: random.person.fullName(),
+        email: random.internet.email(),
+        tags: [random.lorem.word(), random.lorem.word(), random.lorem.word()],
+        nested: {
+          count: random.number.int({ max: 100 }),
+          active: random.datatype.boolean(),
+        },
+      },
+    };
+
+    return (
+      <div className='flex justify-center p-16'>
+        <div className='dx-card-min-width dx-card-max-width'>
+          <Card.Root>
+            <Card.Toolbar>
+              <Card.IconBlock />
+              <Card.Title>JSON</Card.Title>
+            </Card.Toolbar>
+            <JsonCard data={data} />
+          </Card.Root>
+        </div>
+      </div>
+    );
+  },
+};