@dxos/ui-editor 0.8.4-main.bc674ce → 0.8.4-main.bcb3aa67d6

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dxos/ui-editor",
-  "version": "0.8.4-main.bc674ce",
+  "version": "0.8.4-main.bcb3aa67d6",
   "description": "Text editor components.",
   "homepage": "https://dxos.org",
   "bugs": "https://github.com/dxos/dxos/issues",
@@ -58,35 +58,35 @@
     "@replit/codemirror-vim": "^6.2.1",
     "@replit/codemirror-vscode-keymap": "^6.0.2",
     "@uiw/codemirror-theme-vscode": "^4.25.2",
-    "ajv": "^8.17.1",
+    "ajv": "^8.18.0",
     "codemirror": "^6.0.1",
     "lib0": "^0.2.65",
     "lodash.defaultsdeep": "^4.6.1",
     "lodash.merge": "^4.6.2",
     "lodash.sortby": "^4.7.0",
     "style-mod": "^4.1.0",
-    "@dxos/async": "0.8.4-main.bc674ce",
-    "@dxos/client": "0.8.4-main.bc674ce",
-    "@dxos/app-graph": "0.8.4-main.bc674ce",
-    "@dxos/context": "0.8.4-main.bc674ce",
-    "@dxos/display-name": "0.8.4-main.bc674ce",
-    "@dxos/echo": "0.8.4-main.bc674ce",
-    "@dxos/invariant": "0.8.4-main.bc674ce",
-    "@dxos/echo-db": "0.8.4-main.bc674ce",
-    "@dxos/debug": "0.8.4-main.bc674ce",
-    "@dxos/lit-ui": "0.8.4-main.bc674ce",
-    "@dxos/ui": "0.8.4-main.bc674ce",
-    "@dxos/protocols": "0.8.4-main.bc674ce",
-    "@dxos/log": "0.8.4-main.bc674ce",
-    "@dxos/ui-theme": "0.8.4-main.bc674ce",
-    "@dxos/ui-types": "0.8.4-main.bc674ce",
-    "@dxos/util": "0.8.4-main.bc674ce"
+    "@dxos/app-graph": "0.8.4-main.bcb3aa67d6",
+    "@dxos/context": "0.8.4-main.bcb3aa67d6",
+    "@dxos/debug": "0.8.4-main.bcb3aa67d6",
+    "@dxos/display-name": "0.8.4-main.bcb3aa67d6",
+    "@dxos/client": "0.8.4-main.bcb3aa67d6",
+    "@dxos/echo": "0.8.4-main.bcb3aa67d6",
+    "@dxos/invariant": "0.8.4-main.bcb3aa67d6",
+    "@dxos/lit-ui": "0.8.4-main.bcb3aa67d6",
+    "@dxos/log": "0.8.4-main.bcb3aa67d6",
+    "@dxos/protocols": "0.8.4-main.bcb3aa67d6",
+    "@dxos/ui": "0.8.4-main.bcb3aa67d6",
+    "@dxos/echo-db": "0.8.4-main.bcb3aa67d6",
+    "@dxos/util": "0.8.4-main.bcb3aa67d6",
+    "@dxos/ui-theme": "0.8.4-main.bcb3aa67d6",
+    "@dxos/ui-types": "0.8.4-main.bcb3aa67d6",
+    "@dxos/async": "0.8.4-main.bcb3aa67d6"
   },
   "devDependencies": {
     "@automerge/automerge": "3.2.3",
     "@automerge/automerge-repo": "2.5.1",
     "@automerge/automerge-repo-network-broadcastchannel": "2.5.1",
-    "@effect/platform": "0.93.6",
+    "@effect/platform": "0.94.4",
     "@types/chai": "^4.2.15",
     "@types/chai-dom": "^1.11.0",
     "@types/lodash.defaultsdeep": "^4.6.6",
@@ -94,25 +94,25 @@
     "@types/lodash.sortby": "^4.7.7",
     "chai": "^4.4.1",
     "chai-dom": "^1.11.0",
-    "effect": "3.19.11",
-    "happy-dom": "^13.3.1",
+    "effect": "3.20.0",
+    "happy-dom": "^20.0.0",
     "jsdom": "^27.0.0",
     "mocha": "^10.6.0",
-    "vite": "7.1.9",
+    "vite": "^7.1.11",
     "vite-plugin-top-level-await": "^1.6.0",
     "vite-plugin-wasm": "^3.5.0",
-    "@dxos/config": "0.8.4-main.bc674ce",
-    "@dxos/echo": "0.8.4-main.bc674ce",
-    "@dxos/keyboard": "0.8.4-main.bc674ce",
-    "@dxos/random": "0.8.4-main.bc674ce",
-    "@dxos/schema": "0.8.4-main.bc674ce",
-    "@dxos/ui-theme": "0.8.4-main.bc674ce",
-    "@dxos/storybook-utils": "0.8.4-main.bc674ce"
+    "@dxos/echo": "0.8.4-main.bcb3aa67d6",
+    "@dxos/schema": "0.8.4-main.bcb3aa67d6",
+    "@dxos/random": "0.8.4-main.bcb3aa67d6",
+    "@dxos/storybook-utils": "0.8.4-main.bcb3aa67d6",
+    "@dxos/ui-theme": "0.8.4-main.bcb3aa67d6",
+    "@dxos/keyboard": "0.8.4-main.bcb3aa67d6",
+    "@dxos/config": "0.8.4-main.bcb3aa67d6"
   },
   "peerDependencies": {
-    "@effect/platform": "0.93.6",
-    "effect": "3.19.11",
-    "@dxos/ui-theme": "0.8.4-main.bc674ce"
+    "@effect/platform": "0.94.4",
+    "effect": "3.20.0",
+    "@dxos/ui-theme": "0.8.4-main.bcb3aa67d6"
   },
   "publishConfig": {
     "access": "public"

package/src/defaults.ts

@@ -6,29 +6,27 @@ import { mx } from '@dxos/ui-theme';
 
 import { type ThemeExtensionsOptions } from './extensions';
 
-/**
- * CodeMirror content width.
- * 40rem = 640px. Corresponds to initial plank width (Google docs, Stashpad, etc.)
- * 50rem = 800px. Maximum content width for solo mode.
- * NOTE: Max width - 4rem = 2rem left/right margin (or 2rem gutter plus 1rem left/right margin).
- */
-export const editorWidth = '!mli-auto is-full max-is-[min(50rem,100%-4rem)]';
+// NOTE: Padding is added to the editor to account for the focus ring (since otherwise the CM gutter will clip it)
+export const editorClassNames = (role?: string) =>
+  mx(
+    'dx-attention-surface p-0.5 data-[toolbar=disabled]:pt-2 dx-focus-ring-inset',
+    role === 'section' ? '[&_.cm-scroller]:overflow-hidden [&_.cm-scroller]:min-h-24' : 'dx-container overflow-hidden',
+  );
 
-export const editorSlots: ThemeExtensionsOptions['slots'] = {
-  scroll: {
-    className: 'pbs-2',
-  },
+export const documentSlots: ThemeExtensionsOptions['slots'] = {
   content: {
-    className: editorWidth,
+    /**
+     * CodeMirror content width.
+     * 40rem = 640px. Corresponds to initial plank width (Google docs, Stashpad, etc.)
+     * 50rem = 800px. Maximum content width for solo mode.
+     * NOTE: Max width - 4rem = 2rem left/right margin (or 2rem gutter plus 1rem left/right margin).
+     */
+    className: 'mx-auto! w-full pointer-fine:max-w-[min(50rem,100%-4rem)] pointer-coarse:max-w-[min(50rem,100%-2rem)]',
   },
 };
 
-export const editorWithToolbarLayout =
-  'grid grid-cols-1 grid-rows-[min-content_1fr] data-[toolbar=disabled]:grid-rows-[1fr] justify-center content-start overflow-hidden';
-
-// NOTE: Padding is added to the editor to account for the focus ring (since otherwise the CM gutter will clip it)
-export const stackItemContentEditorClassNames = (role?: string) =>
-  mx(
-    'p-0.5 dx-focus-ring-inset attention-surface data-[toolbar=disabled]:pbs-2',
-    role === 'section' ? '[&_.cm-scroller]:overflow-hidden [&_.cm-scroller]:min-bs-24' : 'min-bs-0',
-  );
+export const compactSlots: ThemeExtensionsOptions['slots'] = {
+  content: {
+    className: 'mx-2! w-full',
+  },
+};

package/src/extensions/annotations.ts

@@ -48,7 +48,7 @@ export const annotations = ({ match }: AnnotationOptions = {}): Extension => {
       '.cm-annotation': {
         textDecoration: 'underline',
         textDecorationStyle: 'wavy',
-        textDecorationColor: 'var(--dx-errorText)',
+        textDecorationColor: 'var(--color-error-text)',
       },
     }),
   ];

