@dxos/plugin-markdown 0.8.4-main.4a85c3132b → 0.8.4-main.51f1e5ca51

package/src/blueprints/functions/update.ts

@@ -1,79 +0,0 @@
-//
-// Copyright 2025 DXOS.org
-//
-
-import { next as A, type Doc } from '@automerge/automerge';
-import * as Effect from 'effect/Effect';
-import * as Schema from 'effect/Schema';
-
-import { Database, Ref } from '@dxos/echo';
-import { DocAccessor, createDocAccessor } from '@dxos/echo-db';
-import { defineFunction } from '@dxos/functions';
-import { trim } from '@dxos/util';
-
-import { Markdown } from '../../types';
-
-const Edit = Schema.Struct({
-  oldString: Schema.String.annotations({
-    description: 'The text to find in the document.',
-  }),
-  newString: Schema.String.annotations({
-    description: 'The text to replace it with.',
-  }),
-  replaceAll: Schema.optional(Schema.Boolean).annotations({
-    description: 'If true, replaces all occurrences. Defaults to false (first occurrence only).',
-  }),
-});
-
-// TODO(wittjosiah): Reconcile with ThreadAction.AddProposal.
-// Based on opencode's MutilEdit tool: https://deepwiki.com/search/how-does-text-edit-tool-work_a159bc76-5401-424e-b29f-f087d1ea4f78
-export default defineFunction({
-  key: 'dxos.org/function/markdown/update',
-  name: 'Update',
-  description: trim`
-    Applies a set of edits to the markdown document.
-  `,
-  inputSchema: Schema.Struct({
-    doc: Ref.Ref(Markdown.Document).annotations({
-      description: 'The ID of the markdown document.',
-    }),
-    edits: Schema.Array(Edit).annotations({
-      description: 'The edits to apply to the document. Each edit finds oldString and replaces it with newString.',
-    }),
-  }),
-  outputSchema: Schema.Struct({
-    newContent: Schema.String,
-  }),
-  handler: Effect.fn(function* ({ data: { doc, edits } }) {
-    const content = yield* doc.pipe(
-      Database.load,
-      Effect.map((_) => _.content),
-      Effect.flatMap(Database.load),
-    );
-    const accessor = createDocAccessor(content, ['content']);
-
-    for (const edit of edits) {
-      accessor.handle.change((doc: Doc<typeof content>) => {
-        const text = DocAccessor.getValue<string>(accessor);
-        if (edit.replaceAll) {
-          let idx = text.indexOf(edit.oldString);
-          while (idx !== -1) {
-            A.splice(doc, accessor.path as A.Prop[], idx, edit.oldString.length, edit.newString);
-            const updated = DocAccessor.getValue<string>(accessor);
-            idx = updated.indexOf(edit.oldString, idx + edit.newString.length);
-          }
-        } else {
-          const idx = text.indexOf(edit.oldString);
-          if (idx === -1) {
-            throw new Error(`Edit not found: ${JSON.stringify(edit.oldString)}`);
-          }
-          A.splice(doc, accessor.path as A.Prop[], idx, edit.oldString.length, edit.newString);
-        }
-      });
-    }
-
-    return {
-      newContent: DocAccessor.getValue<string>(accessor),
-    };
-  }),
-});

package/src/capabilities/anchor-sort/index.ts

@@ -1,7 +0,0 @@
-//
-// Copyright 2025 DXOS.org
-//
-
-import { Capability } from '@dxos/app-framework';
-
-export const AnchorSort = Capability.lazy('AnchorSort', () => import('./anchor-sort'));

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

@@ -1,7 +0,0 @@
-//
-// Copyright 2025 DXOS.org
-//
-
-import { Capability } from '@dxos/app-framework';
-
-export const AppGraphSerializer = Capability.lazy('AppGraphSerializer', () => import('./app-graph-serializer'));

package/src/capabilities/artifact-definition/index.ts

@@ -1,7 +0,0 @@
-//
-// Copyright 2025 DXOS.org
-//
-
-import { Capability } from '@dxos/app-framework';
-
-export const ArtifactDefinition = Capability.lazy('ArtifactDefinition', () => import('./artifact-definition'));

package/src/capabilities/blueprint-definition/index.ts

@@ -1,7 +0,0 @@
-//
-// Copyright 2025 DXOS.org
-//
-
-import { Capability } from '@dxos/app-framework';
-
-export const BlueprintDefinition = Capability.lazy('BlueprintDefinition', () => import('./blueprint-definition'));

