@dxos/react-ui-editor 0.10.0 → 0.11.0

package/dist/types/src/components/EditorToolbar/EditorToolbar.d.ts

@@ -1,11 +1,12 @@
 import { type EditorView } from '@codemirror/view';
-import { Atom } from '@effect-atom/atom-react';
+import { Atom } from '@effect-atom/atom';
 import React from 'react';
 import { type Node } from '@dxos/app-graph';
 import { type ThemedClassName } from '@dxos/react-ui';
 import { type ActionGraphProps, type MenuAction } from '@dxos/react-ui-menu';
 import { type EditorViewMode } from '@dxos/ui-editor/types';
 import { type EditorToolbarState } from './types';
+import { type ViewModeItem } from './view-mode';
 export type EditorToolbarFeatureFlags = Partial<{
     showHeadings: boolean;
     showFormatting: boolean;
@@ -14,6 +15,8 @@ export type EditorToolbarFeatureFlags = Partial<{
     showSearch: boolean;
     onImageUpload: () => void;
     onViewModeChange: (mode: EditorViewMode) => void;
+    /** Override the view-mode dropdown entries (default: the three built-in modes). See {@link ViewModeItem}. */
+    viewModes: ViewModeItem[];
 }>;
 export type EditorToolbarActionGraphProps = {
     state: Atom.Atom<EditorToolbarState>;

package/dist/types/src/components/EditorToolbar/EditorToolbar.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"EditorToolbar.d.ts","sourceRoot":"","sources":["../../../../../src/components/EditorToolbar/EditorToolbar.tsx"],"names":[],"mappings":"AAIA,OAAO,EAAE,KAAK,UAAU,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,EAAE,IAAI,EAAE,MAAM,yBAAyB,CAAC;AAC/C,OAAO,KAAwB,MAAM,OAAO,CAAC;AAE7C,OAAO,EAAE,KAAK,IAAI,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAqB,KAAK,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACzE,OAAO,EAAE,KAAK,gBAAgB,EAAQ,KAAK,UAAU,EAA+B,MAAM,qBAAqB,CAAC;AAChH,OAAO,EAAE,KAAK,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAQ5D,OAAO,EAAE,KAAK,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAQlD,MAAM,MAAM,yBAAyB,GAAG,OAAO,CAAC;IAC9C,YAAY,EAAE,OAAO,CAAC;IACtB,cAAc,EAAE,OAAO,CAAC;IACxB,SAAS,EAAE,OAAO,CAAC;IACnB,UAAU,EAAE,OAAO,CAAC;IACpB,UAAU,EAAE,OAAO,CAAC;IAGpB,aAAa,EAAE,MAAM,IAAI,CAAC;IAC1B,gBAAgB,EAAE,CAAC,IAAI,EAAE,cAAc,KAAK,IAAI,CAAC;CAClD,CAAC,CAAC;AAEH,MAAM,MAAM,6BAA6B,GAAG;IAC1C,KAAK,EAAE,IAAI,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC;IACrC,OAAO,EAAE,MAAM,UAAU,CAAC;IAE1B,aAAa,CAAC,EAAE,IAAI,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;CAC7C,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG,eAAe,CAC9C;IACE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,uFAAuF;IACvF,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,IAAI,CAAC,WAAW,KAAK,IAAI,CAAC;CACnE,GAAG,CAAC,6BAA6B,GAAG,yBAAyB,CAAC,CAChE,CAAC;AAEF,eAAO,MAAM,aAAa,qFAAiE,kBAAkB,uBAU3G,CAAC"}
+{"version":3,"file":"EditorToolbar.d.ts","sourceRoot":"","sources":["../../../../../src/components/EditorToolbar/EditorToolbar.tsx"],"names":[],"mappings":"AAIA,OAAO,EAAE,KAAK,UAAU,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,EAAE,IAAI,EAAE,MAAM,mBAAmB,CAAC;AACzC,OAAO,KAAwB,MAAM,OAAO,CAAC;AAE7C,OAAO,EAAE,KAAK,IAAI,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAqB,KAAK,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACzE,OAAO,EAAE,KAAK,gBAAgB,EAAQ,KAAK,UAAU,EAA+B,MAAM,qBAAqB,CAAC;AAChH,OAAO,EAAE,KAAK,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAQ5D,OAAO,EAAE,KAAK,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAClD,OAAO,EAAE,KAAK,YAAY,EAAe,MAAM,aAAa,CAAC;AAO7D,MAAM,MAAM,yBAAyB,GAAG,OAAO,CAAC;IAC9C,YAAY,EAAE,OAAO,CAAC;IACtB,cAAc,EAAE,OAAO,CAAC;IACxB,SAAS,EAAE,OAAO,CAAC;IACnB,UAAU,EAAE,OAAO,CAAC;IACpB,UAAU,EAAE,OAAO,CAAC;IAGpB,aAAa,EAAE,MAAM,IAAI,CAAC;IAC1B,gBAAgB,EAAE,CAAC,IAAI,EAAE,cAAc,KAAK,IAAI,CAAC;IACjD,6GAA6G;IAC7G,SAAS,EAAE,YAAY,EAAE,CAAC;CAC3B,CAAC,CAAC;AAEH,MAAM,MAAM,6BAA6B,GAAG;IAC1C,KAAK,EAAE,IAAI,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC;IACrC,OAAO,EAAE,MAAM,UAAU,CAAC;IAE1B,aAAa,CAAC,EAAE,IAAI,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;CAC7C,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG,eAAe,CAC9C;IACE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,uFAAuF;IACvF,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,IAAI,CAAC,WAAW,KAAK,IAAI,CAAC;CACnE,GAAG,CAAC,6BAA6B,GAAG,yBAAyB,CAAC,CAChE,CAAC;AAEF,eAAO,MAAM,aAAa,qFAAiE,kBAAkB,uBAU3G,CAAC"}

package/dist/types/src/components/EditorToolbar/index.d.ts

@@ -1,3 +1,4 @@
 export * from './types';
 export * from './EditorToolbar';
+export * from './view-mode';
 //# sourceMappingURL=index.d.ts.map

package/dist/types/src/components/EditorToolbar/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/components/EditorToolbar/index.ts"],"names":[],"mappings":"AAIA,cAAc,SAAS,CAAC;AAExB,cAAc,iBAAiB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/components/EditorToolbar/index.ts"],"names":[],"mappings":"AAIA,cAAc,SAAS,CAAC;AAExB,cAAc,iBAAiB,CAAC;AAChC,cAAc,aAAa,CAAC"}

package/dist/types/src/components/EditorToolbar/lists.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"lists.d.ts","sourceRoot":"","sources":["../../../../../src/components/EditorToolbar/lists.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,KAAK,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAEnD,OAAO,EAAE,KAAK,oBAAoB,EAAyC,MAAM,qBAAqB,CAAC;AAKvG,OAAO,EAAE,KAAK,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAQlD,uCAAuC;AACvC,eAAO,MAAM,QAAQ,UACX,kBAAkB,WAAW,MAAM,UAAU,KAAG,oBAoCvD,CAAC"}
+{"version":3,"file":"lists.d.ts","sourceRoot":"","sources":["../../../../../src/components/EditorToolbar/lists.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,KAAK,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAEnD,OAAO,EAAE,KAAK,oBAAoB,EAAyC,MAAM,qBAAqB,CAAC;AAKvG,OAAO,EAAE,KAAK,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAQlD,uCAAuC;AACvC,eAAO,MAAM,QAAQ,UACX,kBAAkB,WAAW,MAAM,UAAU,KAAG,oBAgCvD,CAAC"}

package/dist/types/src/components/EditorToolbar/view-mode.d.ts

@@ -1,6 +1,31 @@
 import { type ActionGroupBuilderFn } from '@dxos/react-ui-menu';
 import { type EditorViewMode } from '@dxos/ui-editor/types';
+import { type Label } from '@dxos/ui-types';
 import { type EditorToolbarState } from './types';
-/** Add view mode actions to the builder. */
-export declare const addViewMode: (state: EditorToolbarState, onViewModeChange: (mode: EditorViewMode) => void) => ActionGroupBuilderFn;
+/**
+ * One entry in the editor's view-mode dropdown. A built-in entry references an {@link EditorViewMode}
+ * by `id` and relies on the defaults (label `view-mode.<id>.label`, checked when it is the active view
+ * mode, select via `onViewModeChange`). A contributed entry (e.g. a review "Suggesting" mode) supplies
+ * its own `label`, `checked`, and `onSelect` so it can drive state other than the editor view mode.
+ */
+export type ViewModeItem = {
+    id: string;
+    icon: string;
+    label?: Label;
+    checked?: boolean;
+    onSelect?: () => void;
+};
+/**
+ * The built-in view modes: preview (rendered), source (raw edit), readonly (non-editable source). Typed
+ * so each `id` is an {@link EditorViewMode}, letting callers pass `item.id` to `onViewModeChange` without a cast.
+ */
+export declare const defaultViewModeItems: Array<ViewModeItem & {
+    id: EditorViewMode;
+}>;
+/**
+ * Add view mode actions to the builder. `items` defaults to the three built-in editor view modes;
+ * callers pass an extended list to surface contributed modes (see {@link ViewModeItem}) in the same
+ * single-select dropdown. The trigger tracks the checked item (via the group's `applyActive`).
+ */
+export declare const addViewMode: (state: EditorToolbarState, onViewModeChange: (mode: EditorViewMode) => void, items?: ViewModeItem[]) => ActionGroupBuilderFn;
 //# sourceMappingURL=view-mode.d.ts.map

package/dist/types/src/components/EditorToolbar/view-mode.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"view-mode.d.ts","sourceRoot":"","sources":["../../../../../src/components/EditorToolbar/view-mode.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,KAAK,oBAAoB,EAAyC,MAAM,qBAAqB,CAAC;AACvG,OAAO,EAAE,KAAK,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAI5D,OAAO,EAAE,KAAK,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAQlD,4CAA4C;AAC5C,eAAO,MAAM,WAAW,UACd,kBAAkB,oBAAoB,CAAC,IAAI,EAAE,cAAc,KAAK,IAAI,KAAG,oBA6B9E,CAAC"}
+{"version":3,"file":"view-mode.d.ts","sourceRoot":"","sources":["../../../../../src/components/EditorToolbar/view-mode.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,KAAK,oBAAoB,EAAyC,MAAM,qBAAqB,CAAC;AACvG,OAAO,EAAE,KAAK,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAAE,KAAK,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAI5C,OAAO,EAAE,KAAK,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAElD;;;;;GAKG;AACH,MAAM,MAAM,YAAY,GAAG;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAC;CACvB,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,oBAAoB,EAAE,KAAK,CAAC,YAAY,GAAG;IAAE,EAAE,EAAE,cAAc,CAAA;CAAE,CAI7E,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,WAAW,UAEb,kBAAkB,oBACP,CAAC,IAAI,EAAE,cAAc,KAAK,IAAI,UACzC,YAAY,EAAE,KACpB,oBA+BF,CAAC"}

package/dist/types/src/components/index.d.ts

@@ -1,4 +1,5 @@
 export * from './Editor';
 export * from './EditorMenuProvider';
 export * from './EditorPreviewProvider';
+export * from './EditorToolbar/view-mode';
 //# sourceMappingURL=index.d.ts.map

package/dist/types/src/components/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/components/index.ts"],"names":[],"mappings":"AAIA,cAAc,UAAU,CAAC;AAEzB,cAAc,sBAAsB,CAAC;AACrC,cAAc,yBAAyB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/components/index.ts"],"names":[],"mappings":"AAIA,cAAc,UAAU,CAAC;AAEzB,cAAc,sBAAsB,CAAC;AACrC,cAAc,yBAAyB,CAAC;AACxC,cAAc,2BAA2B,CAAC"}

package/dist/types/src/index.d.ts

@@ -1,4 +1,3 @@
 export * from './components';
-export * from './extensions';
 export * from './hooks';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.ts"],"names":[],"mappings":"AAIA,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,SAAS,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.ts"],"names":[],"mappings":"AAIA,cAAc,cAAc,CAAC;AAC7B,cAAc,SAAS,CAAC"}

package/dist/types/src/stories/Assistant.stories.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Assistant.stories.d.ts","sourceRoot":"","sources":["../../../../src/stories/Assistant.stories.tsx"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAI5D,OAAO,KAAuC,MAAM,OAAO,CAAC;AAiB5D,OAAO,EAAU,KAAK,eAAe,EAAE,MAAM,eAAe,CAAC;AAqC7D,KAAK,SAAS,GAAG,IAAI,CAAC,eAAe,EAAE,OAAO,CAAC,CAAC;AAEhD,QAAA,MAAM,YAAY,UAAW,SAAS,sBAwBrC,CAAC;AAEF,QAAA,MAAM,IAAI,EAAE,IAAI,CAAC,OAAO,YAAY,CASnC,CAAC;eAEa,IAAI;AAEnB,KAAK,KAAK,GAAG,QAAQ,CAAC,OAAO,IAAI,CAAC,CAAC;AAEnC,eAAO,MAAM,OAAO,EAAE,KAUrB,CAAC"}

package/dist/types/src/stories/Automerge.stories.d.ts

@@ -1,44 +1,21 @@
-import { type StoryObj } from '@storybook/react-vite';
-declare const meta: {
-    title: string;
-    component: any;
-    decorators: import("@storybook/react").Decorator[];
-    parameters: {
-        layout: string;
-        translations: [{
-            readonly 'en-US': {
-                readonly "@dxos/react-ui-editor": {
-                    readonly 'comment.label': 'Create comment';
-                    readonly 'image.label': 'Insert image';
-                    readonly 'search.label': 'Search';
-                    readonly 'block.label': 'Block';
-                    readonly 'block.blockquote.label': 'Block quote';
-                    readonly 'block.codeblock.label': 'Code block';
-                    readonly 'block.table.label': 'Create table';
-                    readonly 'formatting.label': 'Formatting';
-                    readonly 'formatting.strong.label': 'Bold';
-                    readonly 'formatting.emphasis.label': 'Italics';
-                    readonly 'formatting.strikethrough.label': 'Strikethrough';
-                    readonly 'formatting.code.label': 'Code';
-                    readonly 'formatting.link.label': 'Link';
-                    readonly 'list.bullet.label': 'Bullet list';
-                    readonly 'list.ordered.label': 'Numbered list';
-                    readonly 'list.task.label': 'Task list';
-                    readonly 'heading.label': 'Heading level';
-                    readonly 'heading-level.label_zero': 'Paragraph';
-                    readonly 'heading-level.label_one': 'Heading level {{count}}';
-                    readonly 'heading-level.label_other': 'Heading level {{count}}';
-                    readonly 'view-mode.label': 'Editor view';
-                    readonly 'view-mode.preview.label': 'Markdown';
-                    readonly 'view-mode.source.label': 'Plain text';
-                    readonly 'view-mode.readonly.label': 'Read only';
-                };
-            };
-        }];
-    };
-};
+import { type Meta, type StoryObj } from '@storybook/react-vite';
+import React from 'react';
+/**
+ * Two editors bound to the same in-process Automerge document (no client or networking). Editing
+ * either column mutates the shared handle; the automerge data extension on the other column observes
+ * the handle's `change` event and reconciles, so the columns stay in sync. For true cross-peer
+ * replication over a transport, see the `WithEcho` story.
+ */
+declare const DefaultStory: () => React.JSX.Element;
+declare const meta: Meta<typeof DefaultStory>;
 export default meta;
 type Story = StoryObj<typeof meta>;
 export declare const Default: Story;
+/**
+ * Two in-memory ECHO peers (no real networking, see `withMultiClientProvider`) sharing a
+ * document, exercising the `Space.postMessage`/`listen` gossip channel and the CodeMirror
+ * `awareness` extension end to end. This covers the same wiring as the (currently skipped,
+ * flaky) composer-app e2e collaboration cursor test, deterministically and without a browser.
+ */
 export declare const WithEcho: Story;
 //# sourceMappingURL=Automerge.stories.d.ts.map

package/dist/types/src/stories/Automerge.stories.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Automerge.stories.d.ts","sourceRoot":"","sources":["../../../../src/stories/Automerge.stories.tsx"],"names":[],"mappings":"AAMA,OAAO,EAAa,KAAK,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAqIjE,QAAA,MAAM,IAAI;;eAEa,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAMW,CAAC;eAEvB,IAAI;AAEnB,KAAK,KAAK,GAAG,QAAQ,CAAC,OAAO,IAAI,CAAC,CAAC;AAGnC,eAAO,MAAM,OAAO,EAAE,KAErB,CAAC;AAGF,eAAO,MAAM,QAAQ,EAAE,KAiBtB,CAAC"}
+{"version":3,"file":"Automerge.stories.d.ts","sourceRoot":"","sources":["../../../../src/stories/Automerge.stories.tsx"],"names":[],"mappings":"AAIA,OAAO,EAAE,KAAK,IAAI,EAAE,KAAK,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACjE,OAAO,KAAuC,MAAM,OAAO,CAAC;AAsD5D;;;;;GAKG;AACH,QAAA,MAAM,YAAY,yBAgBjB,CAAC;AA0CF,QAAA,MAAM,IAAI,EAAE,IAAI,CAAC,OAAO,YAAY,CAQnC,CAAC;eAEa,IAAI;AAEnB,KAAK,KAAK,GAAG,QAAQ,CAAC,OAAO,IAAI,CAAC,CAAC;AAEnC,eAAO,MAAM,OAAO,EAAE,KAAU,CAAC;AAEjC;;;;;GAKG;AACH,eAAO,MAAM,QAAQ,EAAE,KAoDtB,CAAC"}

package/dist/types/src/stories/Blocks.stories.d.ts

@@ -0,0 +1,10 @@
+import type { Meta, StoryObj } from '@storybook/react-vite';
+import React from 'react';
+import { type EditorViewProps } from '../components';
+type StoryArgs = Pick<EditorViewProps, 'value'>;
+declare const DefaultStory: (props: StoryArgs) => React.JSX.Element;
+declare const meta: Meta<typeof DefaultStory>;
+export default meta;
+type Story = StoryObj<typeof meta>;
+export declare const Default: Story;
+//# sourceMappingURL=Blocks.stories.d.ts.map

package/dist/types/src/stories/Blocks.stories.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Blocks.stories.d.ts","sourceRoot":"","sources":["../../../../src/stories/Blocks.stories.tsx"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,KAAkB,MAAM,OAAO,CAAC;AAevC,OAAO,EAAU,KAAK,eAAe,EAAE,MAAM,eAAe,CAAC;AAM7D,KAAK,SAAS,GAAG,IAAI,CAAC,eAAe,EAAE,OAAO,CAAC,CAAC;AAEhD,QAAA,MAAM,YAAY,UAAW,SAAS,sBAkBrC,CAAC;AAEF,QAAA,MAAM,IAAI,EAAE,IAAI,CAAC,OAAO,YAAY,CAQnC,CAAC;eAEa,IAAI;AAEnB,KAAK,KAAK,GAAG,QAAQ,CAAC,OAAO,IAAI,CAAC,CAAC;AAoBnC,eAAO,MAAM,OAAO,EAAE,KAErB,CAAC"}

package/dist/types/src/stories/Comments.stories.d.ts

@@ -1,25 +1,64 @@
 import { type StoryObj } from '@storybook/react-vite';
 import React from 'react';
+import { type Comment } from '@dxos/ui-editor/types';
+type StoryArgs = {
+    content?: string;
+    comments?: Comment[];
+};
 declare const meta: {
     title: string;
-    component: React.ForwardRefExoticComponent<Pick<import("..").UseTextEditorProps, "extensions" | "id" | "scrollTo" | "selection"> & Pick<import("@dxos/ui-editor").ThemeExtensionsOptions, "slots"> & {
-        debug?: import("./components").DebugMode;
-        debugCustom?: (view: import("@codemirror/view").EditorView) => React.ReactNode;
-        text?: string;
-        object?: import("@dxos/echo/Obj").OfShape<import("@dxos/echo/testing").TestSchema.Expando>;
-        readOnly?: boolean;
-        placeholder?: string;
-        lineNumbers?: boolean;
-        monospace?: boolean;
-        onReady?: (view: import("@codemirror/view").EditorView) => void;
-    } & React.RefAttributes<import("..").EditorController>>;
+    render: (args: StoryArgs) => React.JSX.Element;
     decorators: import("@storybook/react").Decorator[];
     parameters: {
         layout: string;
+        translations: [{
+            readonly 'en-US': {
+                readonly "@dxos/react-ui-editor": {
+                    readonly 'comment.label': 'Create comment';
+                    readonly 'image.label': 'Insert image';
+                    readonly 'search.label': 'Search';
+                    readonly 'block.label': 'Block';
+                    readonly 'block.blockquote.label': 'Block quote';
+                    readonly 'block.codeblock.label': 'Code block';
+                    readonly 'block.table.label': 'Create table';
+                    readonly 'formatting.label': 'Formatting';
+                    readonly 'formatting.strong.label': 'Bold';
+                    readonly 'formatting.emphasis.label': 'Italics';
+                    readonly 'formatting.strikethrough.label': 'Strikethrough';
+                    readonly 'formatting.code.label': 'Code';
+                    readonly 'formatting.link.label': 'Link';
+                    readonly 'list.bullet.label': 'Bullet list';
+                    readonly 'list.ordered.label': 'Numbered list';
+                    readonly 'list.task.label': 'Task list';
+                    readonly 'heading.label': 'Heading level';
+                    readonly 'heading-level.label_zero': 'Paragraph';
+                    readonly 'heading-level.label_one': 'Heading level {{count}}';
+                    readonly 'heading-level.label_other': 'Heading level {{count}}';
+                    readonly 'view-mode.label': 'Editor view';
+                    readonly 'view-mode.preview.label': 'Markdown';
+                    readonly 'view-mode.source.label': 'Plain text';
+                    readonly 'view-mode.readonly.label': 'Read only';
+                };
+            };
+        }];
     };
 };
 export default meta;
-type Story = StoryObj<typeof meta>;
-export declare const Comments: Story;
-export declare const Annotations: Story;
+type Story = StoryObj<StoryArgs>;
+export declare const Default: Story;
+/**
+ * Regression: clicking INSIDE a comment must be detected. The highlight-layer rectangles are drawn over
+ * the comment text; if they intercept the click (no `pointer-events: none`), it never reaches
+ * `handleCommentClick` and the thread isn't selected. Asserts the clicked comment becomes current.
+ */
+export declare const ClickSelectsComment: Story;
+/**
+ * Regression (app repro): a click on a comment often lands on the `.cm-line` (an ANCESTOR of the
+ * `.cm-comment` span), because the highlight-layer rectangles sit over the text with
+ * `pointer-events: none` and pass the click through to the line. An upward DOM-target walk never finds
+ * the span's `data-comment-id`, so `handleCommentClick` must fall back to a `posAtCoords` hit-test.
+ * Dispatches the click ON the line element (target = line) at the comment's coordinates and asserts the
+ * thread is still selected — this is exactly the "first click ignored" case seen in the app.
+ */
+export declare const ClickThroughLineSelectsComment: Story;
 //# sourceMappingURL=Comments.stories.d.ts.map

package/dist/types/src/stories/Comments.stories.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Comments.stories.d.ts","sourceRoot":"","sources":["../../../../src/stories/Comments.stories.tsx"],"names":[],"mappings":"AAKA,OAAO,EAAa,KAAK,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACjE,OAAO,KAAuC,MAAM,OAAO,CAAC;AAa5D,QAAA,MAAM,IAAI;;;;;;;;;;;;;;;QAKN,MAAM;;CAE0B,CAAC;eAEtB,IAAI;AAEnB,KAAK,KAAK,GAAG,QAAQ,CAAC,OAAO,IAAI,CAAC,CAAC;AA4CnC,eAAO,MAAM,QAAQ,EAAE,KAEtB,CAAC;AAyBF,eAAO,MAAM,WAAW,EAAE,KAIzB,CAAC"}
+{"version":3,"file":"Comments.stories.d.ts","sourceRoot":"","sources":["../../../../src/stories/Comments.stories.tsx"],"names":[],"mappings":"AAKA,OAAO,EAAa,KAAK,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACjE,OAAO,KAAgD,MAAM,OAAO,CAAC;AAyBrE,OAAO,EAAE,KAAK,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAUrD,KAAK,SAAS,GAAG;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,OAAO,EAAE,CAAC;CACtB,CAAC;AA4KF,QAAA,MAAM,IAAI;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAQ2B,CAAC;eAEvB,IAAI;AAEnB,KAAK,KAAK,GAAG,QAAQ,CAAC,SAAS,CAAC,CAAC;AAEjC,eAAO,MAAM,OAAO,EAAE,KAUrB,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,EAAE,KAkBjC,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,8BAA8B,EAAE,KA6B5C,CAAC"}

package/dist/types/src/stories/Diff.stories.d.ts

@@ -0,0 +1,32 @@
+import { type StoryObj } from '@storybook/react-vite';
+import React from 'react';
+declare const meta: {
+    title: string;
+    component: React.ForwardRefExoticComponent<Pick<import("..").UseTextEditorProps, "extensions" | "id" | "scrollTo" | "selection"> & Pick<import("@dxos/ui-editor").ThemeExtensionsOptions, "slots"> & {
+        debug?: import("./components").DebugMode;
+        debugCustom?: (view: import("@codemirror/view").EditorView) => React.ReactNode;
+        text?: string;
+        object?: import("@dxos/echo/Obj").OfShape<import("@dxos/echo/testing").TestSchema.Expando>;
+        readOnly?: boolean;
+        placeholder?: string;
+        lineNumbers?: boolean;
+        monospace?: boolean;
+        onReady?: (view: import("@codemirror/view").EditorView) => void;
+    } & React.RefAttributes<import("..").EditorController>>;
+    decorators: import("@storybook/react").Decorator[];
+    parameters: {
+        layout: string;
+        controls: {
+            disable: boolean;
+        };
+    };
+};
+export default meta;
+type Story = StoryObj<typeof meta>;
+/**
+ * Inline (unified) diff of two markdown versions — what the branch compare view renders. The editor
+ * stays editable: typing updates the diff against `original` live (you edit the current branch while
+ * viewing the diff to another branch).
+ */
+export declare const Markdown: Story;
+//# sourceMappingURL=Diff.stories.d.ts.map

package/dist/types/src/stories/Diff.stories.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Diff.stories.d.ts","sourceRoot":"","sources":["../../../../src/stories/Diff.stories.tsx"],"names":[],"mappings":"AAIA,OAAO,EAAa,KAAK,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACjE,OAAO,KAAK,MAAM,OAAO,CAAC;AAqB1B,QAAA,MAAM,IAAI;;;;;;;;;;;;;;;QAKN,MAAM;QACN,QAAQ;YAAI,OAAO;;;CAEa,CAAC;eAEtB,IAAI;AAEnB,KAAK,KAAK,GAAG,QAAQ,CAAC,OAAO,IAAI,CAAC,CAAC;AAEnC;;;;GAIG;AACH,eAAO,MAAM,QAAQ,EAAE,KAEtB,CAAC"}

package/dist/types/src/stories/Experimental.stories.d.ts

@@ -23,4 +23,5 @@ type Story = StoryObj<typeof meta>;
 export declare const Snippets: Story;
 export declare const Blast: Story;
 export declare const DND: Story;
+export declare const Annotations: Story;
 //# sourceMappingURL=Experimental.stories.d.ts.map

package/dist/types/src/stories/Experimental.stories.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Experimental.stories.d.ts","sourceRoot":"","sources":["../../../../src/stories/Experimental.stories.tsx"],"names":[],"mappings":"AAIA,OAAO,EAAa,KAAK,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAEjE,OAAO,KAAK,MAAM,OAAO,CAAC;AAS1B,QAAA,MAAM,IAAI;;;;;;;;;;;;;;;QAKN,MAAM;;CAE0B,CAAC;eAEtB,IAAI;AAEnB,KAAK,KAAK,GAAG,QAAQ,CAAC,OAAO,IAAI,CAAC,CAAC;AAQnC,eAAO,MAAM,QAAQ,EAAE,KAOtB,CAAC;AAMF,eAAO,MAAM,KAAK,EAAE,KAqBnB,CAAC;AAMF,eAAO,MAAM,GAAG,EAAE,KAajB,CAAC"}
+{"version":3,"file":"Experimental.stories.d.ts","sourceRoot":"","sources":["../../../../src/stories/Experimental.stories.tsx"],"names":[],"mappings":"AAIA,OAAO,EAAa,KAAK,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAEjE,OAAO,KAAK,MAAM,OAAO,CAAC;AAU1B,QAAA,MAAM,IAAI;;;;;;;;;;;;;;;QAKN,MAAM;;CAE0B,CAAC;eAEtB,IAAI;AAEnB,KAAK,KAAK,GAAG,QAAQ,CAAC,OAAO,IAAI,CAAC,CAAC;AAQnC,eAAO,MAAM,QAAQ,EAAE,KAOtB,CAAC;AAMF,eAAO,MAAM,KAAK,EAAE,KAqBnB,CAAC;AAMF,eAAO,MAAM,GAAG,EAAE,KAajB,CAAC;AAMF,eAAO,MAAM,WAAW,EAAE,KAIzB,CAAC"}

package/dist/types/src/stories/Folding.stories.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Stories for turn folding: a chat transcript is treated as a sequence of turns, and each turn's
+ * response is a foldable region built on CodeMirror's native folding. The fold ranges are supplied
+ * by the story via a `TurnSource` — here, one that scans `<prompt>` boundaries (a user turn is a
+ * `<prompt>` element; the response is everything up to the next prompt).
+ */
+import { type StoryObj } from '@storybook/react-vite';
+declare const meta: {
+    title: string;
+    decorators: import("@storybook/react").Decorator[];
+    parameters: {
+        layout: string;
+    };
+};
+export default meta;
+type Story = StoryObj<typeof meta>;
+export declare const Default: Story;
+//# sourceMappingURL=Folding.stories.d.ts.map

package/dist/types/src/stories/Folding.stories.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Folding.stories.d.ts","sourceRoot":"","sources":["../../../../src/stories/Folding.stories.tsx"],"names":[],"mappings":"AAIA;;;;;GAKG;AAEH,OAAO,EAAa,KAAK,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAgGjE,QAAA,MAAM,IAAI;;;;QAGM,MAAM;;CACN,CAAC;eAEF,IAAI;AAEnB,KAAK,KAAK,GAAG,QAAQ,CAAC,OAAO,IAAI,CAAC,CAAC;AAEnC,eAAO,MAAM,OAAO,EAAE,KAErB,CAAC"}

package/dist/types/src/stories/Outliner.stories.d.ts

@@ -1,11 +1,10 @@
 import { type StoryObj } from '@storybook/react-vite';
 import React from 'react';
-type StoryArgs = {
-    text?: string;
-};
+import { EditorStoryProps } from './components';
+type StoryArgs = EditorStoryProps;
 declare const meta: {
     title: string;
-    render: ({ text }: StoryArgs) => React.JSX.Element;
+    render: (props: StoryArgs) => React.JSX.Element;
     decorators: import("@storybook/react").Decorator[];
     parameters: {
         layout: string;
@@ -14,6 +13,7 @@ declare const meta: {
 export default meta;
 type Story = StoryObj<typeof meta>;
 export declare const Empty: Story;
+export declare const Paragraphs: Story;
 export declare const Basic: Story;
 export declare const Nested: Story;
 export declare const Continuation: Story;

package/dist/types/src/stories/Outliner.stories.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Outliner.stories.d.ts","sourceRoot":"","sources":["../../../../src/stories/Outliner.stories.tsx"],"names":[],"mappings":"AAIA,OAAO,EAAa,KAAK,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACjE,OAAO,KAAyC,MAAM,OAAO,CAAC;AAS9D,KAAK,SAAS,GAAG;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,CAAC;AAmDF,QAAA,MAAM,IAAI;;uBAjDsB,SAAS;;;QAsDrC,MAAM;;CAE2B,CAAC;eAEvB,IAAI;AAEnB,KAAK,KAAK,GAAG,QAAQ,CAAC,OAAO,IAAI,CAAC,CAAC;AAEnC,eAAO,MAAM,KAAK,EAAE,KAEnB,CAAC;AAEF,eAAO,MAAM,KAAK,EAAE,KAanB,CAAC;AAEF,eAAO,MAAM,MAAM,EAAE,KAapB,CAAC;AAEF,eAAO,MAAM,YAAY,EAAE,KAgB1B,CAAC"}
+{"version":3,"file":"Outliner.stories.d.ts","sourceRoot":"","sources":["../../../../src/stories/Outliner.stories.tsx"],"names":[],"mappings":"AAIA,OAAO,EAAa,KAAK,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACjE,OAAO,KAAyC,MAAM,OAAO,CAAC;AAQ9D,OAAO,EAAe,gBAAgB,EAAgB,MAAM,cAAc,CAAC;AAE3E,KAAK,SAAS,GAAG,gBAAgB,CAAC;AAmDlC,QAAA,MAAM,IAAI;;oBAjDmB,SAAS;;;QAsDlC,MAAM;;CAE2B,CAAC;eAEvB,IAAI;AAEnB,KAAK,KAAK,GAAG,QAAQ,CAAC,OAAO,IAAI,CAAC,CAAC;AAEnC,eAAO,MAAM,KAAK,EAAE,KAEnB,CAAC;AAEF,eAAO,MAAM,UAAU,EAAE,KAQxB,CAAC;AAEF,eAAO,MAAM,KAAK,EAAE,KAcnB,CAAC;AAEF,eAAO,MAAM,MAAM,EAAE,KAcpB,CAAC;AAEF,eAAO,MAAM,YAAY,EAAE,KAgB1B,CAAC"}

package/dist/types/src/stories/Popover.stories.d.ts

@@ -1,12 +1,12 @@
 import { type StoryObj } from '@storybook/react-vite';
 import React from 'react';
-import { type UseEditorMenuProps } from '../components';
-type StoryArgs = Omit<UseEditorMenuProps, 'viewRef'> & {
+import { type EditorMenuProviderProps, type UseEditorMenuProps } from '../components';
+type StoryArgs = Omit<UseEditorMenuProps, 'viewRef'> & Pick<EditorMenuProviderProps, 'searchPlaceholder'> & {
     text: string;
 };
 declare const meta: {
     title: string;
-    render: ({ text, ...props }: StoryArgs) => React.JSX.Element;
+    render: ({ text, searchPlaceholder, ...props }: StoryArgs) => React.JSX.Element;
     decorators: import("@storybook/react").Decorator[];
     parameters: {
         layout: string;

package/dist/types/src/stories/Popover.stories.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Popover.stories.d.ts","sourceRoot":"","sources":["../../../../src/stories/Popover.stories.tsx"],"names":[],"mappings":"AAIA,OAAO,EAAa,KAAK,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACjE,OAAO,KAAgC,MAAM,OAAO,CAAC;AAUrD,OAAO,EAKL,KAAK,kBAAkB,EAMxB,MAAM,eAAe,CAAC;AAmBvB,KAAK,SAAS,GAAG,IAAI,CAAC,kBAAkB,EAAE,SAAS,CAAC,GAAG;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAyDxE,QAAA,MAAM,IAAI;;iCAvDgC,SAAS;;;QA4D/C,MAAM;;CAE2B,CAAC;eAEvB,IAAI;AAEnB,KAAK,KAAK,GAAG,QAAQ,CAAC,OAAO,IAAI,CAAC,CAAC;AAEnC,eAAO,MAAM,OAAO,EAAE,KAOrB,CAAC;AAEF,eAAO,MAAM,UAAU,EAAE,KASxB,CAAC;AAEF,eAAO,MAAM,IAAI,EAAE,KAsBlB,CAAC"}
+{"version":3,"file":"Popover.stories.d.ts","sourceRoot":"","sources":["../../../../src/stories/Popover.stories.tsx"],"names":[],"mappings":"AAIA,OAAO,EAAa,KAAK,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACjE,OAAO,KAAgC,MAAM,OAAO,CAAC;AAUrD,OAAO,EAKL,KAAK,uBAAuB,EAC5B,KAAK,kBAAkB,EAMxB,MAAM,eAAe,CAAC;AAmBvB,KAAK,SAAS,GAAG,IAAI,CAAC,kBAAkB,EAAE,SAAS,CAAC,GAClD,IAAI,CAAC,uBAAuB,EAAE,mBAAmB,CAAC,GAAG;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AA0ExE,QAAA,MAAM,IAAI;;oDAxEmD,SAAS;;;QA6ElE,MAAM;;CAE2B,CAAC;eAEvB,IAAI;AAEnB,KAAK,KAAK,GAAG,QAAQ,CAAC,OAAO,IAAI,CAAC,CAAC;AAEnC,eAAO,MAAM,OAAO,EAAE,KAOrB,CAAC;AAEF,eAAO,MAAM,UAAU,EAAE,KASxB,CAAC;AAEF,eAAO,MAAM,IAAI,EAAE,KAyBlB,CAAC"}

package/dist/types/src/stories/Suggest.stories.d.ts

@@ -0,0 +1,27 @@
+import { type StoryObj } from '@storybook/react-vite';
+import React from 'react';
+import { type EditorViewProps } from '../components';
+declare const meta: {
+    title: string;
+    render: (args: EditorViewProps) => React.JSX.Element;
+    decorators: import("@storybook/react").Decorator[];
+    parameters: {
+        layout: string;
+    };
+};
+export default meta;
+type Story = StoryObj<typeof meta>;
+/** The branch's changes rendered over the parent as accept/reject suggestions. */
+export declare const Default: Story;
+/**
+ * Accept applies a change to the document (merging it into the parent); Reject hides a change without
+ * altering the document. Deterministic — no AI, so it runs in CI.
+ */
+export declare const AcceptReject: Story;
+/**
+ * Two authors reviewing the same base, overlapping on one word. Each change is independently
+ * attributable and accepting one re-diffs the rest (the overlapping author's change persists).
+ * Deterministic — no AI, so it runs in CI.
+ */
+export declare const MultipleAuthors: Story;
+//# sourceMappingURL=Suggest.stories.d.ts.map

package/dist/types/src/stories/Suggest.stories.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Suggest.stories.d.ts","sourceRoot":"","sources":["../../../../src/stories/Suggest.stories.tsx"],"names":[],"mappings":"AAIA,OAAO,EAAa,KAAK,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACjE,OAAO,KAAkB,MAAM,OAAO,CAAC;AAkBvC,OAAO,EAAU,KAAK,eAAe,EAAE,MAAM,eAAe,CAAC;AAuF7D,QAAA,MAAM,IAAI;;mBArDY,eAAe;;;QA0DjC,MAAM;;CAEqB,CAAC;eAEjB,IAAI;AAEnB,KAAK,KAAK,GAAG,QAAQ,CAAC,OAAO,IAAI,CAAC,CAAC;AAEnC,kFAAkF;AAClF,eAAO,MAAM,OAAO,EAAE,KAAU,CAAC;AAEjC;;;GAGG;AACH,eAAO,MAAM,YAAY,EAAE,KA8B1B,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,eAAe,EAAE,KA+B7B,CAAC"}

package/dist/types/src/stories/TrackChanges.stories.d.ts

@@ -0,0 +1,44 @@
+import { type StoryObj } from '@storybook/react-vite';
+import React from 'react';
+import { type EditorViewProps } from '../components';
+type RenderProps = EditorViewProps & {
+    branch: string;
+};
+declare const meta: {
+    title: string;
+    render: ({ branch, ...args }: RenderProps) => React.JSX.Element;
+    decorators: import("@storybook/react").Decorator[];
+    parameters: {
+        layout: string;
+    };
+};
+export default meta;
+type Story = StoryObj<typeof meta>;
+/**
+ * Interactive "Suggesting mode" (bind-to-branch): the editor is bound to a branch that starts equal to
+ * MAIN, so it opens clean. Type to feel the tracked-change ergonomics:
+ *
+ * - Type — the added characters appear as an underlined, cyan insertion (character-level, so editing
+ *   inside a word marks only the changed characters, not the whole word).
+ * - Select text and delete it — the removed characters stay visible as a struck-through phantom
+ *   (`~~old~~`), because they are absent from the branch but present in main.
+ * - Replace text — you get both at once, `~~old~~new`, at character granularity.
+ * - Move the caret across a phantom with the arrow keys — it is stepped over as one unit.
+ * - Press Backspace with the caret just after a phantom — the real branch text behind it is protected
+ *   (the keystroke is swallowed rather than eating the hidden character).
+ */
+export declare const Default: Story;
+/**
+ * A branch that has already diverged from main, so tracked changes render on mount without typing:
+ * `swiftly ` inserted after "jumps" and `lazy ` deleted — both clean whole-word edits so the
+ * character-level diff yields contiguous hunks. Deterministic — used for the render smoke test.
+ */
+export declare const Divergent: Story;
+/**
+ * A foreign author's proposal (Bob: "lazy"→"sleepy") layered over the tester's own live edits. The
+ * overlay is diffed against MAIN (not the branch), so after the tester types, their new text is tracked
+ * as a self-insertion and is NOT struck by Bob's overlay, while Bob's change still renders. This is the
+ * multi-author case the old (diff-vs-document) overlay could not support. Deterministic — runs in CI.
+ */
+export declare const WithForeignAuthor: Story;
+//# sourceMappingURL=TrackChanges.stories.d.ts.map

package/dist/types/src/stories/TrackChanges.stories.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TrackChanges.stories.d.ts","sourceRoot":"","sources":["../../../../src/stories/TrackChanges.stories.tsx"],"names":[],"mappings":"AAIA,OAAO,EAAa,KAAK,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACjE,OAAO,KAAkB,MAAM,OAAO,CAAC;AAevC,OAAO,EAAU,KAAK,eAAe,EAAE,MAAM,eAAe,CAAC;AAwB7D,KAAK,WAAW,GAAG,eAAe,GAAG;IAAE,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAiDxD,QAAA,MAAM,IAAI;;kCA/C2B,WAAW;;;QAoD5C,MAAM;;CAEqB,CAAC;eAEjB,IAAI;AAEnB,KAAK,KAAK,GAAG,QAAQ,CAAC,OAAO,IAAI,CAAC,CAAC;AAEnC;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,OAAO,EAAE,KAErB,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,SAAS,EAAE,KA2BvB,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,iBAAiB,EAAE,KA8D/B,CAAC"}

package/dist/types/src/stories/Widgets.stories.d.ts

@@ -22,4 +22,16 @@ export declare const XmlTags: Story;
  * Markdown image/link URLs (echo:/…) trigger block widgets via xmlTags.
  */
 export declare const Preview: Story;
+/**
+ * A fixed-height (400px) `echo:` block embed in a long scrollable document. Sets `estimatedHeight`
+ * from the label so CM reserves the right space, matching the plugin-markdown sketch embed. Use this
+ * to reproduce scroll behavior: scroll the block off-screen and back, and past the viewport edges.
+ */
+export declare const PreviewScroll: Story;
+/**
+ * Same long scrollable document as `PreviewScroll`, but the block renders a Surface-like component
+ * (async mount + inner ResizeObserver). Use this to reproduce the scroll jump that only appears with
+ * Surface-backed embeds, and to verify fixes against it.
+ */
+export declare const PreviewScrollSurface: Story;
 //# sourceMappingURL=Widgets.stories.d.ts.map

package/dist/types/src/stories/Widgets.stories.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Widgets.stories.d.ts","sourceRoot":"","sources":["../../../../src/stories/Widgets.stories.tsx"],"names":[],"mappings":"AAIA;;;;;GAKG;AAEH,OAAO,EAAa,KAAK,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AA8IjE,QAAA,MAAM,IAAI;;;;QAGM,MAAM;;CACN,CAAC;eAEF,IAAI;AAEnB,KAAK,KAAK,GAAG,QAAQ,CAAC,OAAO,IAAI,CAAC,CAAC;AAkBnC;;GAEG;AACH,eAAO,MAAM,OAAO,EAAE,KAErB,CAAC;AAiBF;;GAEG;AACH,eAAO,MAAM,OAAO,EAAE,KAoCrB,CAAC"}
+{"version":3,"file":"Widgets.stories.d.ts","sourceRoot":"","sources":["../../../../src/stories/Widgets.stories.tsx"],"names":[],"mappings":"AAIA;;;;;GAKG;AAEH,OAAO,EAAa,KAAK,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAkNjE,QAAA,MAAM,IAAI;;;;QAGM,MAAM;;CACN,CAAC;eAEF,IAAI;AAEnB,KAAK,KAAK,GAAG,QAAQ,CAAC,OAAO,IAAI,CAAC,CAAC;AAkBnC;;GAEG;AACH,eAAO,MAAM,OAAO,EAAE,KAErB,CAAC;AAmBF;;GAEG;AACH,eAAO,MAAM,OAAO,EAAE,KAoCrB,CAAC;AAYF;;;;GAIG;AACH,eAAO,MAAM,aAAa,EAAE,KA6B3B,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,EAAE,KA6BlC,CAAC"}

package/dist/types/src/stories/components/EditorStory.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"EditorStory.d.ts","sourceRoot":"","sources":["../../../../../src/stories/components/EditorStory.tsx"],"names":[],"mappings":"AAIA,OAAO,EAAE,KAAK,UAAU,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,KAAK,EAAE,EAAE,KAAK,SAAS,EAAyE,MAAM,OAAO,CAAC;AAErH,OAAO,EAAE,GAAG,EAAE,MAAM,YAAY,CAAC;AACjC,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAOhD,OAAO,EAEL,KAAK,sBAAsB,EAM5B,MAAM,iBAAiB,CAAC;AAIzB,OAAO,EAAE,KAAK,gBAAgB,EAA0B,MAAM,kBAAkB,CAAC;AACjF,OAAO,EAAE,KAAK,kBAAkB,EAAiB,MAAM,aAAa,CAAC;AAGrE,MAAM,MAAM,SAAS,GAAG,KAAK,GAAG,MAAM,GAAG,UAAU,CAAC;AAIpD,MAAM,MAAM,gBAAgB,GAAG,IAAI,CAAC,kBAAkB,EAAE,IAAI,GAAG,UAAU,GAAG,WAAW,GAAG,YAAY,CAAC,GACrG,IAAI,CAAC,sBAAsB,EAAE,OAAO,CAAC,GAAG;IACtC,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,WAAW,CAAC,EAAE,CAAC,IAAI,EAAE,UAAU,KAAK,SAAS,CAAC;IAC9C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,GAAG,CAAC,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;IACzC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE,UAAU,KAAK,IAAI,CAAC;CACtC,CAAC;AAEJ,eAAO,MAAM,WAAW;YAXZ,SAAS;kBACH,CAAC,IAAI,EAAE,UAAU,KAAK,SAAS;WACtC,MAAM;aACJ,GAAG,CAAC,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC;eAC7B,OAAO;kBACJ,MAAM;kBACN,OAAO;gBACT,OAAO;cACT,CAAC,IAAI,EAAE,UAAU,KAAK,IAAI;0CAgDvC,CAAC"}
+{"version":3,"file":"EditorStory.d.ts","sourceRoot":"","sources":["../../../../../src/stories/components/EditorStory.tsx"],"names":[],"mappings":"AAIA,OAAO,EAAE,KAAK,UAAU,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,KAAK,EAAE,EAAE,KAAK,SAAS,EAAyE,MAAM,OAAO,CAAC;AAErH,OAAO,EAAE,GAAG,EAAE,MAAM,YAAY,CAAC;AACjC,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAMhD,OAAO,EAEL,KAAK,sBAAsB,EAM5B,MAAM,iBAAiB,CAAC;AAIzB,OAAO,EAAE,KAAK,gBAAgB,EAA0B,MAAM,kBAAkB,CAAC;AACjF,OAAO,EAAE,KAAK,kBAAkB,EAAiB,MAAM,aAAa,CAAC;AAGrE,MAAM,MAAM,SAAS,GAAG,KAAK,GAAG,MAAM,GAAG,UAAU,CAAC;AAIpD,MAAM,MAAM,gBAAgB,GAAG,IAAI,CAAC,kBAAkB,EAAE,IAAI,GAAG,UAAU,GAAG,WAAW,GAAG,YAAY,CAAC,GACrG,IAAI,CAAC,sBAAsB,EAAE,OAAO,CAAC,GAAG;IACtC,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,WAAW,CAAC,EAAE,CAAC,IAAI,EAAE,UAAU,KAAK,SAAS,CAAC;IAC9C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,GAAG,CAAC,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;IACzC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE,UAAU,KAAK,IAAI,CAAC;CACtC,CAAC;AAEJ,eAAO,MAAM,WAAW;YAXZ,SAAS;kBACH,CAAC,IAAI,EAAE,UAAU,KAAK,SAAS;WACtC,MAAM;aACJ,GAAG,CAAC,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC;eAC7B,OAAO;kBACJ,MAAM;kBACN,OAAO;gBACT,OAAO;cACT,CAAC,IAAI,EAAE,UAAU,KAAK,IAAI;0CAgDvC,CAAC"}

package/dist/types/src/stories/components/util.d.ts

@@ -4,6 +4,22 @@ import { type EditorSelectionState } from '@dxos/ui-editor';
 import { type RenderCallback } from '@dxos/ui-editor/types';
 export declare const num: () => string;
 export declare const img = "![dxos](https://dxos.network/dxos-logotype-blue.png)";
+export type GenerateListOptions = {
+    /** Maximum nesting depth. */
+    depth?: number;
+    /** Children per node — a fixed count or an inclusive `[min, max]` range. */
+    children?: number | [number, number];
+    /** Emit task markers (`- [ ]`) rather than plain bullets (`- `). */
+    task?: boolean;
+    /** Spaces of indentation per level. */
+    indent?: number;
+    /** Content generator for each item (default: a lorem sentence). */
+    content?: () => string;
+};
+/**
+ * Generates a hierarchical markdown list for the outliner stories. Deterministic under `random.seed`.
+ */
+export declare const generateList: ({ depth, children, task, indent, content, }?: GenerateListOptions) => string;
 export declare const code: string;
 export declare const content: {
     tasks: string;

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

@@ -1 +1 @@
-{"version":3,"file":"util.d.ts","sourceRoot":"","sources":["../../../../../src/stories/components/util.tsx"],"names":[],"mappings":"AAIA,OAAO,EAAE,KAAK,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAC3D,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAInD,OAAO,EACL,KAAK,oBAAoB,EAO1B,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,KAAK,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAK5D,eAAO,MAAM,GAAG,cAAkE,CAAC;AAEnF,eAAO,MAAM,GAAG,yDAAyD,CAAC;AAE1E,eAAO,MAAM,IAAI,QAQhB,CAAC;AAGF,eAAO,MAAM,OAAO;IAClB,KAAK;IAYL,OAAO;IAYP,QAAQ;IAkBR,UAAU;IAEV,UAAU;IAcV,OAAO;IAYP,KAAK;IAYL,KAAK;IAYL,KAAK;IAEL,QAAQ;IAMR,UAAU;IAQV,WAAW;IAcX,UAAU;IAEV,MAAM;CACP,CAAC;AAGF,eAAO,MAAM,IAAI,QAyBhB,CAAC;AAGF,eAAO,MAAM,KAAK,EAAE,UAAU,EAM7B,CAAC;AAEF,eAAO,MAAM,KAAK,UAA4E,CAAC;AAK/F,eAAO,MAAM,iBAAiB,EAAE,cAAc,CAAC;IAAE,GAAG,EAAE,MAAM,CAAA;CAAE,CAQ7D,CAAC;AAEF,eAAO,MAAM,gBAAgB,EAAE,cAAc,CAAC;IAAE,GAAG,EAAE,MAAM,CAAA;CAAE,CAO5D,CAAC;AAGF,eAAO,MAAM,iBAAiB,EAAE,SAAS,EAIxC,CAAC;AAEF,eAAO,MAAM,aAAa,EAAE,SAAS,EAOpC,CAAC;AAGF,eAAO,MAAM,QAAQ,QAEN,CAAC;AAEhB,eAAO,MAAM,eAAe,QAGb,CAAC;AAEhB,eAAO,MAAM,QAAQ,QAIpB,CAAC;AAEF,eAAO,MAAM,MAAM,mCAA0C,CAAC"}
+{"version":3,"file":"util.d.ts","sourceRoot":"","sources":["../../../../../src/stories/components/util.tsx"],"names":[],"mappings":"AAIA,OAAO,EAAE,KAAK,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAC3D,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAInD,OAAO,EACL,KAAK,oBAAoB,EAQ1B,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,KAAK,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAO5D,eAAO,MAAM,GAAG,cAAkE,CAAC;AAEnF,eAAO,MAAM,GAAG,yDAAyD,CAAC;AAE1E,MAAM,MAAM,mBAAmB,GAAG;IAChC,6BAA6B;IAC7B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,4EAA4E;IAC5E,QAAQ,CAAC,EAAE,MAAM,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACrC,oEAAoE;IACpE,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,uCAAuC;IACvC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,mEAAmE;IACnE,OAAO,CAAC,EAAE,MAAM,MAAM,CAAC;CACxB,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,YAAY,iDAMtB,mBAAmB,KAAQ,MAW7B,CAAC;AAEF,eAAO,MAAM,IAAI,QAQhB,CAAC;AAGF,eAAO,MAAM,OAAO;IAClB,KAAK;IAYL,OAAO;IAYP,QAAQ;IAkBR,UAAU;IAEV,UAAU;IAcV,OAAO;IAYP,KAAK;IAYL,KAAK;IAYL,KAAK;IAEL,QAAQ;IAMR,UAAU;IAQV,WAAW;IAcX,UAAU;IAEV,MAAM;CACP,CAAC;AAGF,eAAO,MAAM,IAAI,QAyBhB,CAAC;AAGF,eAAO,MAAM,KAAK,EAAE,UAAU,EAM7B,CAAC;AAEF,eAAO,MAAM,KAAK,UAA4E,CAAC;AAK/F,eAAO,MAAM,iBAAiB,EAAE,cAAc,CAAC;IAAE,GAAG,EAAE,MAAM,CAAA;CAAE,CAQ7D,CAAC;AAEF,eAAO,MAAM,gBAAgB,EAAE,cAAc,CAAC;IAAE,GAAG,EAAE,MAAM,CAAA;CAAE,CAO5D,CAAC;AAGF,eAAO,MAAM,iBAAiB,EAAE,SAAS,EAIxC,CAAC;AAEF,eAAO,MAAM,aAAa,EAAE,SAAS,EAOpC,CAAC;AAGF,eAAO,MAAM,QAAQ,QAEN,CAAC;AAEhB,eAAO,MAAM,eAAe,QAGb,CAAC;AAEhB,eAAO,MAAM,QAAQ,QAIpB,CAAC;AAEF,eAAO,MAAM,MAAM,mCAA0C,CAAC"}