@dxos/plugin-preview 0.8.4-main.5ea62a8 → 0.8.4-main.ae835ea

package/src/components/CardSubjectMenu.tsx

@@ -5,48 +5,49 @@
 import { Rx } from '@effect-rx/rx-react';
 import React from 'react';
 
-// import { useIntentDispatcher } from '@dxos/app-framework';
+import { LayoutAction, createIntent, useIntentDispatcher } from '@dxos/app-framework';
 import { ACTION_TYPE } from '@dxos/app-graph';
-import { type AnyEchoObject } from '@dxos/echo-schema';
+import { Obj } from '@dxos/echo';
+import { SpaceAction } from '@dxos/plugin-space/types';
+import { 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 {
+  type ActionGraphProps,
+  DropdownMenu,
+  type MenuActions,
+  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));
-};
+import { meta } from '../meta';
+import { type PreviewProps } from '../types';
 
 /**
- * This is a generic menu for objects that tries to infer common actions.
+ * Generic menu for objects; builds menu with common actions.
  */
+// TODO(burdon): Reconcile title and menu with main Card header.
 export const CardSubjectMenu = ({
   subject,
+  activeSpace,
   ...props
-}: Omit<IconButtonProps, 'icon' | 'label'> & { subject: AnyEchoObject }) => {
-  const { t } = useTranslation('os');
-  const menuProps = useSubjectMenuGroupItems(subject);
+}: PreviewProps & Omit<IconButtonProps, 'icon' | 'label'>) => {
+  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'
+            iconOnly
             label={t('more options label')}
+            size={5}
             {...props}
           />
         </DropdownMenu.Trigger>
@@ -54,3 +55,37 @@ export const CardSubjectMenu = ({
     </MenuProvider>
   );
 };
+
+const useSubjectMenuGroupItems = ({ subject, activeSpace }: PreviewProps): MenuActions => {
+  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));
+};

package/src/components/index.ts

@@ -2,6 +2,5 @@
 // Copyright 2025 DXOS.org
 //
 
-export * from './ContactCard';
-export * from './OrganizationCard';
-export * from './ProjectCard';
+export * from './CardComponents';
+export * from './CardSubjectMenu';

package/src/meta.ts

@@ -3,12 +3,15 @@
 //
 
 import { type PluginMeta } from '@dxos/app-framework';
-
-export const PREVIEW_PLUGIN = 'dxos.org/plugin/preview';
+import { trim } from '@dxos/util';
 
 export const meta: PluginMeta = {
-  id: PREVIEW_PLUGIN,
+  id: 'dxos.org/plugin/preview',
   name: 'Preview',
+  description: trim`
+    Rich preview panel for viewing object content without opening full editors.
+    Quick peek at documents, images, and data with inline rendering.
+  `,
   icon: 'ph--eye--regular',
   source: 'https://github.com/dxos/dxos/tree/main/packages/plugins/plugin-preview',
 };

package/src/stories/Card.stories.tsx

@@ -2,27 +2,30 @@
 // Copyright 2023 DXOS.org
 //
 
-import '@dxos-theme';
-
 import { type Meta, type StoryObj } from '@storybook/react-vite';
 
-import { withLayout, withTheme } from '@dxos/storybook-utils';
+import { IntentPlugin } from '@dxos/app-framework';
+import { withPluginManager } from '@dxos/app-framework/testing';
+import { faker } from '@dxos/random';
+import { withTheme } from '@dxos/react-ui/testing';
 
 import { translations } from '../translations';
 
 import { Defaultstory, createCards } from './testing';
 
+faker.seed(999);
+
 const meta = {
   title: 'plugins/plugin-preview/Card',
   render: Defaultstory,
   decorators: [
-    withTheme,
-    withLayout({
-      fullscreen: true,
-      classNames: 'flex flex-col justify-center',
-    }),
+    withTheme, // TODO(wittjosiah): Try to write story which does not depend on plugin manager.
+    withPluginManager({ plugins: [IntentPlugin()] }),
   ],
-  parameters: { translations },
+  parameters: {
+    layout: 'fullscreen',
+    translations,
+  },
   tags: ['cards'],
 } satisfies Meta<typeof Defaultstory>;
 

package/src/stories/testing.tsx

@@ -9,12 +9,10 @@ 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 { ContactCard, OrganizationCard, ProjectCard, TaskCard } from '../cards';
 import { type PreviewProps } from '../types';
 