package/src/extensions/auto-scroll.ts

@@ -0,0 +1,129 @@
+//
+// Copyright 2025 DXOS.org
+//
+
+import { EditorView, ViewPlugin } from '@codemirror/view';
+
+import { addEventListener, combine, throttle } from '@dxos/async';
+import { Domino } from '@dxos/ui';
+
+import { scrollerCrawlEffect, scrollerLineEffect } from './scroller';
+import { getSize } from '@dxos/ui-theme';
+
+export type AutoScrollToProps = {};
+
+/**
+ * Extension that supports pinning the scroll position and automatically scrolls to the bottom when content is added.
+ */
+export const autoScroll = (_: AutoScrollToProps = {}) => {
+  let buttonContainer: HTMLDivElement | undefined;
+  let isPinned = true;
+
+  const setPinned = (pinned: boolean) => {
+    buttonContainer?.classList.toggle('opacity-0', pinned);
+    isPinned = pinned;
+  };
+
+  return [
+    // Update listener for logging when scrolling is needed.
+    EditorView.updateListener.of(({ view, heightChanged, state }) => {
+      // Maybe scroll if doc changed and pinned.
+      // NOTE: Geometry changed is triggered when widgets change height (e.g., toggle tool block).
+      if (heightChanged) {
+        if (isPinned) {
+          // NOTE: Use scroll geometry instead of coordsAtPos to avoid forced layout/scroll side-effects.
+          const { scrollTop, scrollHeight, clientHeight } = view.scrollDOM;
+          const delta = scrollHeight - scrollTop - clientHeight;
+          if (delta > 0 && scrollTop > 0) {
+            setPinned(true);
+            view.dispatch({
+              effects: scrollerCrawlEffect.of(true),
+            });
+          } else if (delta < 0) {
+            setPinned(false);
+          }
+        } else {
+          // TODO(burdon): Should re-pin if content shrinks.
+          if (state.doc.length === 0) {
+            setPinned(true);
+          }
+        }
+      }
+    }),
+
+    // Detect user scroll and unpin (or re-pin if scrolled to the bottom).
+    ViewPlugin.fromClass(
+      class {
+        private readonly cleanup: () => void;
+        constructor(view: EditorView) {
+          this.cleanup = createUserScrollDetector(
+            view.scrollDOM,
+            throttle(() => {
+              requestAnimationFrame(() => {
+                const { scrollTop, scrollHeight, clientHeight } = view.scrollDOM;
+                const delta = scrollHeight - scrollTop - clientHeight;
+                const pinned = delta === 0;
+                setPinned(pinned);
+                if (!pinned) {
+                  view.dispatch({ effects: scrollerCrawlEffect.of(false) });
+                }
+              });
+            }, 500),
+          );
+        }
+        destroy() {
+          this.cleanup();
+        }
+      },
+    ),
+
+    // Scroll button.
+    ViewPlugin.fromClass(
+      class {
+        constructor(view: EditorView) {
+          const icon = Domino.of('dx-icon' as any)
+            .classNames(getSize(4))
+            .attributes({ icon: 'ph--arrow-down--regular' });
+          const button = Domino.of('button')
+            .classNames('dx-button bg-accent-surface')
+            .attributes({ 'data-density': 'fine' })
+            .children(icon)
+            .on('click', () => {
+              setPinned(true);
+              view.dispatch({
+                effects: scrollerLineEffect.of({ line: -1, position: 'end', behavior: 'smooth' }),
+              });
+            });
+
+          buttonContainer = Domino.of('div')
+            .classNames('cm-scroll-button transition-opacity duration-300 opacity-0')
+            .children(button).root as HTMLDivElement;
+
+          view.scrollDOM.parentElement!.appendChild(buttonContainer);
+        }
+      },
+    ),
+  ];
+};
+
+/**
+ * Attaches listeners to detect genuine user-initiated scrolling on an element.
+ * Two sources are covered:
+ *   - `wheel`: fires only from physical mouse wheel / trackpad gestures.
+ *   - `pointerdown` on the scrollbar gutter: detected by comparing clientX to
+ *     the element's clientWidth (the content area, excluding the scrollbar).
+ * Returns a cleanup function that removes the listeners.
+ */
+// TODO(burdon): Still jumps when widgets are rendered.
+// - Track position of specific element/line in document and scroll relative to that.
+function createUserScrollDetector(element: HTMLElement, onUserScroll: () => void): () => void {
+  return combine(
+    addEventListener(element, 'wheel', () => onUserScroll(), { passive: true }),
+    addEventListener(element, 'pointerdown', (event) => {
+      // If the pointer lands beyond the content width it hit the scrollbar gutter.
+      if (event.clientX > element.getBoundingClientRect().right - (element.offsetWidth - element.clientWidth)) {
+        onUserScroll();
+      }
+    }),
+  );
+}

