@dxos/plugin-markdown 0.7.4-staging.f7e8224 → 0.7.5-feature-compute.4d9d99a

package/dist/types/src/util.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"util.d.ts","sourceRoot":"","sources":["../../../src/util.tsx"],"names":[],"mappings":"AAIA,OAAO,EAAE,KAAK,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAElD,OAAO,EAAE,KAAK,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AAGtE,OAAO,EAAE,YAAY,EAAE,KAAK,kBAAkB,EAAE,KAAK,yBAAyB,EAAY,MAAM,SAAS,CAAC;AAE1G,eAAO,MAAM,oBAAoB,SAAU,OAAO,KAAG,IAAI,IAAI,kBAKhD,CAAC;AAEd,KAAK,uBAAuB,GAAG,MAAM,CAAC,yBAAyB,CAAC,CAAC;AAEjE,eAAO,MAAM,wBAAwB,YAAa,MAAM,EAAE,KAAG,uBAAuB,EAEnF,CAAC;AAIF,eAAO,MAAM,eAAe,YAAa,MAAM,WAE9C,CAAC;AAEF,eAAO,MAAM,eAAe,0BAKrB,CAAC;AAER,eAAO,MAAM,UAAU,EAAE,qBAAqB,CAAC,YAAY,CAY1D,CAAC"}
+{"version":3,"file":"util.d.ts","sourceRoot":"","sources":["../../../src/util.tsx"],"names":[],"mappings":"AAKA,OAAO,EAAE,KAAK,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AAItE,OAAO,EAAE,YAAY,EAAE,KAAK,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAEhE,eAAO,MAAM,oBAAoB,SAAU,OAAO,KAAG,IAAI,IAAI,kBAKhD,CAAC;AAId,eAAO,MAAM,eAAe,YAAa,MAAM,WAE9C,CAAC;AAEF,eAAO,MAAM,eAAe,0BAKrB,CAAC;AAER,eAAO,MAAM,UAAU,EAAE,qBAAqB,CAAC,YAAY,CAY1D,CAAC"}

package/dist/types/tsconfig.tsbuildinfo

@@ -0,0 +1 @@
+{"version":"5.7.2"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dxos/plugin-markdown",
-  "version": "0.7.4-staging.f7e8224",
+  "version": "0.7.5-feature-compute.4d9d99a",
   "description": "DXOS Surface plugin for interacting with Markdown",
   "homepage": "https://dxos.org",
   "bugs": "https://github.com/dxos/dxos/issues",
@@ -13,11 +13,6 @@
       "browser": "./dist/lib/browser/index.mjs",
       "node": "./dist/lib/node-esm/index.mjs"
     },