-faker.seed(1234);
-
-type CardProps<T extends object> = {
+type CardProps<T extends Obj.Any> = {
   Component: FC<PreviewProps<T>>;
   subject: T;
   icon?: string;
@@ -28,14 +26,16 @@ export type DefaultstoryProps = {
 
 export const Defaultstory = ({ role, cards }: DefaultstoryProps) => {
   return (
-    <div className='grid grid-cols-3'>
-      {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 className='flex bs-full'>
+      <div className='flex shrink-0 gap-8 overflow-x-auto pbe-4'>
+        {cards.map(({ Component, icon, image, subject }, i) => (
+          <div key={i} className='flex is-[24rem] justify-center'>
+            <CardContainer icon={icon} role={role}>
+              <Component role={role} subject={image ? subject : omitImage(subject)} />
+            </CardContainer>
+          </div>
+        ))}
+      </div>
     </div>
   );
 };
@@ -73,12 +73,17 @@ export const createCards = (image = true): CardProps<any>[] => {
     ],
   });
 
-  const project = Obj.make(DataType.Project, {
+  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,
@@ -98,5 +103,11 @@ export const createCards = (image = true): CardProps<any>[] => {
       icon: 'ph--building--regular',
       image,
     },
+    {
+      Component: TaskCard,
+      subject: task,
+      icon: 'ph--list-checks--regular',
+      image,
+    },
   ];
 };

package/src/translations.ts

@@ -11,6 +11,12 @@ 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',
+        'open object label': 'Open',
+        'add object to space label': 'Add to space',
+        'more options label': 'More options',
       },
     },
   },

package/src/types.ts

@@ -2,10 +2,14 @@
 // Copyright 2025 DXOS.org
 //
 
-import { type Schema } from 'effect';
 import { type PropsWithChildren } from 'react';
 
-export type PreviewProps<T extends Schema.Schema.Type<any>> = PropsWithChildren<{
+import { type Obj } from '@dxos/echo';
+import { type Space } from '@dxos/react-client/echo';
+
+export type PreviewProps<T extends Obj.Any = Obj.Any> = PropsWithChildren<{
   subject: T;
   role?: string;
+  activeSpace?: Space;
+  onSelect?: (obj: Obj.Any) => void;
 }>;

package/dist/lib/browser/chunk-Z73ENKLE.mjs

@@ -1,14 +0,0 @@
-// src/meta.ts
-var PREVIEW_PLUGIN = "dxos.org/plugin/preview";
-var meta = {
-  id: PREVIEW_PLUGIN,
-  name: "Preview",
-  icon: "ph--eye--regular",
-  source: "https://github.com/dxos/dxos/tree/main/packages/plugins/plugin-preview"
-};
-
-export {
-  PREVIEW_PLUGIN,
-  meta
-};
-//# sourceMappingURL=chunk-Z73ENKLE.mjs.map

package/dist/lib/browser/chunk-Z73ENKLE.mjs.map

@@ -1,7 +0,0 @@
-{
-  "version": 3,
-  "sources": ["../../../src/meta.ts"],
-  "sourcesContent": ["//\n// Copyright 2023 DXOS.org\n//\n\nimport { type PluginMeta } from '@dxos/app-framework';\n\nexport const PREVIEW_PLUGIN = 'dxos.org/plugin/preview';\n\nexport const meta: PluginMeta = {\n  id: PREVIEW_PLUGIN,\n  name: 'Preview',\n  icon: 'ph--eye--regular',\n  source: 'https://github.com/dxos/dxos/tree/main/packages/plugins/plugin-preview',\n};\n"],
-  "mappings": ";AAMO,IAAMA,iBAAiB;AAEvB,IAAMC,OAAmB;EAC9BC,IAAIF;EACJG,MAAM;EACNC,MAAM;EACNC,QAAQ;AACV;",
-  "names": ["PREVIEW_PLUGIN", "meta", "id", "name", "icon", "source"]
-}

package/dist/lib/browser/preview-popover-MAIBTJKJ.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, type PluginContext, contributes, createIntent } from '@dxos/app-framework';\nimport { addEventListener } from '@dxos/async';\nimport { type Client, resolveRef } from '@dxos/client';\nimport { type Space, parseId } 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,cAAkCC,aAAaC,oBAAoB;AAC1F,SAASC,wBAAwB;AACjC,SAAsBC,kBAAkB;AACxC,SAAqBC,eAAe;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"]
-}