package/src/capabilities/operation-resolver/index.ts

@@ -1,7 +0,0 @@
-//
-// Copyright 2025 DXOS.org
-//
-
-import { Capability } from '@dxos/app-framework';
-
-export const OperationResolver = Capability.lazy('OperationResolver', () => import('./operation-resolver'));

package/src/capabilities/operation-resolver/operation-resolver.ts

@@ -1,45 +0,0 @@
-//
-// Copyright 2025 DXOS.org
-//
-
-import * as Effect from 'effect/Effect';
-
-import { Capabilities, Capability } from '@dxos/app-framework';
-import { Obj, Ref, Type } from '@dxos/echo';
-import { OperationResolver } from '@dxos/operation';
-import { ManagedCollection } from '@dxos/schema';
-
-import { Markdown, MarkdownCapabilities, MarkdownOperation } from '../../types';
-
-export default Capability.makeModule(
-  Effect.fnUntraced(function* () {
-    return Capability.contributes(Capabilities.OperationResolver, [
-      OperationResolver.make({
-        operation: MarkdownOperation.OnCreateSpace,
-        handler: Effect.fnUntraced(function* ({ rootCollection }) {
-          const collection = ManagedCollection.makeManagedCollection({ key: Type.getTypename(Markdown.Document) });
-          Obj.change(rootCollection, (c) => {
-            c.objects.push(Ref.make(collection));
-          });
-        }),
-      }),
-      OperationResolver.make({
-        operation: MarkdownOperation.Create,
-        handler: ({ name, content }) =>
-          Effect.succeed({
-            object: Markdown.make({ name, content }),
-          }),
-      }),
-      // TODO(wittjosiah): This appears to be unused.
-      OperationResolver.make({
-        operation: MarkdownOperation.SetViewMode,
-        handler: Effect.fnUntraced(function* ({ id, viewMode }) {
-          yield* Capabilities.updateAtomValue(MarkdownCapabilities.State, (current) => ({
-            ...current,
-            viewMode: { ...current.viewMode, [id]: viewMode },
-          }));
-        }),
-      }),
-    ]);
-  }),
-);

package/src/capabilities/react-surface/index.ts

@@ -1,7 +0,0 @@
-//
-// Copyright 2025 DXOS.org
-//
-
-import { Capability } from '@dxos/app-framework';
-
-export const ReactSurface = Capability.lazy('ReactSurface', () => import('./react-surface'));

package/src/capabilities/react-surface/react-surface.tsx

