@dxos/plugin-preview 0.8.4-main.c1de068 → 0.8.4-main.e098934

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dxos/plugin-preview",
-  "version": "0.8.4-main.c1de068",
+  "version": "0.8.4-main.e098934",
   "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,35 +24,38 @@
     "src"
   ],
   "dependencies": {
+    "@effect-rx/rx-react": "0.38.0",
     "@preact-signals/safe-react": "^0.9.0",
-    "@dxos/app-framework": "0.8.4-main.c1de068",
-    "@dxos/async": "0.8.4-main.c1de068",
-    "@dxos/client": "0.8.4-main.c1de068",
-    "@dxos/echo": "0.8.4-main.c1de068",
-    "@dxos/keys": "0.8.4-main.c1de068",
-    "@dxos/lit-ui": "0.8.4-main.c1de068",
-    "@dxos/log": "0.8.4-main.c1de068",
-    "@dxos/echo-schema": "0.8.4-main.c1de068",
-    "@dxos/plugin-attention": "0.8.4-main.c1de068",
-    "@dxos/plugin-client": "0.8.4-main.c1de068",
-    "@dxos/plugin-deck": "0.8.4-main.c1de068",
-    "@dxos/react-client": "0.8.4-main.c1de068",
-    "@dxos/react-ui": "0.8.4-main.c1de068",
-    "@dxos/react-ui-editor": "0.8.4-main.c1de068",
-    "@dxos/react-ui-form": "0.8.4-main.c1de068",
-    "@dxos/react-ui-stack": "0.8.4-main.c1de068",
-    "@dxos/react-ui-table": "0.8.4-main.c1de068",
-    "@dxos/react-ui-theme": "0.8.4-main.c1de068",
-    "@dxos/schema": "0.8.4-main.c1de068",
-    "@dxos/util": "0.8.4-main.c1de068"
+    "@dxos/app-framework": "0.8.4-main.e098934",
+    "@dxos/async": "0.8.4-main.e098934",
+    "@dxos/app-graph": "0.8.4-main.e098934",
+    "@dxos/client": "0.8.4-main.e098934",
+    "@dxos/echo": "0.8.4-main.e098934",
+    "@dxos/echo-schema": "0.8.4-main.e098934",
+    "@dxos/keys": "0.8.4-main.e098934",
+    "@dxos/lit-ui": "0.8.4-main.e098934",
+    "@dxos/plugin-attention": "0.8.4-main.e098934",
+    "@dxos/plugin-deck": "0.8.4-main.e098934",
+    "@dxos/log": "0.8.4-main.e098934",
+    "@dxos/react-client": "0.8.4-main.e098934",
+    "@dxos/react-ui": "0.8.4-main.e098934",
+    "@dxos/react-ui-editor": "0.8.4-main.e098934",
+    "@dxos/plugin-client": "0.8.4-main.e098934",
+    "@dxos/react-ui-form": "0.8.4-main.e098934",
+    "@dxos/react-ui-menu": "0.8.4-main.e098934",
+    "@dxos/react-ui-stack": "0.8.4-main.e098934",
+    "@dxos/react-ui-table": "0.8.4-main.e098934",
+    "@dxos/schema": "0.8.4-main.e098934",
+    "@dxos/react-ui-theme": "0.8.4-main.e098934",
+    "@dxos/util": "0.8.4-main.e098934"
   },
   "devDependencies": {
-    "effect": "3.17.0",
+    "effect": "3.17.7",
     "react": "~18.2.0",
     "react-dom": "~18.2.0",
-    "vite": "5.4.7",
-    "@dxos/random": "0.8.4-main.c1de068",
-    "@dxos/storybook-utils": "0.8.4-main.c1de068"
+    "vite": "7.1.1",
+    "@dxos/random": "0.8.4-main.e098934",
+    "@dxos/storybook-utils": "0.8.4-main.e098934"
   },
   "peerDependencies": {
     "effect": "^3.13.3",

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,12 +20,7 @@ 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) {
     return null;
@@ -34,7 +29,7 @@ const handlePreviewLookup = async (
 
 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

@@ -23,9 +23,9 @@ 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 { Table } from '@dxos/react-ui-table/types';
 import { descriptionMessage, mx } from '@dxos/react-ui-theme';
-import { DataType } from '@dxos/schema';
+import { DataType, type ProjectionModel, typenameFromQuery } from '@dxos/schema';
 
 import { ContactCard, OrganizationCard, ProjectCard } from '../components';
 import { PREVIEW_PLUGIN } from '../meta';
@@ -49,13 +49,13 @@ export default () =>
         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),
+            typenameFromQuery(view.query) === DataType.Organization.typename &&
+            Obj.instanceOf(Table.Table, view.presentation.target),
         );
         const defaultSpaceOrgTable = defaultSpaceViews.find(
           (view) =>
-            view.query.typename === DataType.Organization.typename &&
-            Obj.instanceOf(TableView, view.presentation.target),
+            typenameFromQuery(view.query) === DataType.Organization.typename &&
+            Obj.instanceOf(Table.Table, view.presentation.target),
         );
 
         // TODO(wittjosiah): Generalized way of handling related objects navigation.