package/src/extensions/automerge/automerge.test.tsx

@@ -9,7 +9,7 @@ import { render, screen } from '@testing-library/react';
 import React, { type FC, useEffect, useRef, useState } from 'react';
 import { describe, test } from 'vitest';
 
-import { get } from '@dxos/util';
+import { getDeep } from '@dxos/util';
 
 import { automerge } from './automerge';
 
@@ -46,7 +46,7 @@ const Test: FC<{ handle: DocHandle<TestObject>; generator: Generator }> = ({ han
     ];
 
     const view = new EditorView({
-      state: EditorState.create({ doc: get(handle.doc()!, path), extensions }),
+      state: EditorState.create({ doc: getDeep(handle.doc()!, path), extensions }),
       parent: ref.current!,
     });
 

package/src/extensions/automerge/automerge.ts

@@ -72,11 +72,12 @@ export const automerge = (accessor: DocAccessor): Extension => {
             const value = DocAccessor.getValue<string>(accessor);
             const current = this._view.state.doc.toString();
             if (value !== current) {
-              // TODO(burdon): This attempts to set the initial state, but creates problems.
-              // this._view.dispatch({
-              //   changes: { from: 0, to: this._view.state.doc.length, insert: value },
-              //   annotations: initialSync,
-              // });
+              // TODO(burdon): This attempts to set the initial state.
+              console.warn('ENABLING INITIAL SYNC -- THIS MAY BE A REGRESSION');
+              this._view.dispatch({
+                changes: { from: 0, to: this._view.state.doc.length, insert: value },
+                annotations: initialSync,
+              });
             }
           });
         }