@@ -1,102 +0,0 @@
-//
-// Copyright 2025 DXOS.org
-//
-
-import * as Effect from 'effect/Effect';
-import React, { forwardRef, useCallback, useMemo } from 'react';
-
-import { Capabilities, Capability } from '@dxos/app-framework';
-import {
-  Surface,
-  useAtomCapability,
-  useAtomCapabilityState,
-  useCapability,
-  useSettingsState,
-} from '@dxos/app-framework/ui';
-import { AppCapabilities } from '@dxos/app-toolkit';
-import { type SurfaceComponentProps } from '@dxos/app-toolkit/ui';
-import { Obj } from '@dxos/echo';
-import { AttentionCapabilities } from '@dxos/plugin-attention';
-import { Text } from '@dxos/schema';
-import { type EditorViewMode } from '@dxos/ui-editor';
-
-import { MarkdownCard, MarkdownContainer, type MarkdownContainerProps, MarkdownSettings } from '../../containers';
-import { meta } from '../../meta';
-import { Markdown, MarkdownCapabilities } from '../../types';
-
-export default Capability.makeModule(() =>
-  Effect.succeed(
-    Capability.contributes(Capabilities.ReactSurface, [
-      Surface.create({
-        id: `${meta.id}/surface/document`,
-        role: ['article', 'section', 'tabpanel'],
-        filter: (data): data is { subject: Markdown.Document; variant: undefined } =>
-          Obj.instanceOf(Markdown.Document, data.subject) && !data.variant,
-        component: ({ data, role, ref }) => {
-          return <Container id={Obj.getDXN(data.subject).toString()} subject={data.subject} role={role} ref={ref} />;
-        },
-      }),
-      Surface.create({
-        id: `${meta.id}/surface/text`,
-        role: ['article', 'section', 'tabpanel'],
-        filter: (data): data is { id: string; subject: Text.Text } =>
-          typeof data.id === 'string' && Obj.instanceOf(Text.Text, data.subject),
-        component: ({ data, role }) => {
-          return <Container id={data.id} subject={data.subject} role={role} />;
-        },
-      }),
-      Surface.create({
-        id: `${meta.id}/surface/plugin-settings`,
-        role: 'article',
-        filter: (data): data is { subject: AppCapabilities.Settings } =>
-          AppCapabilities.isSettings(data.subject) && data.subject.prefix === meta.id,
-        component: ({ data: { subject } }) => {
-          const { settings, updateSettings } = useSettingsState<Markdown.Settings>(subject.atom);
-          return <MarkdownSettings settings={settings} onSettingsChange={updateSettings} />;
-        },
-      }),
-      Surface.create({
-        id: `${meta.id}/surface/preview`,
-        role: 'card--content',
-        filter: (data): data is { subject: Markdown.Document | Text.Text } =>
-          Obj.instanceOf(Markdown.Document, data.subject) || Obj.instanceOf(Text.Text, data.subject),
-        component: ({ data }) => <MarkdownCard {...data} />,
-      }),
-    ]),
-  ),
-);
-
-/**
- * Common wrapper.
- */
-const Container = forwardRef<HTMLDivElement, SurfaceComponentProps<Markdown.Document | Text.Text, { id: string }>>(
-  ({ id, subject, role }, forwardedRef) => {
-    const selectionManager = useCapability(AttentionCapabilities.Selection);
-    const settings = useAtomCapability(MarkdownCapabilities.Settings);
-    const [state, setState] = useAtomCapabilityState(MarkdownCapabilities.State);
-    const editorState = useCapability(MarkdownCapabilities.EditorState);
-    const extensions = useCapability(MarkdownCapabilities.Extensions);
-    const extensionProviders = useMemo(() => extensions.flat(), [extensions]);
-
-    const viewMode: EditorViewMode = (id && state.viewMode[id]) || settings?.defaultViewMode || 'source';
-    const handleViewModeChange = useCallback<NonNullable<MarkdownContainerProps['onViewModeChange']>>(
-      (mode) => setState((current) => ({ ...current, viewMode: { ...current.viewMode, [id]: mode } })),
-      [id, setState],
-    );
-
-    return (
-      <MarkdownContainer
-        role={role}
-        subject={subject}
-        id={id}
-        settings={settings}
-        selectionManager={selectionManager}
-        extensionProviders={extensionProviders}
-        editorStateStore={editorState}
-        viewMode={viewMode}
-        onViewModeChange={handleViewModeChange}
-        ref={forwardedRef}
-      />
-    );
-  },
-);

package/src/capabilities/settings/index.ts

@@ -1,7 +0,0 @@
-//
-// Copyright 2025 DXOS.org
-//
-
-import { Capability } from '@dxos/app-framework';
-
-export const MarkdownSettings = Capability.lazy('MarkdownSettings', () => import('./settings'));

package/src/capabilities/state/index.ts

@@ -1,7 +0,0 @@
-//
-// Copyright 2025 DXOS.org
-//
-
-import { Capability } from '@dxos/app-framework';
-
-export const MarkdownState = Capability.lazy('MarkdownState', () => import('./state'));

package/src/capabilities/state/state.ts

@@ -1,31 +0,0 @@
-//
-// Copyright 2025 DXOS.org
-//
-
-import * as Effect from 'effect/Effect';
-
-import { Capability } from '@dxos/app-framework';
-import { createKvsStore } from '@dxos/effect';
-import { createEditorStateStore } from '@dxos/ui-editor';
-
-import { meta } from '../../meta';
-import { MarkdownCapabilities, MarkdownStateSchema } from '../../types';
-
-export default Capability.makeModule(
-  Effect.fnUntraced(function* () {
-    // Persisted state using KVS store.
-    const stateAtom = createKvsStore({
-      key: `${meta.id}/state`,
-      schema: MarkdownStateSchema,
-      defaultValue: () => ({ viewMode: {} }),
-    });
-
-    // TODO(wittjosiah): Fold into state.
-    const editorState = createEditorStateStore(`${meta.id}/editor`);
-
-    return [
-      Capability.contributes(MarkdownCapabilities.State, stateAtom),
-      Capability.contributes(MarkdownCapabilities.EditorState, editorState),
-    ];
-  }),
-);

package/src/containers/MarkdownSettings/MarkdownSettings.tsx