@@ -129,7 +129,7 @@ export default () =>
       id: `${PREVIEW_PLUGIN}/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);
@@ -150,8 +150,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,56 @@
+//
+// Copyright 2025 DXOS.org
+//
+
+import { Rx } from '@effect-rx/rx-react';
+import React from 'react';
+
+// import { useIntentDispatcher } from '@dxos/app-framework';
+import { ACTION_TYPE } from '@dxos/app-graph';
+import { type AnyEchoObject } from '@dxos/echo-schema';
+import { IconButton, type IconButtonProps, useTranslation } from '@dxos/react-ui';
+import { type ActionGraphProps, DropdownMenu, MenuProvider, useMenuActions } from '@dxos/react-ui-menu';
+
+const useSubjectMenuGroupItems = (subject: AnyEchoObject) => {
+  // const { dispatchPromise: dispatch } = useIntentDispatcher();
+  const result: ActionGraphProps = { edges: [], nodes: [] };
+  result.nodes.push({
+    type: ACTION_TYPE,
+    id: `${subject.id}/add-to-space`,
+    data: () => console.log('[TO DO]', 'add object to space', subject),
+    properties: {
+      label: ['add object to space label', { ns: 'os' }],
+      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,
+  ...props
+}: Omit<IconButtonProps, 'icon' | 'label'> & { subject: AnyEchoObject }) => {
+  const { t } = useTranslation('os');
+  const menuProps = useSubjectMenuGroupItems(subject);
+  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

@@ -4,29 +4,33 @@
 
 import React, { Fragment } from 'react';
 
-import { Icon, Avatar, Button } from '@dxos/react-ui';
+import { Avatar, Button, Icon } from '@dxos/react-ui';
 import { Card, cardHeading, cardText } from '@dxos/react-ui-stack';
 import { mx } from '@dxos/react-ui-theme';
 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,
   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} />
           </div>
         </Card.Text>
       </Avatar.Root>
@@ -46,24 +50,26 @@ export const ContactCard = ({
           )}
         </Card.Chrome>
       )}
-      <dl
-        className={mx(
-          cardText,
-          'grid gap-2 grid-cols-[min-content_1fr] [&_dt]:text-subdued [&_dt]:pbs-0.5 [&_dd]:min-is-0',
-        )}
-      >
-        {emails?.length &&
-          emails.map(({ label, value }) => (
-            <Fragment key={value}>
-              <dt>
-                <Icon icon='ph--at--regular' size={5} />
-              </dt>
-              <dd key={value} className='break-words'>
-                {value}
-              </dd>
-            </Fragment>
-          ))}
-      </dl>
+      {emails?.length && (
+        <dl
+          className={mx(
+            cardText,
+            'grid gap-2 grid-cols-[min-content_1fr] [&_dt]:text-subdued [&_dt]:pbs-0.5 [&_dd]:min-is-0',
+          )}
+        >
+          {emails?.length &&
+            emails.map(({ label, value }) => (
+              <Fragment key={value}>
+                <dt>
+                  <Icon icon='ph--at--regular' size={5} />
+                </dt>
+                <dd key={value} className='break-words'>
+                  {value}
+                </dd>
+              </Fragment>
+            ))}
+        </dl>
+      )}
       {children}
     </Card.SurfaceRoot>
   );

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 }: 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} />
+      </div>
       {description && <Card.Text classNames='line-clamp-2'>{description}</Card.Text>}
       {website && (
         <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 }: 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} />
+      </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 { SchemaAST } from 'effect';
+import React from 'react';
+
+import { type PropertyMetaAnnotation, PropertyMetaAnnotationId } from '@dxos/echo-schema';
+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 }: 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} />
+      </div>
+    </Card.SurfaceRoot>
+  );
+};

package/src/stories/Card.stories.tsx

@@ -0,0 +1,59 @@
+//
+// Copyright 2023 DXOS.org
+//
+
+import '@dxos-theme';
+
+import { type Meta, type StoryObj } from '@storybook/react-vite';
+
+import { withLayout, withTheme } from '@dxos/storybook-utils';
+
+import { translations } from '../translations';
+
+import { Defaultstory, createCards } from './testing';
+
+const meta = {
+  title: 'plugins/plugin-preview/Card',
+  render: Defaultstory,
+  decorators: [
+    withTheme,
+    withLayout({
+      fullscreen: true,
+      classNames: 'flex flex-col justify-center',
+    }),
+  ],
+  parameters: { translations },
+  tags: ['cards'],
+} satisfies Meta<typeof Defaultstory>;
+
+export default meta;
+
+type Story = StoryObj<typeof meta>;
+
+export const Popover: Story = {
+  args: {
+    role: 'card--popover',
+    cards: createCards(),
+  },
+};
+
+export const Intrinsic: Story = {
+  args: {
+    role: 'card--intrinsic',
+    cards: createCards(),
+  },
+};
+
+export const Extrinsic: Story = {
+  args: {
+    role: 'card--extrinsic',
+    cards: createCards(),
+  },
+};
+
+export const ExtrinsicNoImage: Story = {
+  args: {
+    role: 'card--extrinsic',
+    cards: createCards(false),
+  },
+};

package/src/stories/testing.tsx

@@ -0,0 +1,114 @@
+//
+// Copyright 2025 DXOS.org
+//
+
+import React, { type FC } from 'react';
+
+import { Obj, Ref } from '@dxos/echo';
+import { faker } from '@dxos/random';
+import { CardContainer } from '@dxos/react-ui-stack/testing';
+import { DataType } from '@dxos/schema';
+
+import { ContactCard, OrganizationCard, ProjectCard } from '../components';
+import { TaskCard } from '../components/TaskCard';
+import { type PreviewProps } from '../types';
+
+faker.seed(1234);
+
+type CardProps<T extends object> = {
+  Component: FC<PreviewProps<T>>;
+  subject: T;
+  icon?: string;
+  image?: boolean;
+};
+
+export type DefaultstoryProps = {
+  role: 'card--popover' | 'card--intrinsic' | 'card--extrinsic' | 'card--transclusion';
+  cards: CardProps<any>[];
+};
+
+export const Defaultstory = ({ role, cards }: DefaultstoryProps) => {
+  return (
+    <div className='grid grid-cols-4'>
+      {cards.map(({ Component, icon, image, subject }, i) => (
+        <div key={i} className='flex justify-center'>
+          <CardContainer icon={icon} role={role}>
+            <Component role={role} subject={image ? subject : omitImage(subject)} />
+          </CardContainer>
+        </div>
+      ))}
+    </div>
+  );
+};
+
+export const omitImage = ({ image: _, ...rest }: any) => rest;
+
+// TODO(burdon): Test data should exercise the standard data generators.
+export const createCards = (image = true): CardProps<any>[] => {
+  const organization = Obj.make(DataType.Organization, {
+    name: faker.company.name(),
+    image:
+      'https://plus.unsplash.com/premium_photo-1672116452571-896980a801c8?q=80&w=2671&auto=format&fit=crop&ixlib=rb-4.0.3&ixid=M3wxMjA3fDB8MHxwaG90by1wYWdlfHx8fGVufDB8fHx8fA%3D%3D',
+    website: faker.internet.url(),
+    description: faker.lorem.paragraph(),
+  });
+
+  const contact = Obj.make(DataType.Person, {
+    fullName: faker.person.fullName(),
+    image:
+      'https://plus.unsplash.com/premium_photo-1664536392779-049ba8fde933?q=80&w=2574&auto=format&fit=crop&ixlib=rb-4.0.3&ixid=M3wxMjA3fDB8MHxwaG90by1wYWdlfHx8fGVufDB8fHx8fA%3D%3D',
+    organization: Ref.make(organization),
+    emails: [
+      {
+        label: 'Work',
+        value: faker.internet.email(),
+      },
+      {
+        label: 'Work',
+        value: faker.internet.email(),
+      },
+      {
+        label: 'Work',
+        value: faker.internet.email(),
+      },
+    ],
+  });
+
+  const project = DataType.makeProject({
+    name: faker.person.fullName(),
+    image: 'https://dxos.network/dxos-logotype-blue.png',
+    description: faker.lorem.paragraph(),
+  });
+
+  const task = Obj.make(DataType.Task, {
+    title: faker.lorem.sentence(),
+    status: faker.helpers.arrayElement(['todo', 'in-progress', 'done']),
+  });
+
+  return [
+    {
+      Component: OrganizationCard,
+      subject: organization,
+      icon: 'ph--building-office--regular',
+      image,
+    },
+    {
+      Component: ContactCard,
+      subject: contact,
+      icon: 'ph--user--regular',
+      image,
+    },
+    {
+      Component: ProjectCard,
+      subject: project,
+      icon: 'ph--building--regular',
+      image,
+    },
+    {
+      Component: TaskCard,
+      subject: task,
+      icon: 'ph--list-checks--regular',
+      image,
+    },
+  ];
+};

package/src/translations.ts

@@ -11,6 +11,9 @@ export const translations = [
     'en-US': {
       [meta.id]: {
         'unable to create preview message': 'No preview',
+        'todo label': 'To do',
+        'in-progress label': 'In progress',
+        'done label': 'Done',
       },
     },
   },

package/src/types.ts

@@ -2,10 +2,10 @@
 // Copyright 2025 DXOS.org
 //
 
+import { type Schema } from 'effect';
 import { type PropsWithChildren } from 'react';
 
-// TODO(burdon): Better place for these defs?
-export type PreviewProps<T extends object> = PropsWithChildren<{
+export type PreviewProps<T extends Schema.Schema.Type<any>> = PropsWithChildren<{
   subject: T;
   role?: string;
 }>;

package/dist/lib/browser/preview-popover-2UCEZUQW.mjs.map

@@ -1,7 +0,0 @@
-{
-  "version": 3,
-  "sources": ["../../../src/capabilities/preview-popover.ts"],
-  "sourcesContent": ["//\n// Copyright 2025 DXOS.org\n//\n\nimport { Capabilities, LayoutAction, contributes, createIntent, type PluginContext } from '@dxos/app-framework';\nimport { addEventListener } from '@dxos/async';\nimport { type Client, resolveRef } from '@dxos/client';\nimport { parseId, type Space } from '@dxos/client/echo';\nimport { DXN } from '@dxos/keys';\nimport { type DxRefTagActivate } from '@dxos/lit-ui';\nimport { log } from '@dxos/log';\nimport { ClientCapabilities } from '@dxos/plugin-client';\nimport { type PreviewLinkRef, type PreviewLinkTarget } from '@dxos/react-ui-editor';\n\nconst customEventOptions = { capture: true, passive: false };\n\nconst handlePreviewLookup = async (\n  client: Client,\n  defaultSpace: Space,\n  { ref, label }: PreviewLinkRef,\n): Promise<PreviewLinkTarget | null> => {\n  try {\n    const dxn = DXN.parse(ref);\n    if (!dxn) {\n      return null;\n    }\n\n    const object = await resolveRef(client, dxn, defaultSpace);\n    return { label, object };\n  } catch (err) {\n    return null;\n  }\n};\n\nexport default (context: PluginContext) => {\n  // TODO(wittjosiah): Factor out lookup handlers to other plugins to make not ECHO-specific.\n  const handleDxRefTagActivate = async ({ refId, label, trigger }: DxRefTagActivate) => {\n    const { dispatchPromise: dispatch } = context.getCapability(Capabilities.IntentDispatcher);\n    const client = context.getCapability(ClientCapabilities.Client);\n    const [layout] = context.getCapabilities(Capabilities.Layout);\n    const { spaceId } = parseId(layout.workspace);\n    const space = (spaceId && client.spaces.get(spaceId)) ?? client.spaces.default;\n    const result = await handlePreviewLookup(client, space, { ref: refId, label });\n    if (!result) {\n      return;\n    }\n\n    await dispatch(\n      createIntent(LayoutAction.UpdatePopover, {\n        part: 'popover',\n        subject: result.object,\n        options: {\n          state: true,\n          variant: 'virtual',\n          anchor: trigger,\n        },\n      }),\n    );\n  };\n\n  let cleanup: () => void;\n  if (document.defaultView) {\n    cleanup = addEventListener(\n      document.defaultView,\n      'dx-ref-tag-activate' as any,\n      handleDxRefTagActivate,\n      customEventOptions,\n    );\n  } else {\n    log.warn('No default view found');\n  }\n\n  return contributes(Capabilities.Null, null, () => cleanup());\n};\n"],
-  "mappings": ";AAIA,SAASA,cAAcC,cAAcC,aAAaC,oBAAwC;AAC1F,SAASC,wBAAwB;AACjC,SAAsBC,kBAAkB;AACxC,SAASC,eAA2B;AACpC,SAASC,WAAW;AAEpB,SAASC,WAAW;AACpB,SAASC,0BAA0B;;AAGnC,IAAMC,qBAAqB;EAAEC,SAAS;EAAMC,SAAS;AAAM;AAE3D,IAAMC,sBAAsB,OAC1BC,QACAC,cACA,EAAEC,KAAKC,MAAK,MAAkB;AAE9B,MAAI;AACF,UAAMC,MAAMX,IAAIY,MAAMH,GAAAA;AACtB,QAAI,CAACE,KAAK;AACR,aAAO;IACT;AAEA,UAAME,SAAS,MAAMf,WAAWS,QAAQI,KAAKH,YAAAA;AAC7C,WAAO;MAAEE;MAAOG;IAAO;EACzB,SAASC,KAAK;AACZ,WAAO;EACT;AACF;AAEA,IAAA,0BAAe,CAACC,YAAAA;AAEd,QAAMC,yBAAyB,OAAO,EAAEC,OAAOP,OAAOQ,QAAO,MAAoB;AAC/E,UAAM,EAAEC,iBAAiBC,SAAQ,IAAKL,QAAQM,cAAc5B,aAAa6B,gBAAgB;AACzF,UAAMf,SAASQ,QAAQM,cAAcnB,mBAAmBqB,MAAM;AAC9D,UAAM,CAACC,MAAAA,IAAUT,QAAQU,gBAAgBhC,aAAaiC,MAAM;AAC5D,UAAM,EAAEC,QAAO,IAAK5B,QAAQyB,OAAOI,SAAS;AAC5C,UAAMC,SAASF,WAAWpB,OAAOuB,OAAOC,IAAIJ,OAAAA,MAAapB,OAAOuB,OAAOE;AACvE,UAAMC,SAAS,MAAM3B,oBAAoBC,QAAQsB,OAAO;MAAEpB,KAAKQ;MAAOP;IAAM,CAAA;AAC5E,QAAI,CAACuB,QAAQ;AACX;IACF;AAEA,UAAMb,SACJxB,aAAaF,aAAawC,eAAe;MACvCC,MAAM;MACNC,SAASH,OAAOpB;MAChBwB,SAAS;QACPC,OAAO;QACPC,SAAS;QACTC,QAAQtB;MACV;IACF,CAAA,CAAA;EAEJ;AAEA,MAAIuB;AACJ,MAAIC,SAASC,aAAa;AACxBF,cAAU5C,iBACR6C,SAASC,aACT,uBACA3B,wBACAb,kBAAAA;EAEJ,OAAO;AACLF,QAAI2C,KAAK,yBAAA,QAAA;;;;;;EACX;AAEA,SAAOjD,YAAYF,aAAaoD,MAAM,MAAM,MAAMJ,QAAAA,CAAAA;AACpD;",
-  "names": ["Capabilities", "LayoutAction", "contributes", "createIntent", "addEventListener", "resolveRef", "parseId", "DXN", "log", "ClientCapabilities", "customEventOptions", "capture", "passive", "handlePreviewLookup", "client", "defaultSpace", "ref", "label", "dxn", "parse", "object", "err", "context", "handleDxRefTagActivate", "refId", "trigger", "dispatchPromise", "dispatch", "getCapability", "IntentDispatcher", "Client", "layout", "getCapabilities", "Layout", "spaceId", "workspace", "space", "spaces", "get", "default", "result", "UpdatePopover", "part", "subject", "options", "state", "variant", "anchor", "cleanup", "document", "defaultView", "warn", "Null"]
-}