package/src/extensions/blocks.ts

@@ -101,11 +101,11 @@ export const blocks = () => [
     '.cm-line.block-line': {
       paddingLeft: '0.75rem',
       paddingRight: '0.75rem',
-      borderLeft: '1px solid var(--dx-subduedSeparator)',
-      borderRight: '1px solid var(--dx-subduedSeparator)',
+      borderLeft: '1px solid var(--color-subdued-separator)',
+      borderRight: '1px solid var(--color-subdued-separator)',
     },
     '.cm-line.block-single': {
-      border: '1px solid var(--dx-subduedSeparator)',
+      border: '1px solid var(--color-subdued-separator)',
       borderRadius: '6px',
       paddingTop: '0.5rem',
       paddingBottom: '0.5rem',
@@ -113,7 +113,7 @@ export const blocks = () => [
       marginBottom: '0.5rem',
     },
     '.cm-line.block-first': {
-      borderTop: '1px solid var(--dx-subduedSeparator)',
+      borderTop: '1px solid var(--color-subdued-separator)',
       borderTopLeftRadius: '6px',
       borderTopRightRadius: '6px',
       paddingTop: '0.5rem',
@@ -121,7 +121,7 @@ export const blocks = () => [
     },
     '.cm-line.block-middle': {},
     '.cm-line.block-last': {
-      borderBottom: '1px solid var(--dx-subduedSeparator)',
+      borderBottom: '1px solid var(--color-subdued-separator)',
       borderBottomLeftRadius: '6px',
       borderBottomRightRadius: '6px',
       paddingBottom: '0.5rem',

package/src/extensions/comments.ts

@@ -103,14 +103,14 @@ export const commentsState = StateField.define<CommentsState>({
 const styles = EditorView.theme({
   '.cm-comment, .cm-comment-current': {
     padding: '3px 0',
-    color: 'var(--dx-cmCommentText)',
-    backgroundColor: 'var(--dx-cmCommentSurface)',
+    color: 'var(--color-cm-comment-text)',
+    backgroundColor: 'var(--color-cm-comment-surface)',
   },
   '.cm-comment > span, .cm-comment-current > span': {
     boxDecorationBreak: 'clone',
-    boxShadow: '0 0 1px 3px var(--dx-cmCommentSurface)',
-    backgroundColor: 'var(--dx-cmCommentSurface)',
-    color: 'var(--dx-cmCommentText)',
+    boxShadow: '0 0 1px 3px var(--color-cm-comment-surface)',
+    backgroundColor: 'var(--color-cm-comment-surface)',
+    color: 'var(--color-cm-comment-text)',
     cursor: 'pointer',
   },
 });

package/src/extensions/dnd.ts

@@ -29,8 +29,8 @@ export const dropFile = (options: DropOptions = {}): Extension => {
 
 const styles = EditorView.theme({
   '.cm-dropCursor': {
-    borderLeft: '2px solid var(--dx-accentText)',
-    color: 'var(--dx-accentText)',
+    borderLeft: '2px solid var(--color-accent-text)',
+    color: 'var(--color-accent-text)',
     padding: '0 4px',
   },
   '.cm-dropCursor:after': {

package/src/extensions/factories.ts

@@ -17,7 +17,6 @@ import {
   keymap,
   lineNumbers,
   placeholder,
-  scrollPastEnd,
 } from '@codemirror/view';
 import { vscodeDarkStyle, vscodeLightStyle } from '@uiw/codemirror-theme-vscode';
 import defaultsDeep from 'lodash.defaultsdeep';
@@ -27,8 +26,7 @@ import { type DocAccessor } from '@dxos/echo-db';
 import { log } from '@dxos/log';
 import { type Messenger } from '@dxos/protocols';
 import { type Identity } from '@dxos/protocols/proto/dxos/client/services';
-import { type HuePalette } from '@dxos/ui-theme';
-import { type ThemeMode } from '@dxos/ui-types';
+import { type ChromaticPalette, type ThemeMode } from '@dxos/ui-types';
 import { hexToHue, isTruthy } from '@dxos/util';
 
 import { baseTheme, createFontTheme, editorGutter } from '../styles';
@@ -36,6 +34,7 @@ import { baseTheme, createFontTheme, editorGutter } from '../styles';
 import { automerge } from './automerge';
 import { SpaceAwarenessProvider, awareness } from './awareness';
 import { focus } from './focus';
+import { scrollPastEnd } from './scroll-past-end';
 
 //
 // Basic
@@ -198,13 +197,13 @@ export type ThemeExtensionsOptions = {
 
 export const grow: ThemeExtensionsOptions['slots'] = {
   editor: {
-    className: 'bs-full is-full',
+    className: 'h-full w-full',
   },
 } as const;
 
 export const fullWidth: ThemeExtensionsOptions['slots'] = {
   editor: {
-    className: 'is-full',
+    className: 'w-full',
   },
 } as const;
 
@@ -263,7 +262,7 @@ export const createDataExtensions = <T>({ id, text, messenger, identity }: DataE
 
   if (messenger && identity) {
     const peerId = identity?.identityKey.toHex();
-    const hue = (identity?.profile?.data?.hue as HuePalette | undefined) ?? hexToHue(peerId ?? '0');
+    const hue = (identity?.profile?.data?.hue as ChromaticPalette | undefined) ?? hexToHue(peerId ?? '0');
     extensions.push(
       awareness(
         new SpaceAwarenessProvider({
@@ -271,8 +270,8 @@ export const createDataExtensions = <T>({ id, text, messenger, identity }: DataE
           channel: `awareness.${id}`,
           peerId: identity.identityKey.toHex(),
           info: {
-            darkColor: `var(--dx-${hue}Cursor)`,
-            lightColor: `var(--dx-${hue}Cursor)`,
+            darkColor: `var(--color-${hue}-border)`,
+            lightColor: `var(--color-${hue}-border)`,
             displayName: identity.profile?.displayName ?? generateName(identity.identityKey.toHex()),
           },
         }),

package/src/extensions/folding.ts

@@ -17,12 +17,13 @@ export const folding = (): Extension => {
       placeholderDOM: () => Domino.of('span').root,
     }),
     foldGutter({
+      // NOTE: We can't animate since the element is remounted on state change.
       markerDOM: (open) => {
         return Domino.of('div')
-          .classNames('flex bs-full justify-center items-center')
+          .classNames('flex h-full justify-center items-center')
           .children(
             Domino.of('svg', Domino.SVG)
-              .classNames(mx('is-4 bs-4 cursor-pointer', open && 'rotate-90'))
+              .classNames(mx('w-4 h-4 cursor-pointer', open && 'rotate-90'))
               .children(
                 Domino.of('use', Domino.SVG).attributes({
                   href: Domino.icon('ph--caret-right--regular'),
@@ -30,24 +31,6 @@ export const folding = (): Extension => {
               ),
           ).root;
       },
-      // TODO(burdon): markerDOM is called either way, defeating the animation: transition-transform duration-200
-      // domEventHandlers: {
-      //   click: (view, line: BlockInfo, event) => {
-      //     event.preventDefault();
-      //     event.stopPropagation();
-      //     const range = foldable(view.state, line.from, line.to);
-      //     if (range) {
-      //       view.dispatch({ effects: foldEffect.of(range) });
-      //       (event.target as HTMLElement)?.classList.add('rotate-90');
-      //     } else {
-      //       foldedRanges(view.state).between(line.from, line.to, (from, to) => {
-      //         view.dispatch({ effects: unfoldEffect.of({ from, to }) });
-      //         (event.target as HTMLElement)?.classList.remove('rotate-90');
-      //       });
-      //     }
-      //     return true;
-      //   },
-      // },
     }),
     EditorView.theme({
       '.cm-foldGutter': {

package/src/extensions/index.ts

@@ -4,7 +4,7 @@
 
 export * from './annotations';
 export * from './autocomplete';
-export * from './autoscroll';
+export * from './auto-scroll';
 export * from './automerge';
 export * from './awareness';
 export * from './blast';
@@ -26,8 +26,9 @@ export * from './modes';
 export * from './outliner';
 export * from './preview';
 export * from './replacer';
+export * from './scroll-past-end';
+export * from './scroller';
 export * from './selection';
-export * from './scrolling';
 export * from './state';
 export * from './submit';
 export * from './tags';

package/src/extensions/markdown/bundle.ts

@@ -6,8 +6,7 @@ import { completionKeymap } from '@codemirror/autocomplete';
 import { defaultKeymap, indentWithTab } from '@codemirror/commands';
 import { jsonLanguage } from '@codemirror/lang-json';
 import { markdown, markdownLanguage } from '@codemirror/lang-markdown';
-import { xml } from '@codemirror/lang-xml';
-import { LanguageDescription, syntaxHighlighting } from '@codemirror/language';
+import { type LanguageDescription, foldNodeProp, syntaxHighlighting } from '@codemirror/language';
 import { languages } from '@codemirror/language-data';
 import { type Extension } from '@codemirror/state';
 import { keymap } from '@codemirror/view';
@@ -18,6 +17,8 @@ import { isTruthy } from '@dxos/util';
 import { markdownHighlightStyle, markdownTagsExtensions } from './highlight';
 
 export type MarkdownBundleOptions = {
+  /** Additional fenced-code languages prepended to the standard language-data list. */
+  codeLanguages?: LanguageDescription[];
   extensions?: MarkdownConfig[];
   indentWithTab?: boolean;
   setextHeading?: boolean;
@@ -45,8 +46,9 @@ export const createMarkdownExtensions = (options: MarkdownBundleOptions = {}): E
       base: markdownLanguage,
 
       // Languages for syntax highlighting fenced code blocks.
+      // Caller-supplied languages are checked first so they can override defaults.
       defaultCodeLanguage: jsonLanguage,
-      codeLanguages: languages,
+      codeLanguages: [...(options.codeLanguages ?? []), ...languages],
 
       // Don't complete HTML tags.
       completeHTMLTags: false,
@@ -56,6 +58,10 @@ export const createMarkdownExtensions = (options: MarkdownBundleOptions = {}): E
         // GFM provided by default.
         markdownTagsExtensions,
         ...(options.extensions ?? defaultExtensions()),
+        // Disable folding for fenced code blocks by overriding foldNodeProp.
+        // Note: returning null from foldService does not prevent syntaxFolding fallback,
+        // so we must override the node prop directly on the FencedCode node type.
+        noFencedCodeFolding,
       ],
     }),
 
@@ -77,12 +83,20 @@ export const createMarkdownExtensions = (options: MarkdownBundleOptions = {}): E
   ];
 };
 
-const xmlLanguageDesc = LanguageDescription.of({
-  name: 'xml',
-  alias: ['html', 'xhtml'],
-  extensions: ['xml', 'xhtml'],
-  load: async () => xml(),
-});
+/**
+ * Disables folding for fenced code blocks.
+ *
+ * foldService cannot block folding because returning null just defers to the next service,
+ * and CodeMirror always falls back to syntaxFolding (which reads foldNodeProp).
+ * The only reliable fix is to override foldNodeProp on FencedCode to return null.
+ */
+const noFencedCodeFolding: MarkdownConfig = {
+  props: [
+    foldNodeProp.add({
+      FencedCode: () => null,
+    }),
+  ],
+};
 
 /**
  * Default customizations.