@@ -1,122 +0,0 @@
-//
-// Copyright 2023 DXOS.org
-//
-
-import React from 'react';
-
-import { Input, Select, useTranslation } from '@dxos/react-ui';
-import { Settings } from '@dxos/react-ui-form';
-import { type EditorInputMode, EditorInputModes, type EditorViewMode, EditorViewModes } from '@dxos/ui-editor';
-
-import { meta } from '../../meta';
-import { type Markdown } from '../../types';
-
-export type MarkdownSettingsComponentProps = {
-  settings: Markdown.Settings;
-  onSettingsChange: (fn: (current: Markdown.Settings) => Markdown.Settings) => void;
-};
-
-export const MarkdownSettings = ({ settings, onSettingsChange }: MarkdownSettingsComponentProps) => {
-  const { t } = useTranslation(meta.id);
-
-  // TODO(wittjosiah): Add skill test confirmation for entering vim mode.
-  return (
-    <Settings.Root>
-      <Settings.Section title={t('settings title', { ns: meta.id })}>
-        <Settings.Group>
-          <Settings.ItemInput title={t('default view mode label')}>
-            <Select.Root
-              value={settings.defaultViewMode}
-              onValueChange={(value) => {
-                onSettingsChange((s) => ({ ...s, defaultViewMode: value as EditorViewMode }));
-              }}
-            >
-              <Select.TriggerButton />
-              <Select.Portal>
-                <Select.Content>
-                  <Select.Viewport>
-                    {EditorViewModes.map((mode) => (
-                      <Select.Option key={mode} value={mode}>
-                        {t(`${mode} mode label`, { ns: '@dxos/react-ui-editor' })}
-                      </Select.Option>
-                    ))}
-                  </Select.Viewport>
-                  <Select.Arrow />
-                </Select.Content>
-              </Select.Portal>
-            </Select.Root>
-          </Settings.ItemInput>
-
-          <Settings.ItemInput title={t('editor input mode label')}>
-            <Select.Root
-              value={settings.editorInputMode ?? 'default'}
-              onValueChange={(value) => {
-                onSettingsChange((s) => ({ ...s, editorInputMode: value as EditorInputMode }));
-              }}
-            >
-              <Select.TriggerButton placeholder={t('select editor input mode placeholder')} />
-              <Select.Portal>
-                <Select.Content>
-                  <Select.Viewport>
-                    {EditorInputModes.map((mode) => (
-                      <Select.Option key={mode} value={mode}>
-                        {t(`settings editor input mode ${mode} label`)}
-                      </Select.Option>
-                    ))}
-                  </Select.Viewport>
-                  <Select.Arrow />
-                </Select.Content>
-              </Select.Portal>
-            </Select.Root>
-          </Settings.ItemInput>
-
-          <Settings.ItemInput title={t('settings toolbar label')}>
-            <Input.Switch
-              checked={settings.toolbar}
-              onCheckedChange={(checked) => onSettingsChange((s) => ({ ...s, toolbar: !!checked }))}
-            />
-          </Settings.ItemInput>
-
-          <Settings.ItemInput title={t('settings numbered headings label')}>
-            <Input.Switch
-              checked={settings.numberedHeadings}
-              onCheckedChange={(checked) => onSettingsChange((s) => ({ ...s, numberedHeadings: !!checked }))}
-            />
-          </Settings.ItemInput>
-
-          <Settings.ItemInput title={t('settings folding label')}>
-            <Input.Switch
-              checked={settings.folding}
-              onCheckedChange={(checked) => onSettingsChange((s) => ({ ...s, folding: !!checked }))}
-            />
-          </Settings.ItemInput>
-
-          <Settings.ItemInput title={t('settings experimental label')}>
-            <Input.Switch
-              checked={settings.experimental}
-              onCheckedChange={(checked) => onSettingsChange((s) => ({ ...s, experimental: !!checked }))}
-            />
-          </Settings.ItemInput>
-
-          <Settings.ItemInput title={t('settings debug label')}>
-            <Input.Switch
-              checked={settings.debug}
-              onCheckedChange={(checked) => onSettingsChange((s) => ({ ...s, debug: !!checked }))}
-            />
-          </Settings.ItemInput>
-
-          {settings.debug && (
-            <Settings.ItemInput title={t('settings debug textarea label', { ns: meta.id })}>
-              <Input.TextArea
-                rows={5}
-                value={settings.typewriter}
-                onChange={({ target: { value } }) => onSettingsChange((s) => ({ ...s, typewriter: value }))}
-                placeholder={t('settings debug placeholder')}
-              />
-            </Settings.ItemInput>
-          )}
-        </Settings.Group>
-      </Settings.Section>
-    </Settings.Root>
-  );
-};