-    "./meta": {
-      "types": "./dist/types/src/meta.d.ts",
-      "browser": "./dist/lib/browser/meta.mjs",
-      "node": "./dist/lib/node-esm/meta.mjs"
-    },
     "./types": {
       "types": "./dist/types/src/types/index.d.ts",
       "browser": "./dist/lib/browser/types/index.mjs",
@@ -27,9 +22,6 @@
   "types": "dist/types/src/index.d.ts",
   "typesVersions": {
     "*": {
-      "meta": [
-        "dist/types/src/meta.d.ts"
-      ],
       "types": [
         "dist/types/src/types/index.d.ts"
       ]
@@ -44,28 +36,31 @@
     "@codemirror/view": "^6.34.1",
     "@effect/schema": "^0.75.5",
     "@preact/signals-core": "^1.6.0",
-    "@dxos/app-framework": "0.7.4-staging.f7e8224",
-    "@dxos/async": "0.7.4-staging.f7e8224",
-    "@dxos/echo-schema": "0.7.4-staging.f7e8224",
-    "@dxos/invariant": "0.7.4-staging.f7e8224",
-    "@dxos/live-object": "0.7.4-staging.f7e8224",
-    "@dxos/log": "0.7.4-staging.f7e8224",
-    "@dxos/local-storage": "0.7.4-staging.f7e8224",
-    "@dxos/keys": "0.7.4-staging.f7e8224",
-    "@dxos/plugin-attention": "0.7.4-staging.f7e8224",
-    "@dxos/plugin-client": "0.7.4-staging.f7e8224",
-    "@dxos/plugin-graph": "0.7.4-staging.f7e8224",
-    "@dxos/react-client": "0.7.4-staging.f7e8224",
-    "@dxos/plugin-space": "0.7.4-staging.f7e8224",
-    "@dxos/react-hooks": "0.7.4-staging.f7e8224",
-    "@dxos/plugin-theme": "0.7.4-staging.f7e8224",
-    "@dxos/react-ui-attention": "0.7.4-staging.f7e8224",
-    "@dxos/react-ui-card": "0.7.4-staging.f7e8224",
-    "@dxos/react-ui-form": "0.7.4-staging.f7e8224",
-    "@dxos/react-ui-editor": "0.7.4-staging.f7e8224",
-    "@dxos/react-ui-mosaic": "0.7.4-staging.f7e8224",
-    "@dxos/react-ui-stack": "0.7.4-staging.f7e8224",
-    "@dxos/util": "0.7.4-staging.f7e8224"
+    "effect": "^3.12.3",
+    "react-dropzone": "^14.2.3",
+    "@dxos/app-framework": "0.7.5-feature-compute.4d9d99a",
+    "@dxos/echo-schema": "0.7.5-feature-compute.4d9d99a",
+    "@dxos/async": "0.7.5-feature-compute.4d9d99a",
+    "@dxos/invariant": "0.7.5-feature-compute.4d9d99a",
+    "@dxos/keys": "0.7.5-feature-compute.4d9d99a",
+    "@dxos/live-object": "0.7.5-feature-compute.4d9d99a",
+    "@dxos/local-storage": "0.7.5-feature-compute.4d9d99a",
+    "@dxos/log": "0.7.5-feature-compute.4d9d99a",
+    "@dxos/plugin-attention": "0.7.5-feature-compute.4d9d99a",
+    "@dxos/plugin-client": "0.7.5-feature-compute.4d9d99a",
+    "@dxos/plugin-graph": "0.7.5-feature-compute.4d9d99a",
+    "@dxos/plugin-theme": "0.7.5-feature-compute.4d9d99a",
+    "@dxos/plugin-space": "0.7.5-feature-compute.4d9d99a",
+    "@dxos/react-client": "0.7.5-feature-compute.4d9d99a",
+    "@dxos/react-hooks": "0.7.5-feature-compute.4d9d99a",
+    "@dxos/react-ui-attention": "0.7.5-feature-compute.4d9d99a",
+    "@dxos/react-ui-card": "0.7.5-feature-compute.4d9d99a",
+    "@dxos/react-ui-form": "0.7.5-feature-compute.4d9d99a",
+    "@dxos/react-ui-editor": "0.7.5-feature-compute.4d9d99a",
+    "@dxos/react-ui-stack": "0.7.5-feature-compute.4d9d99a",
+    "@dxos/react-ui-mosaic": "0.7.5-feature-compute.4d9d99a",
+    "@dxos/schema": "0.7.5-feature-compute.4d9d99a",
+    "@dxos/util": "0.7.5-feature-compute.4d9d99a"
   },
   "devDependencies": {
     "@phosphor-icons/react": "^2.1.5",
@@ -74,17 +69,18 @@
     "react": "~18.2.0",
     "react-dom": "~18.2.0",
     "vite": "5.4.7",
-    "@dxos/react-ui": "0.7.4-staging.f7e8224",
-    "@dxos/random": "0.7.4-staging.f7e8224",
-    "@dxos/react-ui-theme": "0.7.4-staging.f7e8224",
-    "@dxos/storybook-utils": "0.7.4-staging.f7e8224"
+    "@dxos/debug": "0.7.5-feature-compute.4d9d99a",
+    "@dxos/random": "0.7.5-feature-compute.4d9d99a",
+    "@dxos/react-ui": "0.7.5-feature-compute.4d9d99a",
+    "@dxos/react-ui-theme": "0.7.5-feature-compute.4d9d99a",
+    "@dxos/storybook-utils": "0.7.5-feature-compute.4d9d99a"
   },
   "peerDependencies": {
     "@phosphor-icons/react": "^2.1.5",
     "react": "~18.2.0",
     "react-dom": "~18.2.0",
-    "@dxos/react-ui": "0.7.4-staging.f7e8224",
-    "@dxos/react-ui-theme": "0.7.4-staging.f7e8224"
+    "@dxos/react-ui": "0.7.5-feature-compute.4d9d99a",
+    "@dxos/react-ui-theme": "0.7.5-feature-compute.4d9d99a"
   },
   "publishConfig": {
     "access": "public"

package/src/MarkdownPlugin.tsx

@@ -1,89 +1,60 @@
 //
-// Copyright 2023 DXOS.org
+// Copyright 2025 DXOS.org
 //
 
-import { TextAa } from '@phosphor-icons/react';
-import React from 'react';
-
-import { parseIntentPlugin, resolvePlugin, NavigationAction, type PluginDefinition } from '@dxos/app-framework';
-import { create } from '@dxos/live-object';
-import { LocalStorageStore } from '@dxos/local-storage';
-import { parseClientPlugin } from '@dxos/plugin-client';
-import { type ActionGroup, createExtension, isActionGroup } from '@dxos/plugin-graph';
-import { SpaceAction } from '@dxos/plugin-space';
-import { CollectionType } from '@dxos/plugin-space/types';
-import {
-  createDocAccessor,
-  fullyQualifiedId,
-  getRangeFromCursor,
-  isSpace,
-  loadObjectReferences,
-} from '@dxos/react-client/echo';
 import {
-  type EditorInputMode,
-  type EditorViewMode,
-  EditorViewModes,
-  translations as editorTranslations,
-  createEditorStateStore,
-} from '@dxos/react-ui-editor';
+  Capabilities,
+  contributes,
+  createIntent,
+  defineModule,
+  definePlugin,
+  Events,
+  oneOf,
+} from '@dxos/app-framework';
+import { type BaseObject } from '@dxos/echo-schema';
+import { RefArray } from '@dxos/live-object';
+import { ClientCapabilities, ClientEvents } from '@dxos/plugin-client';
+import { translations as editorTranslations } from '@dxos/react-ui-editor';
+import { TextType } from '@dxos/schema';
 
-import { MarkdownContainer, MarkdownSettings } from './components';
-import meta, { MARKDOWN_PLUGIN } from './meta';
-import translations from './translations';
-import { DocumentType, isEditorModel, TextType } from './types';
 import {
-  type MarkdownPluginProvides,
-  type MarkdownSettingsProps,
-  MarkdownAction,
-  type MarkdownPluginState,
-} from './types';
-import { markdownExtensionPlugins, serializer } from './util';
-
-// TODO(burdon): Normalize active/object.
-const getDoc = (object: any) => (object instanceof DocumentType ? object : undefined);
-
-export const MarkdownPlugin = (): PluginDefinition<MarkdownPluginProvides> => {
-  const settings = new LocalStorageStore<MarkdownSettingsProps>(MARKDOWN_PLUGIN, {
-    defaultViewMode: 'preview',
-    toolbar: true,
-    numberedHeadings: true,
-    folding: true,
-    experimental: false,
-  });
-
-  const editorStateStore = createEditorStateStore(`${MARKDOWN_PLUGIN}/editor`);
-
-  const state = new LocalStorageStore<MarkdownPluginState>(MARKDOWN_PLUGIN, { extensionProviders: [], viewMode: {} });
-
-  const getViewMode = (id: string) => (id && state.values.viewMode[id]) || settings.values.defaultViewMode;
-  const setViewMode = (id: string, viewMode: EditorViewMode) => (state.values.viewMode[id] = viewMode);
-
-  return {
-    meta,
-    ready: async (plugins) => {
-      settings
-        .prop({ key: 'defaultViewMode', type: LocalStorageStore.enum<EditorViewMode>() })
-        .prop({ key: 'editorInputMode', type: LocalStorageStore.enum<EditorInputMode>({ allowUndefined: true }) })
-        .prop({ key: 'toolbar', type: LocalStorageStore.bool({ allowUndefined: true }) })
-        .prop({ key: 'experimental', type: LocalStorageStore.bool({ allowUndefined: true }) })
-        .prop({ key: 'debug', type: LocalStorageStore.bool({ allowUndefined: true }) })
-        .prop({ key: 'typewriter', type: LocalStorageStore.string({ allowUndefined: true }) })
-        .prop({ key: 'numberedHeadings', type: LocalStorageStore.bool({ allowUndefined: true }) })
-        .prop({ key: 'folding', type: LocalStorageStore.bool({ allowUndefined: true }) });
-
-      state.prop({ key: 'viewMode', type: LocalStorageStore.json<{ [key: string]: EditorViewMode }>() });
-
-      markdownExtensionPlugins(plugins).forEach((plugin) => {
-        const { extensions } = plugin.provides.markdown;
-        state.values.extensionProviders?.push(extensions);
-      });
-    },
-    provides: {
-      settings: settings.values,
-      metadata: {
-        records: {
-          [DocumentType.typename]: {
-            createObject: MarkdownAction.CREATE,
+  MarkdownState,
+  MarkdownSettings,
+  ReactSurface,
+  IntentResolver,
+  AppGraphSerializer,
+  Thread,
+} from './capabilities';
+import { MARKDOWN_PLUGIN, meta } from './meta';
+import translations from './translations';
+import { DocumentType, MarkdownAction } from './types';
+import { serializer } from './util';
+
+export const MarkdownPlugin = () =>
+  definePlugin(meta, [
+    defineModule({
+      id: `${meta.id}/module/settings`,
+      activatesOn: Events.SetupSettings,
+      activate: MarkdownSettings,
+    }),
+    defineModule({
+      id: `${meta.id}/module/state`,
+      activatesOn: Events.Startup,
+      activate: MarkdownState,
+    }),
+    defineModule({
+      id: `${meta.id}/module/translations`,
+      activatesOn: Events.SetupTranslations,
+      activate: () => contributes(Capabilities.Translations, [...translations, ...editorTranslations]),
+    }),
+    defineModule({
+      id: `${meta.id}/module/metadata`,
+      activatesOn: oneOf(Events.Startup, Events.SetupAppGraph),
+      activate: () =>
+        contributes(Capabilities.Metadata, {
+          id: DocumentType.typename,
+          metadata: {
+            createObject: (props: { name?: string }) => createIntent(MarkdownAction.Create, props),
             label: (object: any) => (object instanceof DocumentType ? object.name || object.fallbackName : undefined),
             placeholder: ['document title placeholder', { ns: MARKDOWN_PLUGIN }],
             icon: 'ph--text-aa--regular',
@@ -91,208 +62,38 @@ export const MarkdownPlugin = (): PluginDefinition<MarkdownPluginProvides> => {
               managesAutofocus: true,
             },
             // TODO(wittjosiah): Move out of metadata.
-            loadReferences: (doc: DocumentType) => loadObjectReferences(doc, (doc) => [doc.content, ...doc.threads]),
+            loadReferences: async (doc: DocumentType) =>
+              await RefArray.loadAll<BaseObject>([doc.content, ...doc.threads]),
             serializer,
           },
-        },
-      },
-      translations: [...translations, ...editorTranslations],
-      echo: {
-        schema: [DocumentType],
-        system: [TextType],
-      },
-      graph: {
-        builder: (plugins) => {
-          const client = resolvePlugin(plugins, parseClientPlugin)?.provides.client;
-          const dispatch = resolvePlugin(plugins, parseIntentPlugin)?.provides.intent.dispatch;
-          if (!client || !dispatch) {
-            return [];
-          }
-
-          return createExtension({
-            id: MarkdownAction.CREATE,
-            filter: (node): node is ActionGroup => isActionGroup(node) && node.id.startsWith(SpaceAction.ADD_OBJECT),
-            actions: ({ node }) => {
-              const id = node.id.split('/').at(-1);
-              const [spaceId, objectId] = id?.split(':') ?? [];
-              const space = client.spaces.get().find((space) => space.id === spaceId);
-              const object = objectId && space?.db.getObjectById(objectId);
-              const target = objectId ? object : space;
-              if (!target) {
-                return;
-              }
-
-              return [
-                {
-                  id: `${MARKDOWN_PLUGIN}/create/${node.id}`,
-                  data: async () => {
-                    await dispatch([
-                      { plugin: MARKDOWN_PLUGIN, action: MarkdownAction.CREATE },
-                      { action: SpaceAction.ADD_OBJECT, data: { target } },
-                      { action: NavigationAction.OPEN },
-                    ]);
-                  },
-                  properties: {
-                    label: ['create document label', { ns: MARKDOWN_PLUGIN }],
-                    icon: 'ph--text-aa--regular',
-                    testId: 'markdownPlugin.createObject',
-                  },
-                },
-              ];
-            },
-          });
-        },
-        serializer: (plugins) => {
-          const dispatch = resolvePlugin(plugins, parseIntentPlugin)?.provides.intent.dispatch;
-          if (!dispatch) {
-            return [];
-          }
-
-          return [
-            {
-              inputType: DocumentType.typename,
-              outputType: 'text/markdown',
-              // Reconcile with metadata serializers.
-              serialize: async (node) => {
-                const doc = node.data;
-                const content = await loadObjectReferences(doc, (doc) => doc.content);
-                return {
-                  name:
-                    doc.name ||
-                    doc.fallbackName ||
-                    translations[0]['en-US'][MARKDOWN_PLUGIN]['document title placeholder'],
-                  data: content.content,
-                  type: 'text/markdown',
-                };
-              },
-              deserialize: async (data, ancestors) => {
-                const space = ancestors.find(isSpace);
-                const target =
-                  ancestors.findLast((ancestor) => ancestor instanceof CollectionType) ??
-                  space?.properties[CollectionType.typename];
-                if (!space || !target) {
-                  return;
-                }
-
-                const result = await dispatch([
-                  {
-                    plugin: MARKDOWN_PLUGIN,
-                    action: MarkdownAction.CREATE,
-                    data: { name: data.name, content: data.data },
-                  },
-                  {
-                    action: SpaceAction.ADD_OBJECT,
-                    data: { target },
-                  },
-                ]);
-
-                return result?.data.object;
-              },
-            },
-          ];
-        },
-      },
-      stack: {
-        creators: [
-          {
-            id: 'create-stack-section-doc',
-            testId: 'markdownPlugin.createSection',
-            type: ['plugin name', { ns: MARKDOWN_PLUGIN }],
-            label: ['create stack section label', { ns: MARKDOWN_PLUGIN }],
-            icon: (props: any) => <TextAa {...props} />,
-            intent: {
-              plugin: MARKDOWN_PLUGIN,
-              action: MarkdownAction.CREATE,
-            },
-          },
-        ],
-      },
-      thread: {
-        predicate: (obj) => obj instanceof DocumentType,
-        createSort: (doc: DocumentType) => {
-          const accessor = doc.content ? createDocAccessor(doc.content, ['content']) : undefined;
-          if (!accessor) {
-            return (_) => 0;
-          }
-
-          const getStartPosition = (cursor: string | undefined) => {
-            const range = cursor ? getRangeFromCursor(accessor, cursor) : undefined;
-            return range?.start ?? Number.MAX_SAFE_INTEGER;
-          };
-
-          return (anchorA: string | undefined, anchorB: string | undefined): number => {
-            if (anchorA === undefined || anchorB === undefined) {
-              return 0;
-            }
-            const posA = getStartPosition(anchorA);
-            const posB = getStartPosition(anchorB);
-            return posA - posB;
-          };
-        },
-      },
-      surface: {
-        component: ({ data, role }) => {
-          switch (role) {
-            case 'section':
-            case 'article': {
-              const doc = getDoc(data.object);
-              const { id, object } = isEditorModel(data.object)
-                ? { id: data.object.id, object: data.object }
-                : doc
-                  ? { id: fullyQualifiedId(doc), object: doc }
-                  : {};
-
-              if (!id || !object) {
-                return null;
-              }
-
-              return (
-                <MarkdownContainer
-                  id={id}
-                  object={object}
-                  role={role}
-                  settings={settings.values}
-                  extensionProviders={state.values.extensionProviders}
-                  viewMode={getViewMode(id)}
-                  editorStateStore={editorStateStore}
-                  onViewModeChange={setViewMode}
-                />
-              );
-            }
-
-            case 'settings': {
-              return data.plugin === meta.id ? <MarkdownSettings settings={settings.values} /> : null;
-            }
-          }
-
-          return null;
-        },
-      },
-      intent: {
-        resolver: ({ action, data }) => {
-          switch (action) {
-            case MarkdownAction.CREATE: {
-              const doc = create(DocumentType, {
-                name: data?.name,
-                content: create(TextType, { content: data?.content ?? '' }),
-                threads: [],
-              });
-
-              return { data: doc };
-            }
-
-            case MarkdownAction.SET_VIEW_MODE: {
-              const { id, viewMode } = data ?? {};
-              if (typeof id === 'string' && EditorViewModes.includes(viewMode)) {
-                state.values.viewMode[id] = viewMode;
-                return { data: true };
-              }
-
-              break;
-            }
-          }
-        },
-      },
-    },
-  };
-};
+        }),
+    }),
+    defineModule({
+      id: `${meta.id}/module/schema`,
+      activatesOn: ClientEvents.SetupClient,
+      activate: () => [
+        contributes(ClientCapabilities.SystemSchema, [TextType]),
+        contributes(ClientCapabilities.Schema, [DocumentType]),
+      ],
+    }),
+    defineModule({
+      id: `${meta.id}/module/react-surface`,
+      activatesOn: Events.Startup,
+      activate: ReactSurface,
+    }),
+    defineModule({
+      id: `${meta.id}/module/intent-resolver`,
+      activatesOn: Events.SetupIntents,
+      activate: IntentResolver,
+    }),
+    defineModule({
+      id: `${meta.id}/module/app-graph-serializer`,
+      activatesOn: Events.Startup,
+      activate: AppGraphSerializer,
+    }),
+    defineModule({
+      id: `${meta.id}/module/thread`,
+      activatesOn: Events.Startup,
+      activate: Thread,
+    }),
+  ]);

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

@@ -0,0 +1,50 @@
+//
+// Copyright 2025 DXOS.org
+//
+
+import { pipe } from 'effect';
+
+import { contributes, Capabilities, type PluginsContext, chain, createIntent } from '@dxos/app-framework';
+import { SpaceAction, CollectionType } from '@dxos/plugin-space/types';
+import { isSpace } from '@dxos/react-client/echo';
+
+import { MARKDOWN_PLUGIN } from '../meta';
+import translations from '../translations';
+import { MarkdownAction, DocumentType } from '../types';
+
+export default (context: PluginsContext) =>
+  contributes(Capabilities.AppGraphSerializer, [
+    {
+      inputType: DocumentType.typename,
+      outputType: 'text/markdown',
+      // Reconcile with metadata serializers.
+      serialize: async (node) => {
+        const doc = node.data;
+        const content = await doc.content.load();
+        return {
+          name: doc.name || doc.fallbackName || translations[0]['en-US'][MARKDOWN_PLUGIN]['document title placeholder'],
+          data: content.content,
+          type: 'text/markdown',
+        };
+      },
+      deserialize: async (data, ancestors) => {
+        const space = ancestors.find(isSpace);
+        const target =
+          ancestors.findLast((ancestor) => ancestor instanceof CollectionType) ??
+          space?.properties[CollectionType.typename]?.target;
+        if (!space || !target) {
+          return;
+        }
+
+        const { dispatchPromise: dispatch } = context.requestCapability(Capabilities.IntentDispatcher);
+        const result = await dispatch(
+          pipe(
+            createIntent(MarkdownAction.Create, { name: data.name, content: data.data }),
+            chain(SpaceAction.AddObject, { target }),
+          ),
+        );
+
+        return result.data?.object;
+      },
+    },
+  ]);

package/src/capabilities/capabilities.ts

@@ -0,0 +1,20 @@
+//
+// Copyright 2025 DXOS.org
+//
+
+import { defineCapability } from '@dxos/app-framework';
+import { type EditorViewMode, type EditorStateStore } from '@dxos/react-ui-editor';
+
+import { MARKDOWN_PLUGIN } from '../meta';
+import { type MarkdownExtensionProvider, type MarkdownPluginState } from '../types';
+
+export namespace MarkdownCapabilities {
+  export const State = defineCapability<{
+    state: MarkdownPluginState;
+    editorState: EditorStateStore;
+    getViewMode: (id: string) => EditorViewMode;
+    setViewMode: (id: string, viewMode: EditorViewMode) => void;
+  }>(`${MARKDOWN_PLUGIN}/capability/state`);
+
+  export const Extensions = defineCapability<MarkdownExtensionProvider[]>(`${MARKDOWN_PLUGIN}/capability/extensions`);
+}

package/src/capabilities/index.ts

@@ -0,0 +1,14 @@
+//
+// Copyright 2025 DXOS.org
+//
+
+import { lazy } from '@dxos/app-framework';
+
+export const AppGraphSerializer = lazy(() => import('./app-graph-serializer'));
+export const IntentResolver = lazy(() => import('./intent-resolver'));
+export const ReactSurface = lazy(() => import('./react-surface'));
+export const MarkdownSettings = lazy(() => import('./settings'));
+export const MarkdownState = lazy(() => import('./state'));
+export const Thread = lazy(() => import('./thread'));
+
+export * from './capabilities';

package/src/capabilities/intent-resolver.ts

@@ -0,0 +1,27 @@
+//
+// Copyright 2025 DXOS.org
+//
+
+import { Capabilities, contributes, createResolver, type PluginsContext } from '@dxos/app-framework';
+import { makeRef, create } from '@dxos/live-object';
+import { TextType } from '@dxos/schema';
+
+import { MarkdownCapabilities } from './capabilities';
+import { DocumentType, MarkdownAction } from '../types';
+
+export default (context: PluginsContext) =>
+  contributes(Capabilities.IntentResolver, [
+    createResolver(MarkdownAction.Create, ({ name, content }) => {
+      const doc = create(DocumentType, {
+        name,
+        content: makeRef(create(TextType, { content: content ?? '' })),
+        threads: [],
+      });
+
+      return { data: { object: doc } };
+    }),
+    createResolver(MarkdownAction.SetViewMode, ({ id, viewMode }) => {
+      const { state } = context.requestCapability(MarkdownCapabilities.State);
+      state.viewMode[id] = viewMode;
+    }),
+  ]);