@dxos/plugin-presenter 0.8.4-main.fcfe5033a5 → 0.8.4-staging.60fe92afc8

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dxos/plugin-presenter",
-  "version": "0.8.4-main.fcfe5033a5",
+  "version": "0.8.4-staging.60fe92afc8",
   "description": "Braneframe presenter plugin",
   "homepage": "https://dxos.org",
   "bugs": "https://github.com/dxos/dxos/issues",
@@ -8,41 +8,79 @@
     "type": "git",
     "url": "https://github.com/dxos/dxos"
   },
-  "license": "MIT",
+  "license": "FSL-1.1-Apache-2.0",
   "author": "DXOS.org",
   "sideEffects": true,
   "type": "module",
   "imports": {
-    "#capabilities": "./src/capabilities/index.ts",
-    "#components": "./src/components/index.ts",
-    "#containers": "./src/containers/index.ts",
-    "#meta": "./src/meta.ts",
-    "#operations": "./src/operations/index.ts",
+    "#capabilities": {
+      "source": "./src/capabilities/index.ts",
+      "types": "./dist/types/src/capabilities/index.d.ts",
+      "default": "./dist/lib/neutral/capabilities/index.mjs"
+    },
+    "#components": {
+      "source": "./src/components/index.ts",
+      "types": "./dist/types/src/components/index.d.ts",
+      "default": "./dist/lib/neutral/components/index.mjs"
+    },
+    "#containers": {
+      "source": "./src/containers/index.ts",
+      "types": "./dist/types/src/containers/index.d.ts",
+      "default": "./dist/lib/neutral/containers/index.mjs"
+    },
+    "#meta": {
+      "source": "./src/meta.ts",
+      "types": "./dist/types/src/meta.d.ts",
+      "default": "./dist/lib/neutral/meta.mjs"
+    },
+    "#plugin": {
+      "source": {
+        "workerd": "./src/PresenterPlugin.workerd.ts",
+        "node": "./src/PresenterPlugin.node.ts",
+        "default": "./src/PresenterPlugin.tsx"
+      },
+      "types": "./dist/types/src/PresenterPlugin.d.ts",
+      "workerd": "./dist/lib/neutral/PresenterPlugin.workerd.mjs",
+      "node": "./dist/lib/neutral/PresenterPlugin.node.mjs",
+      "default": "./dist/lib/neutral/PresenterPlugin.mjs"
+    },
     "#testing": "./src/testing.ts",
-    "#types": "./src/types/index.ts"
+    "#translations": {
+      "source": "./src/translations.ts",
+      "types": "./dist/types/src/translations.d.ts",
+      "default": "./dist/lib/neutral/translations.mjs"
+    },
+    "#types": {
+      "source": "./src/types/index.ts",
+      "types": "./dist/types/src/types/index.d.ts",
+      "default": "./dist/lib/neutral/types/index.mjs"
+    }
   },
   "exports": {
     ".": {
       "source": "./src/index.ts",
-      "browser": "./dist/lib/browser/index.mjs",
-      "types": "./dist/types/src/index.d.ts"
+      "types": "./dist/types/src/index.d.ts",
+      "default": "./dist/lib/neutral/index.mjs"
     },
-    "./operations": {
-      "source": "./src/operations/index.ts",
-      "types": "./dist/types/src/operations/index.d.ts",
-      "browser": "./dist/lib/browser/operations/index.mjs"
+    "./assets/PLUGIN.mdl": "./PLUGIN.mdl",
+    "./plugin": {
+      "source": "./src/plugin.ts",
+      "types": "./dist/types/src/plugin.d.ts",
+      "default": "./dist/lib/neutral/plugin.mjs"
+    },
+    "./translations": {
+      "source": "./src/translations.ts",
+      "types": "./dist/types/src/translations.d.ts",
+      "default": "./dist/lib/neutral/translations.mjs"
     }
   },
   "types": "dist/types/src/index.d.ts",
-  "typesVersions": {
-    "*": {}
-  },
   "files": [
     "dist",
-    "src"
+    "src",
+    "PLUGIN.mdl"
   ],
   "dependencies": {
-    "@effect-atom/atom": "^0.5.1",
     "@effect-atom/atom-react": "^0.5.0",
     "hastscript": "^7.1.0",
     "highlight.js": "^11.9.0",
@@ -54,50 +92,45 @@
     "remark-frontmatter": "^5.0.0",
     "remark-parse-frontmatter": "^1.0.3",
     "reveal.js": "^5.1.0",
-    "@dxos/app-framework": "0.8.4-main.fcfe5033a5",
-    "@dxos/async": "0.8.4-main.fcfe5033a5",
-    "@dxos/app-toolkit": "0.8.4-main.fcfe5033a5",
-    "@dxos/echo": "0.8.4-main.fcfe5033a5",
-    "@dxos/log": "0.8.4-main.fcfe5033a5",
-    "@dxos/effect": "0.8.4-main.fcfe5033a5",
-    "@dxos/operation": "0.8.4-main.fcfe5033a5",
-    "@dxos/plugin-client": "0.8.4-main.fcfe5033a5",
-    "@dxos/plugin-deck": "0.8.4-main.fcfe5033a5",
-    "@dxos/plugin-markdown": "0.8.4-main.fcfe5033a5",
-    "@dxos/plugin-graph": "0.8.4-main.fcfe5033a5",
-    "@dxos/plugin-stack": "0.8.4-main.fcfe5033a5",
-    "@dxos/react-client": "0.8.4-main.fcfe5033a5",
-    "@dxos/react-ui-attention": "0.8.4-main.fcfe5033a5",
-    "@dxos/react-ui-form": "0.8.4-main.fcfe5033a5",
-    "@dxos/react-ui-mosaic": "0.8.4-main.fcfe5033a5",
-    "@dxos/schema": "0.8.4-main.fcfe5033a5",
-    "@dxos/react-ui-stack": "0.8.4-main.fcfe5033a5",
-    "@dxos/types": "0.8.4-main.fcfe5033a5",
-    "@dxos/util": "0.8.4-main.fcfe5033a5"
+    "@dxos/app-framework": "0.8.4-staging.60fe92afc8",
+    "@dxos/app-toolkit": "0.8.4-staging.60fe92afc8",
+    "@dxos/compute": "0.8.4-staging.60fe92afc8",
+    "@dxos/keys": "0.8.4-staging.60fe92afc8",
+    "@dxos/echo": "0.8.4-staging.60fe92afc8",
+    "@dxos/effect": "0.8.4-staging.60fe92afc8",
+    "@dxos/log": "0.8.4-staging.60fe92afc8",
+    "@dxos/plugin-client": "0.8.4-staging.60fe92afc8",
+    "@dxos/plugin-deck": "0.8.4-staging.60fe92afc8",
+    "@dxos/plugin-graph": "0.8.4-staging.60fe92afc8",
+    "@dxos/react-ui-attention": "0.8.4-staging.60fe92afc8",
+    "@dxos/react-ui-form": "0.8.4-staging.60fe92afc8",
+    "@dxos/util": "0.8.4-staging.60fe92afc8",
+    "@dxos/plugin-markdown": "0.8.4-staging.60fe92afc8"
   },
   "devDependencies": {
     "@effect-atom/atom-react": "^0.5.0",
-    "@effect/platform": "0.94.4",
+    "@effect/platform": "0.96.1",
     "@types/react": "~19.2.7",
     "@types/react-dom": "~19.2.3",
     "@types/reveal.js": "^5.0.3",
-    "effect": "3.20.0",
+    "effect": "3.21.3",
     "react": "~19.2.3",
     "react-dom": "~19.2.3",
-    "vite": "^7.1.11",
-    "@dxos/react-ui": "0.8.4-main.fcfe5033a5",
-    "@dxos/random": "0.8.4-main.fcfe5033a5",
-    "@dxos/storybook-utils": "0.8.4-main.fcfe5033a5",
-    "@dxos/ui-theme": "0.8.4-main.fcfe5033a5"
+    "vite": "^8.0.16",
+    "@dxos/random": "0.8.4-staging.60fe92afc8",
+    "@dxos/plugin-testing": "0.8.4-staging.60fe92afc8",
+    "@dxos/react-ui": "0.8.4-staging.60fe92afc8",
+    "@dxos/storybook-utils": "0.8.4-staging.60fe92afc8",
+    "@dxos/ui-theme": "0.8.4-staging.60fe92afc8"
   },
   "peerDependencies": {
     "@effect-atom/atom-react": "^0.5.0",
-    "@effect/platform": "0.94.4",
-    "effect": "3.20.0",
+    "@effect/platform": "0.96.1",
+    "effect": "3.21.3",
     "react": "~19.2.3",
     "react-dom": "~19.2.3",
-    "@dxos/react-ui": "0.8.4-main.fcfe5033a5",
-    "@dxos/ui-theme": "0.8.4-main.fcfe5033a5"
+    "@dxos/ui-theme": "0.8.4-staging.60fe92afc8",
+    "@dxos/react-ui": "0.8.4-staging.60fe92afc8"
   },
   "publishConfig": {
     "access": "public"

package/src/PresenterPlugin.node.ts

@@ -0,0 +1,16 @@
+//
+// Copyright 2023 DXOS.org
+//
+
+import { Plugin } from '@dxos/app-framework';
+import { AppPlugin } from '@dxos/app-toolkit';
+
+import { AppGraphBuilder } from '#capabilities';
+import { meta } from '#meta';
+
+export const PresenterPlugin = Plugin.define(meta).pipe(
+  AppPlugin.addAppGraphModule({ activate: AppGraphBuilder }),
+  Plugin.make,
+);
+
+export default PresenterPlugin;

package/src/PresenterPlugin.test.ts

@@ -0,0 +1,23 @@
+//
+// Copyright 2026 DXOS.org
+//
+
+import { describe, test } from 'vitest';
+
+import { createComposerTestApp } from '@dxos/plugin-testing/harness';
+
+import { PresenterPlugin } from '#plugin';
+
+import { meta } from './meta';
+
+const moduleId = (name: string) => `${meta.id}.module.${name}`;
+
+describe('PresenterPlugin', () => {
+  test('modules activate on the expected events', async ({ expect }) => {
+    await using harness = await createComposerTestApp({
+      plugins: [PresenterPlugin()],
+    });
+
+    expect(harness.manager.getActive()).toContain(moduleId('AppGraphBuilder'));
+  });
+});

package/src/PresenterPlugin.tsx

@@ -7,8 +7,10 @@ import { AppPlugin } from '@dxos/app-toolkit';
 
 import { AppGraphBuilder, PresenterSettings, ReactSurface } from '#capabilities';
 import { meta } from '#meta';
+import { translations } from '#translations';
 
-import { translations } from './translations';
+// eslint-disable-next-line import/no-relative-packages
+import pluginSpec from '../PLUGIN.mdl?raw';
 
 // TODO(burdon): Only scale markdown content.
 // TODO(burdon): Map stack content; Slide content type (e.g., markdown, sketch, IPFS image, table, etc.)
@@ -18,5 +20,10 @@ export const PresenterPlugin = Plugin.define(meta).pipe(
   AppPlugin.addSettingsModule({ activate: PresenterSettings }),
   AppPlugin.addSurfaceModule({ activate: ReactSurface }),
   AppPlugin.addTranslationsModule({ translations }),
+  AppPlugin.addPluginAssetModule({
+    asset: { pluginId: meta.id, path: 'PLUGIN.mdl', content: pluginSpec, mimeType: 'application/x-mdl' },
+  }),
   Plugin.make,
 );
+
+export default PresenterPlugin;

package/src/PresenterPlugin.workerd.ts

@@ -0,0 +1,11 @@
+//
+// Copyright 2023 DXOS.org
+//
+
+import { Plugin } from '@dxos/app-framework';
+
+import { meta } from '#meta';
+
+export const PresenterPlugin = Plugin.define(meta).pipe(Plugin.make);
+
+export default PresenterPlugin;

package/src/capabilities/app-graph-builder.ts

@@ -7,17 +7,15 @@ import * as Option from 'effect/Option';
 
 import { Capabilities, Capability } from '@dxos/app-framework';
 import { AppCapabilities, AppNode, LayoutOperation, getObjectPathFromObject, getSpacePath } from '@dxos/app-toolkit';
-import { Obj } from '@dxos/echo';
-import { Collection } from '@dxos/echo';
-import { Operation } from '@dxos/operation';
-import { DeckCapabilities } from '@dxos/plugin-deck';
-import { DeckOperation } from '@dxos/plugin-deck/operations';
+import { Operation } from '@dxos/compute';
+import { Collection, Obj } from '@dxos/echo';
+import { DeckCapabilities, DeckOperation } from '@dxos/plugin-deck';
 import { GraphBuilder, type Node, NodeMatcher } from '@dxos/plugin-graph';
-import { Markdown } from '@dxos/plugin-markdown/types';
+import { Markdown } from '@dxos/plugin-markdown';
 import { linkedSegment } from '@dxos/react-ui-attention';
 
 import { meta } from '#meta';
-import { PresenterOperation } from '#operations';
+import { PresenterOperation } from '#types';
 import { PresenterCapabilities } from '#types';
 
 /** Match nodes that can be presented (Collection or Document). */

package/src/capabilities/react-surface.tsx

@@ -8,12 +8,11 @@ import React from 'react';
 import { Capabilities, Capability } from '@dxos/app-framework';
 import { Surface, useSettingsState } from '@dxos/app-framework/ui';
 import { AppSurface } from '@dxos/app-toolkit/ui';
-import { Obj } from '@dxos/echo';
-import { Collection } from '@dxos/echo';
-import { Markdown } from '@dxos/plugin-markdown/types';
+import { Collection, Obj } from '@dxos/echo';
+import { Markdown } from '@dxos/plugin-markdown';
 
 import { PresenterSettings } from '#components';
-import { CollectionPresenterContainer, DocumentPresenterContainer, MarkdownSlide } from '#containers';
+import { CollectionPresenterArticle, DocumentPresenterContainer, MarkdownSlide } from '#containers';
 import { meta } from '#meta';
 import { type Settings } from '#types';
 
@@ -22,7 +21,7 @@ export default Capability.makeModule(() =>
     Capability.contributes(Capabilities.ReactSurface, [
       Surface.create({
         id: 'document',
-        position: 'hoist',
+        position: 'first',
         filter: AppSurface.predicate(
           AppSurface.Article,
           (data): data is AppSurface.ArticleData<{ type: typeof meta.id; object: Markdown.Document }> =>
@@ -37,7 +36,7 @@ export default Capability.makeModule(() =>
       }),
       Surface.create({
         id: 'collection',
-        position: 'hoist',
+        position: 'first',
         filter: AppSurface.predicate(
           AppSurface.Article,
           (data): data is AppSurface.ArticleData<{ type: typeof meta.id; object: Collection.Collection }> =>
@@ -48,7 +47,7 @@ export default Capability.makeModule(() =>
             data.subject.type === meta.id &&
             Obj.instanceOf(Collection.Collection, data.subject.object),
         ),
-        component: ({ role, data }) => <CollectionPresenterContainer role={role} subject={data.subject.object} />,
+        component: ({ role, data }) => <CollectionPresenterArticle role={role} subject={data.subject.object} />,
       }),
       Surface.create({
         id: 'slide',
@@ -56,7 +55,7 @@ export default Capability.makeModule(() =>
         component: ({ data }) => <MarkdownSlide document={data.subject} />,
       }),
       Surface.create({
-        id: 'plugin-settings',
+        id: 'pluginSettings',
         filter: AppSurface.settings(AppSurface.Article, meta.id),
         component: ({ data: { subject } }) => {
           const { settings, updateSettings } = useSettingsState<Settings.Settings>(subject.atom);

package/src/components/Presenter/Layout.tsx

@@ -4,7 +4,7 @@
 
 import React, { type PropsWithChildren, type ReactNode } from 'react';
 
-import { composable, composableProps } from '@dxos/ui-theme';
+import { composable, composableProps } from '@dxos/react-ui';
 
 export type LayoutProps = PropsWithChildren<{
   topLeft?: ReactNode;

package/src/components/PresenterSettings/PresenterSettings.stories.tsx

@@ -6,7 +6,8 @@ import { type Meta, type StoryObj } from '@storybook/react-vite';
 
 import { withLayout, withTheme } from '@dxos/react-ui/testing';
 
-import { translations } from '../../translations';
+import { translations } from '#translations';
+
 import { PresenterSettings } from './PresenterSettings';
 
 const meta = {

package/src/components/PresenterSettings/PresenterSettings.tsx

@@ -5,11 +5,11 @@
 import React from 'react';
 
 import { type AppSurface } from '@dxos/app-toolkit/ui';
-import { Input, useTranslation } from '@dxos/react-ui';
+import { useTranslation } from '@dxos/react-ui';
 import { Settings as SettingsForm } from '@dxos/react-ui-form';
 
 import { meta } from '#meta';
-import { type Settings } from '#types';
+import { Settings } from '#types';
 
 export type PresenterSettingsProps = AppSurface.SettingsArticleProps<Settings.Settings>;
 
@@ -19,13 +19,12 @@ export const PresenterSettings = ({ settings, onSettingsChange }: PresenterSetti
   return (
     <SettingsForm.Viewport>
       <SettingsForm.Section title={t('settings.title', { ns: meta.id })}>
-        <SettingsForm.Item title={t('present-collections.label')} description={t('present-collections.description')}>
-          <Input.Switch
-            disabled={!onSettingsChange}
-            checked={settings.presentCollections}
-            onCheckedChange={(checked) => onSettingsChange?.((s) => ({ ...s, presentCollections: !!checked }))}
-          />
-        </SettingsForm.Item>
+        <SettingsForm.FieldSet
+          readonly={!onSettingsChange}
+          schema={Settings.Settings}
+          values={settings}
+          onValuesChanged={(values) => onSettingsChange?.(() => values)}
+        />
       </SettingsForm.Section>
     </SettingsForm.Viewport>
   );

package/src/components/RevealPlayer/RevealPlayer.stories.tsx

@@ -6,8 +6,9 @@ import { type Meta } from '@storybook/react-vite';
 
 import { withLayout, withTheme } from '@dxos/react-ui/testing';
 
+import { translations } from '#translations';
+
 import CONTENT from '../../../testing/deck.md?raw';
-import { translations } from '../../translations';
 import { RevealPlayer } from './RevealPlayer';
 
 // https://revealjs.com/markdown

package/src/components/RevealPlayer/RevealPlayer.tsx

@@ -16,7 +16,7 @@ import RevealHighlight from 'reveal.js/plugin/highlight/highlight';
 import RevealMarkdown from 'reveal.js/plugin/markdown/plugin.js';
 
 import { useAsyncEffect } from '@dxos/react-ui';
-import { composable, composableProps } from '@dxos/ui-theme';
+import { composable, composableProps } from '@dxos/react-ui';
 
 const styles = `
 <style type="text/css">
@@ -152,7 +152,7 @@ export const RevealPlayer = composable<HTMLDivElement, RevealProps>(
         })}
         ref={forwardedRef}
       >
-        <div role='none' className='relative aspect-video h-full w-full h-auto max-h-full overflow-hidden'>
+        <div className='relative aspect-video h-full w-full h-auto max-h-full overflow-hidden'>
           <div ref={deckDivRef} className='absolute inset-0 reveal'>
             {/* NOTE: Must be in head. */}
             <style>

package/src/containers/{CollectionPresenterContainer/CollectionPresenterContainer.tsx → CollectionPresenterArticle/CollectionPresenterArticle.tsx}

@@ -14,9 +14,9 @@ import { PresenterContext } from '#types';
 
 import { useExitPresenter } from '../../useExitPresenter';
 
-export type CollectionPresenterContainerProps = AppSurface.ObjectArticleProps<Collection.Collection>;
+export type CollectionPresenterArticleProps = AppSurface.ObjectArticleProps<Collection.Collection>;
 
-export const CollectionPresenterContainer = ({ role, subject: collection }: CollectionPresenterContainerProps) => {
+export const CollectionPresenterArticle = ({ role, subject: collection }: CollectionPresenterArticleProps) => {
   const [slide, setSlide] = useState(0);
   const { running } = useContext(PresenterContext);
   const handleExit = useExitPresenter(collection);
@@ -40,7 +40,7 @@ export const CollectionPresenterContainer = ({ role, subject: collection }: Coll
             type={AppSurface.Slide}
             data={{
               subject: collection.objects[slide],
-              attendableId: Obj.getDXN(collection).toString(),
+              attendableId: Obj.getURI(collection),
             }}
           />
         </PresenterLayout>

package/src/containers/CollectionPresenterArticle/index.ts

@@ -0,0 +1,5 @@
+//
+// Copyright 2023 DXOS.org
+//
+
+export { CollectionPresenterArticle as default } from './CollectionPresenterArticle';

package/src/containers/DocumentPresenterContainer/DocumentPresenterContainer.tsx

@@ -4,7 +4,7 @@
 
 import React, { type FC } from 'react';
 
-import { type Markdown } from '@dxos/plugin-markdown/types';
+import { type Markdown } from '@dxos/plugin-markdown';
 import { Panel } from '@dxos/react-ui';
 
 import { RevealPlayer } from '#components';

package/src/containers/MarkdownSlide/MarkdownSlide.tsx

@@ -4,7 +4,7 @@
 
 import React from 'react';
 
-import { type Markdown } from '@dxos/plugin-markdown/types';
+import { type Markdown } from '@dxos/plugin-markdown';
 
 import { Panel, Slide } from '#components';
 

package/src/containers/index.ts

@@ -4,6 +4,6 @@
 
 import { type ComponentType, lazy } from 'react';
 
-export const CollectionPresenterContainer: ComponentType<any> = lazy(() => import('./CollectionPresenterContainer'));
+export const CollectionPresenterArticle: ComponentType<any> = lazy(() => import('./CollectionPresenterArticle'));
 export const DocumentPresenterContainer: ComponentType<any> = lazy(() => import('./DocumentPresenterContainer'));
 export const MarkdownSlide: ComponentType<any> = lazy(() => import('./MarkdownSlide'));

package/src/index.ts

@@ -2,7 +2,5 @@
 // Copyright 2023 DXOS.org
 //
 
-export * from './components';
-
 export * from './meta';
-export * from './PresenterPlugin';
+export * from './types';

package/src/meta.ts

@@ -2,17 +2,36 @@
 // Copyright 2023 DXOS.org
 //
 
-import { type Plugin } from '@dxos/app-framework';
+import { Plugin } from '@dxos/app-framework';
+import { DXN } from '@dxos/keys';
 import { trim } from '@dxos/util';
 
-export const meta: Plugin.Meta = {
-  id: 'org.dxos.plugin.presenter',
+export const meta = Plugin.makeMeta({
+  key: DXN.make('org.dxos.plugin.presenter'),
   name: 'Presenter',
+  author: 'DXOS',
   description: trim`
-    Transform markdown documents into interactive presentation slideshows.
-    Navigate between slides with keyboard controls and present content in full-screen mode.
+    Transform existing workspace objects into interactive presentation slideshows without
+    duplicating content. Markdown documents are split into slides on horizontal \`---\`
+    separators and rendered with Reveal.js, giving authors a familiar authoring surface
+    with full Markdown syntax. Collections can optionally be presented slide-by-slide,
+    with each member object rendered by its own plugin surface.
+
+    Activate presentation mode for any supported object via the action menu or the
+    Shift+Cmd+P (macOS) / Shift+Alt+P (Windows/Linux) keyboard shortcut. The presenter
+    opens in a solo fullscreen layout managed by the Deck plugin, keeping the rest of the
+    workspace undisturbed.
+
+    Navigation controls and a page-number indicator are shown during collection
+    slideshows. Pressing Escape exits fullscreen and returns to the originating document
+    or collection view. All navigation is keyboard-accessible.
+
+    Collaboration is inherent: because slides are backed by live ECHO objects, edits made
+    by any peer in the workspace are immediately reflected in an open presentation without
+    any manual refresh.
   `,
   icon: 'ph--presentation--regular',
   iconHue: 'indigo',
   source: 'https://github.com/dxos/dxos/tree/main/packages/plugins/plugin-presenter',
-};
+  spec: 'PLUGIN.mdl',
+});

package/src/plugin.ts

@@ -0,0 +1,9 @@
+//
+// Copyright 2023 DXOS.org
+//
+
+import { Plugin } from '@dxos/app-framework';
+
+import { meta } from './meta';
+
+export const PresenterPlugin = Plugin.lazy(meta, () => import('#plugin'));

package/src/translations.ts

@@ -13,8 +13,6 @@ export const translations = [
         'plugin.name': 'Presenter',
         'settings.title': 'Presenter settings',
         'toggle-presentation.label': 'Present',
-        'present-collections.label': 'Present collections (experimental)',
-        'present-collections.description': 'Enable presenting collections of documents as a slideshow.',
       },
     },
   },

package/src/types/PresenterCapabilities.ts

@@ -0,0 +1,15 @@
+//
+// Copyright 2025 DXOS.org
+//
+
+// @import-as-namespace
+
+import { type Atom } from '@effect-atom/atom-react';
+
+import { Capability } from '@dxos/app-framework';
+
+import { meta } from '#meta';
+
+// Inline import to avoid `Settings` namespace alias colliding with the
+// `Settings` capability export below.
+export const Settings = Capability.make<Atom.Writable<import('./Settings').Settings>>(`${meta.id}.capability.settings`);

package/src/types/PresenterOperation.ts

@@ -0,0 +1,29 @@
+//
+// Copyright 2025 DXOS.org
+//
+
+// @import-as-namespace
+
+import * as Schema from 'effect/Schema';
+
+import { Operation } from '@dxos/compute';
+import { Collection, Type, DXN } from '@dxos/echo';
+import { Markdown } from '@dxos/plugin-markdown';
+
+import { meta } from '#meta';
+
+const makeKey = (name: string) => DXN.make(`${meta.id}.operation.${name}`);
+
+// TODO(wittjosiah): This appears to be unused.
+export const TogglePresentation = Operation.make({
+  meta: {
+    key: makeKey('togglePresentation'),
+    name: 'Toggle Presentation',
+    icon: 'ph--presentation--regular',
+  },
+  input: Schema.Struct({
+    object: Schema.Union(Type.getSchema(Markdown.Document), Type.getSchema(Collection.Collection)),
+    state: Schema.optional(Schema.Boolean),
+  }),
+  output: Schema.Void,
+});

package/src/types/Settings.ts

@@ -8,7 +8,12 @@ import * as Schema from 'effect/Schema';
 
 export const Settings = Schema.mutable(
   Schema.Struct({
-    presentCollections: Schema.optional(Schema.Boolean),
+    presentCollections: Schema.optional(
+      Schema.Boolean.annotations({
+        title: 'Present collections (experimental)',
+        description: 'Enable presenting collections of documents as a slideshow.',
+      }),
+    ),
   }),
 );