package/src/containers/MarkdownSettings/index.ts

@@ -1,7 +0,0 @@
-//
-// Copyright 2025 DXOS.org
-//
-
-import { MarkdownSettings } from './MarkdownSettings';
-
-export default MarkdownSettings;

package/src/hooks/useSelectCurrentThread.tsx

@@ -1,61 +0,0 @@
-//
-// Copyright 2024 DXOS.org
-//
-
-import { EditorView } from '@codemirror/view';
-import * as Effect from 'effect/Effect';
-import { useMemo } from 'react';
-
-import { useOperationResolver } from '@dxos/app-framework/ui';
-import { LayoutOperation } from '@dxos/app-toolkit';
-import { invariant } from '@dxos/invariant';
-import { OperationResolver } from '@dxos/operation';
-import { Cursor, setSelection } from '@dxos/ui-editor';
-
-import { meta } from '../meta';
-
-/**
- * Handle scrolling and selection of the current thread in a markdown editor.
- */
-export const useSelectCurrentThread = (editorView: EditorView | null, documentId: string) => {
-  const scrollIntoViewHandler = useMemo(
-    () =>
-      OperationResolver.make({
-        operation: LayoutOperation.ScrollIntoView,
-        position: 'hoist',
-        filter: (input) => !!editorView && input.subject === documentId && !!input.cursor,
-        handler: (input) =>
-          Effect.sync(() => {
-            invariant(editorView, 'Editor view is not defined.');
-            const cursor = input.cursor;
-            if (!cursor) {
-              return;
-            }
-            const range = Cursor.getRangeFromCursor(editorView.state, cursor);
-            if (range) {
-              const selection =
-                editorView.state.selection.main.from !== range.from ? { anchor: range.from } : undefined;
-              const effects = [
-                // NOTE: This does not use the DOM scrollIntoView function.
-                EditorView.scrollIntoView(range.from, {
-                  y: 'start',
-                  yMargin: 96,
-                }),
-              ];
-              if (selection) {
-                // Update the editor selection to get bi-directional highlighting.
-                effects.push(setSelection.of({ current: documentId }));
-              }
-
-              editorView.dispatch({
-                effects,
-                selection: selection ? { anchor: range.from } : undefined,
-              });
-            }
-          }),
-      }),
-    [documentId, editorView],
-  );
-
-  useOperationResolver(meta.id, scrollIntoViewHandler);
-};

package/src/types/MarkdownAction.ts

@@ -1,59 +0,0 @@
-//
-// Copyright 2023 DXOS.org
-//
-
-import * as Schema from 'effect/Schema';
-
-import { Capability } from '@dxos/app-framework';
-import { Collection } from '@dxos/echo';
-import { Operation } from '@dxos/operation';
-import { SpaceSchema } from '@dxos/react-client/echo';
-import { EditorViewMode } from '@dxos/ui-editor/types';
-
-import { meta } from '../meta';
-
-import { Document } from './Markdown';
-
-const MARKDOWN_OPERATION = `${meta.id}/operation`;
-
-export namespace MarkdownOperation {
-  export const OnCreateSpace = Operation.make({
-    meta: { key: `${MARKDOWN_OPERATION}/on-create-space`, name: 'On Create Space' },
-    services: [Capability.Service],
-    schema: {
-      input: Schema.Struct({
-        space: SpaceSchema,
-        rootCollection: Collection.Collection,
-        isDefault: Schema.optional(Schema.Boolean),
-      }),
-      output: Schema.Void,
-    },
-  });
-
-  export const Create = Operation.make({
-    meta: { key: `${MARKDOWN_OPERATION}/create`, name: 'Create Markdown Document' },
-    services: [Capability.Service],
-    schema: {
-      input: Schema.Struct({
-        name: Schema.optional(Schema.String),
-        content: Schema.optional(Schema.String),
-      }),
-      output: Schema.Struct({
-        object: Document,
-      }),
-    },
-  });
-
-  // TODO(wittjosiah): This appears to be unused.
-  export const SetViewMode = Operation.make({
-    meta: { key: `${MARKDOWN_OPERATION}/set-view-mode`, name: 'Set View Mode' },
-    services: [Capability.Service],
-    schema: {
-      input: Schema.Struct({
-        id: Schema.String,
-        viewMode: EditorViewMode,
-      }),
-      output: Schema.Void,
-    },
-  });
-}