@ecsplico/editor 2.1.1 → 3.0.0

package/dist/features/comments/components/CommentThreadView.vue.d.ts

@@ -1,6 +1,7 @@
 import { AuthorIdentity } from "../../../core/feature.js";
+import { CommentThread } from "../../../core/backend-types.js";
 import "../../../core/index.js";
-import { CommentThread } from "../schema.js";
+import "../schema.js";
 import { CommentsStore } from "../use-comments.js";
 //#region src/features/comments/components/CommentThreadView.vue.d.ts
 /**

package/dist/features/comments/feature.js

@@ -1,5 +1,5 @@
-import { CommentMark } from "./schema.js";
 import { Comments, commentsKey } from "./comments-plugin.js";
+import { CommentMark, commentsSchemaExtensions } from "./schema.js";
 import { provideCommentsModel } from "./model.js";
 import { commentsShortcuts } from "./shortcuts.js";
 import { Extension } from "@tiptap/core";
@@ -19,6 +19,8 @@ function commentsFeatureCore(ui, options = {}) {
 	const { model: factory } = options;
 	return {
 		id: "comments",
+		dimension: "interaction",
+		schemaExtensions: commentsSchemaExtensions,
 		requires: factory ? [] : ["collab"],
 		extensions: (ctx) => {
 			if (!factory) return [
@@ -38,16 +40,15 @@ function commentsFeatureCore(ui, options = {}) {
 				commentsShortcuts(ctx)
 			];
 		},
-		toolbar: (ctx) => [{
-			id: "collaboration",
-			order: 1010,
-			items: [{
-				id: "comments",
-				order: 10,
-				icon: "i-lucide-message-square-text",
-				label: ctx.t("comments.title"),
-				component: ui.toolbarButton
-			}]
+		commands: (ctx) => [{
+			id: "comments",
+			toolbar: {
+				group: "collaboration",
+				order: 10
+			},
+			icon: "i-lucide-message-square-text",
+			label: ctx.t("comments.title"),
+			component: ui.toolbarButton
 		}],
 		overlays: [ui.overlay],
 		settingsTabs: (ctx) => [{

package/dist/features/comments/feature.js.map

@@ -1 +1 @@
-{"version":3,"file":"feature.js","names":[],"sources":["../../../src/features/comments/feature.ts"],"sourcesContent":["import { type AnyExtension, type Editor, Extension } from '@tiptap/core'\nimport type { EditorFeature } from '../../core'\nimport { Comments, type CommentsMeta, commentsKey } from './comments-plugin'\nimport { type CommentsModelFactory, type CommentsSnapshot, provideCommentsModel } from './model'\nimport { CommentMark } from './schema'\nimport { commentsShortcuts } from './shortcuts'\n\n/** What a framework binding supplies to the comments feature. */\nexport interface CommentsUi<C> {\n  /** The toolbar entry: the margin toggle or the list menu, by the user's comments layout. */\n  toolbarButton: C\n  /** Mounted beside the editor content: the selection bubble, the inline popover and the layout glue. */\n  overlay: C\n  /** The „Kommentare“ settings tab component of the framework. */\n  settingsTab: C\n}\n\n/** Options of `commentsFeatureCore`. */\nexport interface CommentsFeatureOptions {\n  /**\n   * Backs the comments with the host's own model (REST threads, a database) instead of the document's Y.Doc: the feature\n   * then requires no `collab` feature, the `Comments` plugin reads the user from the model, gets the thread ids\n   * (`known`/`hidden`) and the text ranges from its snapshot, and the framework `useComments` hooks use the model of\n   * the surface (`commentsModelOf(ctx)`) instead of `createCommentsModel`. The factory runs once for the plugin and once\n   * per `useComments` consumer, so a model that shares state between them keeps it outside the factory. The model\n   * itself drives the active thread and the draft through the `comments-plugin` helpers.\n   */\n  model?: CommentsModelFactory\n}\n\n/**\n * Google-Docs-style comments on a collaborative document: select text, „Kommentar“ in the selection bubble, others\n * reply, anyone resolves or reopens a thread. Threads live in the Y.Doc (a `Y.Map` named `comments`, `createCommentsModel`), so\n * they sync live and persist with the document; the text range is the `comment` mark, highlighted by the `Comments`\n * plugin from the thread state. The user chooses per setting (`editing.commentsLayout`) between the margin column\n * (`CommentsMargin`, which the host places in the editor's scroll container and shows while the surface's\n * `commentsOpen` model is true; Mod-Shift-m or the toolbar button toggle it, and it excludes the AI sidebar) and the\n * inline popover plus the toolbar's list. Needs a collaborative surface with a `collaboration.user`: without one the\n * UI says so and nothing can be written (the schema mark stays registered, so stored comment marks round-trip). With\n * `options.model` the threads live wherever the host's model keeps them and no collaboration is needed.\n */\nexport function commentsFeatureCore<C>(ui: CommentsUi<C>, options: CommentsFeatureOptions = {}): EditorFeature<C> {\n  const { model: factory } = options\n  return {\n    id: 'comments',\n    requires: factory ? [] : ['collab'],\n    extensions: (ctx) => {\n      if (!factory) {\n        return [\n          CommentMark,\n          Comments.configure({\n            user: () => ctx.collaboration?.user ?? null,\n            doc: () => ctx.collaboration?.ydoc ?? null,\n          }),\n          commentsShortcuts(ctx),\n        ]\n      }\n      provideCommentsModel(ctx, factory)\n      const { configured, bridge } = modelExtensions(factory, ctx.getEditor)\n      return [CommentMark, configured, bridge, commentsShortcuts(ctx)]\n    },\n    toolbar: ctx => [{\n      id: 'collaboration',\n      order: 1010,\n      items: [{ id: 'comments', order: 10, icon: 'i-lucide-message-square-text', label: ctx.t('comments.title'), component: ui.toolbarButton }],\n    }],\n    overlays: [ui.overlay],\n    settingsTabs: ctx => [{ id: 'comments', label: ctx.t('comments.tab'), icon: 'i-lucide-message-square-text', component: ui.settingsTab }],\n  }\n}\n\n/**\n * The `Comments` plugin and its feed for a host model: the plugin reads user, availability and `canComment` from the\n * model's snapshot; the bridge extension refreshes the model once the editor exists, mirrors the snapshot's thread ids\n * and ranges into the plugin state (queued, never from inside a transaction) and disposes the model with the editor.\n */\nfunction modelExtensions(factory: CommentsModelFactory, getEditor: Parameters<CommentsModelFactory>[0]): { configured: AnyExtension, bridge: AnyExtension } {\n  let created: Editor | undefined\n  const model = factory(() => created ?? getEditor())\n  const snapshot = () => model.state.get()\n\n  let stop: (() => void) | undefined\n  let queued = false\n  // What the plugin was last told, to skip no-op dispatches and to apply the deactivation rule.\n  let told: CommentsSnapshot['threads'] | undefined\n  let toldRanges: CommentsSnapshot['ranges'] | undefined\n\n  function push() {\n    queued = false\n    const editor = created\n    const value = editor && !editor.isDestroyed ? commentsKey.getState(editor.state) : undefined\n    if (!editor || !value) return\n    const { threads, ranges } = snapshot()\n    if (threads === told && ranges === toldRanges) return\n    const known = new Set(threads.map(t => t.id))\n    const hidden = new Set(threads.filter(t => t.resolved).map(t => t.id))\n    const meta: CommentsMeta = { known, hidden, modelRanges: ranges }\n    const before = value.active ? told?.find(t => t.id === value.active) : undefined\n    if (value.active && before && !before.resolved && (!known.has(value.active) || hidden.has(value.active))) meta.active = null\n    told = threads\n    toldRanges = ranges\n    editor.view.dispatch(editor.state.tr.setMeta(commentsKey, meta).setMeta('addToHistory', false))\n  }\n\n  function queue() {\n    if (queued) return\n    queued = true\n    queueMicrotask(push)\n  }\n\n  return {\n    configured: Comments.configure({\n      user: () => snapshot().user,\n      doc: () => null,\n      available: () => snapshot().available,\n      canComment: () => snapshot().canComment,\n    }),\n    bridge: Extension.create({\n      name: 'commentsModelBridge',\n      onCreate() {\n        created = this.editor\n        model.refresh()\n        stop = model.state.subscribe(queue)\n        queue()\n      },\n      onDestroy() {\n        stop?.()\n        stop = undefined\n        model.dispose()\n        created = undefined\n        told = undefined\n        toldRanges = undefined\n      },\n    }),\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;AAyCA,SAAgB,oBAAuB,IAAmB,UAAkC,CAAC,GAAqB;CAChH,MAAM,EAAE,OAAO,YAAY;CAC3B,OAAO;EACL,IAAI;EACJ,UAAU,UAAU,CAAC,IAAI,CAAC,QAAQ;EAClC,aAAa,QAAQ;GACnB,IAAI,CAAC,SACH,OAAO;IACL;IACA,SAAS,UAAU;KACjB,YAAY,IAAI,eAAe,QAAQ;KACvC,WAAW,IAAI,eAAe,QAAQ;IACxC,CAAC;IACD,kBAAkB,GAAG;GACvB;GAEF,qBAAqB,KAAK,OAAO;GACjC,MAAM,EAAE,YAAY,WAAW,gBAAgB,SAAS,IAAI,SAAS;GACrE,OAAO;IAAC;IAAa;IAAY;IAAQ,kBAAkB,GAAG;GAAC;EACjE;EACA,UAAS,QAAO,CAAC;GACf,IAAI;GACJ,OAAO;GACP,OAAO,CAAC;IAAE,IAAI;IAAY,OAAO;IAAI,MAAM;IAAgC,OAAO,IAAI,EAAE,gBAAgB;IAAG,WAAW,GAAG;GAAc,CAAC;EAC1I,CAAC;EACD,UAAU,CAAC,GAAG,OAAO;EACrB,eAAc,QAAO,CAAC;GAAE,IAAI;GAAY,OAAO,IAAI,EAAE,cAAc;GAAG,MAAM;GAAgC,WAAW,GAAG;EAAY,CAAC;CACzI;AACF;;;;;;AAOA,SAAS,gBAAgB,SAA+B,WAAoG;CAC1J,IAAI;CACJ,MAAM,QAAQ,cAAc,WAAW,UAAU,CAAC;CAClD,MAAM,iBAAiB,MAAM,MAAM,IAAI;CAEvC,IAAI;CACJ,IAAI,SAAS;CAEb,IAAI;CACJ,IAAI;CAEJ,SAAS,OAAO;EACd,SAAS;EACT,MAAM,SAAS;EACf,MAAM,QAAQ,UAAU,CAAC,OAAO,cAAc,YAAY,SAAS,OAAO,KAAK,IAAI,KAAA;EACnF,IAAI,CAAC,UAAU,CAAC,OAAO;EACvB,MAAM,EAAE,SAAS,WAAW,SAAS;EACrC,IAAI,YAAY,QAAQ,WAAW,YAAY;EAC/C,MAAM,QAAQ,IAAI,IAAI,QAAQ,KAAI,MAAK,EAAE,EAAE,CAAC;EAC5C,MAAM,SAAS,IAAI,IAAI,QAAQ,QAAO,MAAK,EAAE,QAAQ,CAAC,CAAC,KAAI,MAAK,EAAE,EAAE,CAAC;EACrE,MAAM,OAAqB;GAAE;GAAO;GAAQ,aAAa;EAAO;EAChE,MAAM,SAAS,MAAM,SAAS,MAAM,MAAK,MAAK,EAAE,OAAO,MAAM,MAAM,IAAI,KAAA;EACvE,IAAI,MAAM,UAAU,UAAU,CAAC,OAAO,aAAa,CAAC,MAAM,IAAI,MAAM,MAAM,KAAK,OAAO,IAAI,MAAM,MAAM,IAAI,KAAK,SAAS;EACxH,OAAO;EACP,aAAa;EACb,OAAO,KAAK,SAAS,OAAO,MAAM,GAAG,QAAQ,aAAa,IAAI,CAAC,CAAC,QAAQ,gBAAgB,KAAK,CAAC;CAChG;CAEA,SAAS,QAAQ;EACf,IAAI,QAAQ;EACZ,SAAS;EACT,eAAe,IAAI;CACrB;CAEA,OAAO;EACL,YAAY,SAAS,UAAU;GAC7B,YAAY,SAAS,CAAC,CAAC;GACvB,WAAW;GACX,iBAAiB,SAAS,CAAC,CAAC;GAC5B,kBAAkB,SAAS,CAAC,CAAC;EAC/B,CAAC;EACD,QAAQ,UAAU,OAAO;GACvB,MAAM;GACN,WAAW;IACT,UAAU,KAAK;IACf,MAAM,QAAQ;IACd,OAAO,MAAM,MAAM,UAAU,KAAK;IAClC,MAAM;GACR;GACA,YAAY;IACV,OAAO;IACP,OAAO,KAAA;IACP,MAAM,QAAQ;IACd,UAAU,KAAA;IACV,OAAO,KAAA;IACP,aAAa,KAAA;GACf;EACF,CAAC;CACH;AACF"}
+{"version":3,"file":"feature.js","names":[],"sources":["../../../src/features/comments/feature.ts"],"sourcesContent":["import { type AnyExtension, type Editor, Extension } from '@tiptap/core'\nimport type { EditorFeature } from '../../core'\nimport { Comments, type CommentsMeta, commentsKey } from './comments-plugin'\nimport { type CommentsModelFactory, type CommentsSnapshot, provideCommentsModel } from './model'\nimport { CommentMark, commentsSchemaExtensions } from './schema'\nimport { commentsShortcuts } from './shortcuts'\n\n/** What a framework binding supplies to the comments feature. */\nexport interface CommentsUi<C> {\n  /** The toolbar entry: the margin toggle or the list menu, by the user's comments layout. */\n  toolbarButton: C\n  /** Mounted beside the editor content: the selection bubble, the inline popover and the layout glue. */\n  overlay: C\n  /** The „Kommentare“ settings tab component of the framework. */\n  settingsTab: C\n}\n\n/** Options of `commentsFeatureCore`. */\nexport interface CommentsFeatureOptions {\n  /**\n   * Backs the comments with the host's own model (REST threads, a database) instead of the document's Y.Doc: the feature\n   * then requires no `collab` feature, the `Comments` plugin reads the user from the model, gets the thread ids\n   * (`known`/`hidden`) and the text ranges from its snapshot, and the framework `useComments` hooks use the model of\n   * the surface (`commentsModelOf(ctx)`) instead of `createCommentsModel`. The factory runs once for the plugin and once\n   * per `useComments` consumer, so a model that shares state between them keeps it outside the factory. The model\n   * itself drives the active thread and the draft through the `comments-plugin` helpers.\n   */\n  model?: CommentsModelFactory\n}\n\n/**\n * Google-Docs-style comments on a collaborative document: select text, „Kommentar“ in the selection bubble, others\n * reply, anyone resolves or reopens a thread. Threads live in the Y.Doc (a `Y.Map` named `comments`, `createCommentsModel`), so\n * they sync live and persist with the document; the text range is the `comment` mark, highlighted by the `Comments`\n * plugin from the thread state. The user chooses per setting (`editing.commentsLayout`) between the margin column\n * (`CommentsMargin`, which the host places in the editor's scroll container and shows while the surface's\n * `commentsOpen` model is true; Mod-Shift-m or the toolbar button toggle it, and it excludes the AI sidebar) and the\n * inline popover plus the toolbar's list. Needs a collaborative surface with a `collaboration.user`: without one the\n * UI says so and nothing can be written (the schema mark stays registered, so stored comment marks round-trip). With\n * `options.model` the threads live wherever the host's model keeps them and no collaboration is needed.\n */\nexport function commentsFeatureCore<C>(ui: CommentsUi<C>, options: CommentsFeatureOptions = {}): EditorFeature<C> {\n  const { model: factory } = options\n  return {\n    id: 'comments',\n    dimension: 'interaction',\n    schemaExtensions: commentsSchemaExtensions,\n    requires: factory ? [] : ['collab'],\n    extensions: (ctx) => {\n      if (!factory) {\n        return [\n          CommentMark,\n          Comments.configure({\n            user: () => ctx.collaboration?.user ?? null,\n            doc: () => ctx.collaboration?.ydoc ?? null,\n          }),\n          commentsShortcuts(ctx),\n        ]\n      }\n      provideCommentsModel(ctx, factory)\n      const { configured, bridge } = modelExtensions(factory, ctx.getEditor)\n      return [CommentMark, configured, bridge, commentsShortcuts(ctx)]\n    },\n    commands: ctx => [\n      { id: 'comments', toolbar: { group: 'collaboration', order: 10 }, icon: 'i-lucide-message-square-text', label: ctx.t('comments.title'), component: ui.toolbarButton },\n    ],\n    overlays: [ui.overlay],\n    settingsTabs: ctx => [{ id: 'comments', label: ctx.t('comments.tab'), icon: 'i-lucide-message-square-text', component: ui.settingsTab }],\n  }\n}\n\n/**\n * The `Comments` plugin and its feed for a host model: the plugin reads user, availability and `canComment` from the\n * model's snapshot; the bridge extension refreshes the model once the editor exists, mirrors the snapshot's thread ids\n * and ranges into the plugin state (queued, never from inside a transaction) and disposes the model with the editor.\n */\nfunction modelExtensions(factory: CommentsModelFactory, getEditor: Parameters<CommentsModelFactory>[0]): { configured: AnyExtension, bridge: AnyExtension } {\n  let created: Editor | undefined\n  const model = factory(() => created ?? getEditor())\n  const snapshot = () => model.state.get()\n\n  let stop: (() => void) | undefined\n  let queued = false\n  // What the plugin was last told, to skip no-op dispatches and to apply the deactivation rule.\n  let told: CommentsSnapshot['threads'] | undefined\n  let toldRanges: CommentsSnapshot['ranges'] | undefined\n\n  function push() {\n    queued = false\n    const editor = created\n    const value = editor && !editor.isDestroyed ? commentsKey.getState(editor.state) : undefined\n    if (!editor || !value) return\n    const { threads, ranges } = snapshot()\n    if (threads === told && ranges === toldRanges) return\n    const known = new Set(threads.map(t => t.id))\n    const hidden = new Set(threads.filter(t => t.resolved).map(t => t.id))\n    const meta: CommentsMeta = { known, hidden, modelRanges: ranges }\n    const before = value.active ? told?.find(t => t.id === value.active) : undefined\n    if (value.active && before && !before.resolved && (!known.has(value.active) || hidden.has(value.active))) meta.active = null\n    told = threads\n    toldRanges = ranges\n    editor.view.dispatch(editor.state.tr.setMeta(commentsKey, meta).setMeta('addToHistory', false))\n  }\n\n  function queue() {\n    if (queued) return\n    queued = true\n    queueMicrotask(push)\n  }\n\n  return {\n    configured: Comments.configure({\n      user: () => snapshot().user,\n      doc: () => null,\n      available: () => snapshot().available,\n      canComment: () => snapshot().canComment,\n    }),\n    bridge: Extension.create({\n      name: 'commentsModelBridge',\n      onCreate() {\n        created = this.editor\n        model.refresh()\n        stop = model.state.subscribe(queue)\n        queue()\n      },\n      onDestroy() {\n        stop?.()\n        stop = undefined\n        model.dispose()\n        created = undefined\n        told = undefined\n        toldRanges = undefined\n      },\n    }),\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;AAyCA,SAAgB,oBAAuB,IAAmB,UAAkC,CAAC,GAAqB;CAChH,MAAM,EAAE,OAAO,YAAY;CAC3B,OAAO;EACL,IAAI;EACJ,WAAW;EACX,kBAAkB;EAClB,UAAU,UAAU,CAAC,IAAI,CAAC,QAAQ;EAClC,aAAa,QAAQ;GACnB,IAAI,CAAC,SACH,OAAO;IACL;IACA,SAAS,UAAU;KACjB,YAAY,IAAI,eAAe,QAAQ;KACvC,WAAW,IAAI,eAAe,QAAQ;IACxC,CAAC;IACD,kBAAkB,GAAG;GACvB;GAEF,qBAAqB,KAAK,OAAO;GACjC,MAAM,EAAE,YAAY,WAAW,gBAAgB,SAAS,IAAI,SAAS;GACrE,OAAO;IAAC;IAAa;IAAY;IAAQ,kBAAkB,GAAG;GAAC;EACjE;EACA,WAAU,QAAO,CACf;GAAE,IAAI;GAAY,SAAS;IAAE,OAAO;IAAiB,OAAO;GAAG;GAAG,MAAM;GAAgC,OAAO,IAAI,EAAE,gBAAgB;GAAG,WAAW,GAAG;EAAc,CACtK;EACA,UAAU,CAAC,GAAG,OAAO;EACrB,eAAc,QAAO,CAAC;GAAE,IAAI;GAAY,OAAO,IAAI,EAAE,cAAc;GAAG,MAAM;GAAgC,WAAW,GAAG;EAAY,CAAC;CACzI;AACF;;;;;;AAOA,SAAS,gBAAgB,SAA+B,WAAoG;CAC1J,IAAI;CACJ,MAAM,QAAQ,cAAc,WAAW,UAAU,CAAC;CAClD,MAAM,iBAAiB,MAAM,MAAM,IAAI;CAEvC,IAAI;CACJ,IAAI,SAAS;CAEb,IAAI;CACJ,IAAI;CAEJ,SAAS,OAAO;EACd,SAAS;EACT,MAAM,SAAS;EACf,MAAM,QAAQ,UAAU,CAAC,OAAO,cAAc,YAAY,SAAS,OAAO,KAAK,IAAI,KAAA;EACnF,IAAI,CAAC,UAAU,CAAC,OAAO;EACvB,MAAM,EAAE,SAAS,WAAW,SAAS;EACrC,IAAI,YAAY,QAAQ,WAAW,YAAY;EAC/C,MAAM,QAAQ,IAAI,IAAI,QAAQ,KAAI,MAAK,EAAE,EAAE,CAAC;EAC5C,MAAM,SAAS,IAAI,IAAI,QAAQ,QAAO,MAAK,EAAE,QAAQ,CAAC,CAAC,KAAI,MAAK,EAAE,EAAE,CAAC;EACrE,MAAM,OAAqB;GAAE;GAAO;GAAQ,aAAa;EAAO;EAChE,MAAM,SAAS,MAAM,SAAS,MAAM,MAAK,MAAK,EAAE,OAAO,MAAM,MAAM,IAAI,KAAA;EACvE,IAAI,MAAM,UAAU,UAAU,CAAC,OAAO,aAAa,CAAC,MAAM,IAAI,MAAM,MAAM,KAAK,OAAO,IAAI,MAAM,MAAM,IAAI,KAAK,SAAS;EACxH,OAAO;EACP,aAAa;EACb,OAAO,KAAK,SAAS,OAAO,MAAM,GAAG,QAAQ,aAAa,IAAI,CAAC,CAAC,QAAQ,gBAAgB,KAAK,CAAC;CAChG;CAEA,SAAS,QAAQ;EACf,IAAI,QAAQ;EACZ,SAAS;EACT,eAAe,IAAI;CACrB;CAEA,OAAO;EACL,YAAY,SAAS,UAAU;GAC7B,YAAY,SAAS,CAAC,CAAC;GACvB,WAAW;GACX,iBAAiB,SAAS,CAAC,CAAC;GAC5B,kBAAkB,SAAS,CAAC,CAAC;EAC/B,CAAC;EACD,QAAQ,UAAU,OAAO;GACvB,MAAM;GACN,WAAW;IACT,UAAU,KAAK;IACf,MAAM,QAAQ;IACd,OAAO,MAAM,MAAM,UAAU,KAAK;IAClC,MAAM;GACR;GACA,YAAY;IACV,OAAO;IACP,OAAO,KAAA;IACP,MAAM,QAAQ;IACd,UAAU,KAAA;IACV,OAAO,KAAA;IACP,aAAa,KAAA;GACf;EACF,CAAC;CACH;AACF"}

package/dist/features/comments/index.d.ts

@@ -1,8 +1,9 @@
 import { COMMENTS_LAYOUTS, CommentsLayout } from "../../settings/values.js";
-import { COMMENTS_FIELD, COMMENT_LIMITS, CommentAnchor, CommentAuthor, CommentMark, CommentReply, CommentThread, commentsSchemaExtensions } from "./schema.js";
-import { CommentsActions, CommentsModel, CommentsModelFactory, CommentsSnapshot, DocRange, commentsModelOf, createCommentsModel, createEditorCommentsModel } from "./model.js";
+import { CommentAnchor, CommentAuthor, CommentReply, CommentThread, CommentsActions, CommentsModel, CommentsSnapshot, DocRange } from "../../core/backend-types.js";
+import { CommentsModelFactory, commentsModelOf, createCommentsModel, createEditorCommentsModel } from "./model.js";
 import { CommentsFeatureOptions, CommentsUi, commentsFeatureCore } from "./feature.js";
 import { Comments, CommentsMeta, CommentsOptions, CommentsState, cancelCommentDraft, commentsAvailable, commentsCanComment, commentsDoc, commentsKey, commentsState, commentsUser, setActiveComment, startCommentDraft } from "./comments-plugin.js";
+import { COMMENTS_FIELD, COMMENT_LIMITS, CommentMark, commentsSchemaExtensions } from "./schema.js";
 import { DRAFT_CARD, MARGIN_GAP, MarginCard, MarginEntry, MarginLayout, layoutMargin, marginCards } from "./margin-layout.js";
 import { MarginController, MarginSource, MarginState, createMarginController } from "./margin-controller.js";
 export { COMMENTS_FIELD, COMMENTS_LAYOUTS, COMMENT_LIMITS, type CommentAnchor, type CommentAuthor, CommentMark, type CommentReply, type CommentThread, Comments, type CommentsActions, type CommentsFeatureOptions, type CommentsLayout, type CommentsMeta, type CommentsModel, type CommentsModelFactory, type CommentsOptions, type CommentsSnapshot, type CommentsState, type CommentsUi, DRAFT_CARD, type DocRange, MARGIN_GAP, type MarginCard, type MarginController, type MarginEntry, type MarginLayout, type MarginSource, type MarginState, cancelCommentDraft, commentsAvailable, commentsCanComment, commentsDoc, commentsFeatureCore, commentsKey, commentsModelOf, commentsSchemaExtensions, commentsState, commentsUser, createCommentsModel, createEditorCommentsModel, createMarginController, layoutMargin, marginCards, setActiveComment, startCommentDraft };

package/dist/features/comments/index.js

@@ -1,6 +1,6 @@
 import { COMMENTS_LAYOUTS } from "../../settings/values.js";
-import { COMMENTS_FIELD, COMMENT_LIMITS, CommentMark, commentsSchemaExtensions } from "./schema.js";
 import { Comments, cancelCommentDraft, commentsAvailable, commentsCanComment, commentsDoc, commentsKey, commentsState, commentsUser, setActiveComment, startCommentDraft } from "./comments-plugin.js";
+import { COMMENTS_FIELD, COMMENT_LIMITS, CommentMark, commentsSchemaExtensions } from "./schema.js";
 import { commentsModelOf, createCommentsModel, createEditorCommentsModel } from "./model.js";
 import { commentsFeatureCore } from "./feature.js";
 import { DRAFT_CARD, MARGIN_GAP, layoutMargin, marginCards } from "./margin-layout.js";

package/dist/features/comments/margin-layout.d.ts

@@ -1,5 +1,6 @@
-import { CommentThread } from "./schema.js";
-import { DocRange } from "./model.js";
+import { CommentThread, DocRange } from "../../core/backend-types.js";
+import "./model.js";
+import "./schema.js";
 //#region src/features/comments/margin-layout.d.ts
 /** Vertical gap between two cards of the comments margin, in px. */
 export declare const MARGIN_GAP = 8;

package/dist/features/comments/model.d.ts

@@ -1,73 +1,8 @@
-import { ReadonlyStore } from "../../core/store.js";
-import { AuthorIdentity, FeatureContext } from "../../core/feature.js";
+import { FeatureContext } from "../../core/feature.js";
+import { CommentsActions, CommentsModel, CommentsSnapshot, DocRange } from "../../core/backend-types.js";
 import "../../core/index.js";
-import { CommentThread } from "./schema.js";
 import { Editor } from "@tiptap/core";
 //#region src/features/comments/model.d.ts
-export type DocRange = {
-  from: number;
-  to: number;
-};
-/** What a comments UI renders: replaced (a new object) whenever any part of it changes, so a store subscriber re-renders only then. */
-export interface CommentsSnapshot {
-  /** Comments need a collaborative editor whose `Comments` extension has a user (a host model decides for itself). */
-  available: boolean;
-  /**
-   * Whether the user may compose a comment now: the default model says `available` and the editor is editable, a host
-   * model may allow readers of a read-only document to comment.
-   */
-  canComment: boolean;
-  user: AuthorIdentity | null;
-  /** Plain snapshots of all threads in the Y.Doc, replaced on every change. */
-  threads: readonly CommentThread[];
-  /** Current text range per thread id (threads without one are orphans). */
-  ranges: ReadonlyMap<string, DocRange>;
-  /**
-   * Where the text of an orphaned open thread was: the document position of the deletion point, resolved from the
-   * thread's stored anchor (so it is the same place for every collaborator and follows edits). Absent for orphans
-   * without a usable anchor (threads from before anchors, or whose block is gone for good).
-   */
-  orphanAt: ReadonlyMap<string, number>;
-  active: string | null;
-  /** Current range of the draft a new comment is being written for. */
-  draft: DocRange | null;
-  /** The draft's text as the new thread will keep it (`quote`). */
-  draftQuote: string;
-  /** Unresolved threads in document order, orphans last; resolved ones newest first. */
-  open: readonly CommentThread[];
-  resolved: readonly CommentThread[];
-}
-/** The mutations of the comments of one editor; no-ops without collaboration or a user. */
-export interface CommentsActions {
-  /** Creates a thread on the draft range; its id, or null without a (non-empty) draft or text. */
-  add: (text: string) => string | null;
-  reply: (threadId: string, text: string) => void;
-  /** Changes the text of the user's own thread (`replyId` null) or reply. */
-  edit: (threadId: string, replyId: string | null, text: string) => void;
-  /** Resolves or reopens a thread (anyone may). */
-  setResolved: (threadId: string, resolved: boolean) => void;
-  /** Deletes the user's own thread with its marks / the user's own reply. */
-  remove: (threadId: string) => void;
-  removeReply: (threadId: string, replyId: string) => void;
-  /** Activates a thread (`null`: none); `reveal` selects and scrolls to its text. */
-  activate: (id: string | null, options?: {
-    reveal?: boolean;
-  }) => void;
-  /** Starts a comment on the current selection (the layout shows the composer while `draft` is set). */
-  startDraft: () => void;
-  cancelDraft: () => void;
-}
-/**
- * The comments of one editor, framework-free: `state` is the observable snapshot, `refresh()` brings it up to date
- * (the framework hook calls it when the editor it watches changes; the model itself listens to that editor's
- * transactions from then on), `dispose()` detaches the editor and Y.Doc listeners and may be followed by `refresh()` again
- * (StrictMode mounts twice).
- */
-export interface CommentsModel extends CommentsActions {
-  readonly state: ReadonlyStore<CommentsSnapshot>;
-  refresh: () => void;
-  dispose: () => void;
-}
 /**
  * The comment threads of a collaborative editor, stored in its Y.Doc (`COMMENTS_FIELD`, one nested `Y.Map` per thread,
  * replies in a nested `Y.Array`), so they sync live with the document and persist with its Yjs state. Keeps the
@@ -92,4 +27,5 @@ export declare function commentsModelOf(ctx: FeatureContext): CommentsModelFacto
  */
 export declare function createEditorCommentsModel(getEditor: () => Editor | undefined): CommentsModel;
 //#endregion
+export type { CommentsActions, CommentsModel, CommentsSnapshot, DocRange };
 //# sourceMappingURL=model.d.ts.map

package/dist/features/comments/model.js

@@ -1,9 +1,9 @@
+import { editorEntryOf } from "../../core/editor-ui.js";
 import { newBlockId } from "../../core/schema/block-ids.js";
 import { createStore } from "../../core/store.js";
 import { anchorResolverOf, releaseRanges, resolveRange } from "../../core/doc-anchors.js";
-import { editorEntryOf } from "../../core/editor-ui.js";
-import { COMMENTS_FIELD, COMMENT_LIMITS } from "./schema.js";
 import { cancelCommentDraft, commentsDoc, commentsKey, commentsUser, setActiveComment, startCommentDraft } from "./comments-plugin.js";
+import { COMMENTS_FIELD, COMMENT_LIMITS } from "./schema.js";
 import { EMPTY_SNAPSHOT, NO_POSITIONS, NO_RANGES, NO_THREADS, sameOrphanAt, sameRange, sameRanges, sameUser } from "./snapshot-equality.js";
 import { captureThreadAnchor, resolveThreadAnchor } from "./thread-anchor.js";
 import * as Y from "yjs";

package/dist/features/comments/model.js.map

@@ -1 +1 @@
-{"version":3,"file":"model.js","names":[],"sources":["../../../src/features/comments/model.ts"],"sourcesContent":["import type { Editor } from '@tiptap/core'\nimport * as Y from 'yjs'\nimport type { AuthorIdentity, FeatureContext } from '../../core'\nimport { anchorResolverOf, editorEntryOf, releaseRanges, resolveRange } from '../../core'\nimport { newBlockId } from '../../core/schema'\nimport { createStore, type ReadonlyStore } from '../../core/store'\nimport { cancelCommentDraft, commentsDoc, commentsKey, type CommentsMeta, commentsUser, setActiveComment, startCommentDraft } from './comments-plugin'\nimport { COMMENT_LIMITS, COMMENTS_FIELD, type CommentAnchor, type CommentReply, type CommentThread } from './schema'\nimport { EMPTY_SNAPSHOT, NO_POSITIONS, NO_RANGES, NO_THREADS, sameOrphanAt, sameRange, sameRanges, sameUser } from './snapshot-equality'\nimport { captureThreadAnchor, resolveThreadAnchor } from './thread-anchor'\n\nexport type DocRange = { from: number, to: number }\n\n/** What a comments UI renders: replaced (a new object) whenever any part of it changes, so a store subscriber re-renders only then. */\nexport interface CommentsSnapshot {\n  /** Comments need a collaborative editor whose `Comments` extension has a user (a host model decides for itself). */\n  available: boolean\n  /**\n   * Whether the user may compose a comment now: the default model says `available` and the editor is editable, a host\n   * model may allow readers of a read-only document to comment.\n   */\n  canComment: boolean\n  user: AuthorIdentity | null\n  /** Plain snapshots of all threads in the Y.Doc, replaced on every change. */\n  threads: readonly CommentThread[]\n  /** Current text range per thread id (threads without one are orphans). */\n  ranges: ReadonlyMap<string, DocRange>\n  /**\n   * Where the text of an orphaned open thread was: the document position of the deletion point, resolved from the\n   * thread's stored anchor (so it is the same place for every collaborator and follows edits). Absent for orphans\n   * without a usable anchor (threads from before anchors, or whose block is gone for good).\n   */\n  orphanAt: ReadonlyMap<string, number>\n  active: string | null\n  /** Current range of the draft a new comment is being written for. */\n  draft: DocRange | null\n  /** The draft's text as the new thread will keep it (`quote`). */\n  draftQuote: string\n  /** Unresolved threads in document order, orphans last; resolved ones newest first. */\n  open: readonly CommentThread[]\n  resolved: readonly CommentThread[]\n}\n\n/** The mutations of the comments of one editor; no-ops without collaboration or a user. */\nexport interface CommentsActions {\n  /** Creates a thread on the draft range; its id, or null without a (non-empty) draft or text. */\n  add: (text: string) => string | null\n  reply: (threadId: string, text: string) => void\n  /** Changes the text of the user's own thread (`replyId` null) or reply. */\n  edit: (threadId: string, replyId: string | null, text: string) => void\n  /** Resolves or reopens a thread (anyone may). */\n  setResolved: (threadId: string, resolved: boolean) => void\n  /** Deletes the user's own thread with its marks / the user's own reply. */\n  remove: (threadId: string) => void\n  removeReply: (threadId: string, replyId: string) => void\n  /** Activates a thread (`null`: none); `reveal` selects and scrolls to its text. */\n  activate: (id: string | null, options?: { reveal?: boolean }) => void\n  /** Starts a comment on the current selection (the layout shows the composer while `draft` is set). */\n  startDraft: () => void\n  cancelDraft: () => void\n}\n\n/**\n * The comments of one editor, framework-free: `state` is the observable snapshot, `refresh()` brings it up to date\n * (the framework hook calls it when the editor it watches changes; the model itself listens to that editor's\n * transactions from then on), `dispose()` detaches the editor and Y.Doc listeners and may be followed by `refresh()` again\n * (StrictMode mounts twice).\n */\nexport interface CommentsModel extends CommentsActions {\n  readonly state: ReadonlyStore<CommentsSnapshot>\n  refresh: () => void\n  dispose: () => void\n}\n\n/** A thread's `Y.Map` as plain data; `replies` converted explicitly so it is always a plain array. */\nfunction snapshotOf(thread: Y.Map<unknown>): CommentThread {\n  const replies = thread.get('replies')\n  return { ...(thread.toJSON() as CommentThread), replies: replies instanceof Y.Array ? replies.toArray() as CommentReply[] : [] }\n}\n\n/**\n * The comment threads of a collaborative editor, stored in its Y.Doc (`COMMENTS_FIELD`, one nested `Y.Map` per thread,\n * replies in a nested `Y.Array`), so they sync live with the document and persist with its Yjs state. Keeps the\n * `Comments` plugin's `known`/`hidden` thread ids in step with the store (highlights), exposes the plugin's ranges,\n * active thread and draft, and the mutations. Mutations are no-ops without collaboration or user; editing and\n * deleting are limited to the user's own comments and replies (a client-side rule: the Y.Doc itself has no ACL).\n * `getEditor` names the editor to work on (it may change over time and may return a destroyed or no editor).\n * Each thread also keeps `anchor` (a Yjs relative position of its text's start, see `CommentAnchor`): `orphanAt` resolves\n * it for the threads whose text is gone. Threads from before anchors get theirs written once they are seen with a range.\n */\nexport function createCommentsModel(getEditor: () => Editor | undefined): CommentsModel {\n  const store = createStore<CommentsSnapshot>(EMPTY_SNAPSHOT)\n\n  const current = () => {\n    const instance = getEditor()\n    return instance && !instance.isDestroyed ? instance : undefined\n  }\n\n  // The editor whose transactions are followed, and the Y.Map of threads observed.\n  let bound: Editor | undefined\n  let observed: { doc: Y.Doc, map: Y.Map<unknown> } | undefined\n  let threads: readonly CommentThread[] = NO_THREADS\n  let syncQueued = false\n  // The thread list the plugin was last told about, for the deactivation rule.\n  let told: readonly CommentThread[] = NO_THREADS\n  // Threads already tried for an anchor (written, or not capturable), so a failed capture is not repeated on every change.\n  const anchorTried = new Set<string>()\n  let healQueued = false\n\n  function unobserve() {\n    observed?.map.unobserveDeep(onThreadsChanged)\n    observed = undefined\n  }\n\n  function onThreadsChanged() {\n    if (!observed) return\n    threads = [...observed.map.values()].filter((t): t is Y.Map<unknown> => t instanceof Y.Map).map(snapshotOf)\n    recompute()\n    queueSync()\n  }\n\n  function onTransaction() {\n    recompute()\n  }\n\n  function unbind() {\n    bound?.off('transaction', onTransaction)\n    // `setEditable` emits `update` only, and `canComment` follows `isEditable`.\n    bound?.off('update', onTransaction)\n    bound = undefined\n  }\n\n  /** The snapshot of the editor's current state; the previous object when nothing changed. */\n  function recompute() {\n    const instance = current()\n    if (!instance) {\n      store.set(EMPTY_SNAPSHOT)\n      return\n    }\n    const previous = store.get()\n    const ydoc = commentsDoc(instance)\n    const user = commentsUser(instance)\n    const plugin = commentsKey.getState(instance.state)\n    const ranges = plugin?.ranges ?? NO_RANGES\n    const orphanAt = orphanPositions(instance, ranges)\n    const active = plugin?.active ?? null\n    const anchor = plugin?.draft\n    const draft = anchor ? resolveRange(instance.state, anchor) : null\n    const draftQuote = draft ? instance.state.doc.textBetween(draft.from, draft.to, ' ').slice(0, COMMENT_LIMITS.quote) : ''\n    const available = !!ydoc && !!user\n    const canComment = available && instance.isEditable\n\n    const sameThreads = threads === previous.threads\n    const sameRangeMap = sameRanges(ranges, previous.ranges)\n    const sameOrphanMap = sameOrphanAt(orphanAt, previous.orphanAt)\n    if (\n      available === previous.available && canComment === previous.canComment && sameUser(user, previous.user) && sameThreads && sameRangeMap && sameOrphanMap\n      && active === previous.active && sameRange(draft, previous.draft) && draftQuote === previous.draftQuote\n    ) return\n\n    const kept = sameThreads && sameRangeMap\n    const open = kept\n      ? previous.open\n      : threads\n          .filter(t => !t.resolved)\n          .sort((a, b) => (ranges.get(a.id)?.from ?? Infinity) - (ranges.get(b.id)?.from ?? Infinity) || a.createdAt.localeCompare(b.createdAt))\n    const resolved = sameThreads\n      ? previous.resolved\n      : threads.filter(t => t.resolved).sort((a, b) => b.createdAt.localeCompare(a.createdAt))\n    store.set({\n      available,\n      canComment,\n      user,\n      threads,\n      ranges: sameRangeMap ? previous.ranges : ranges,\n      orphanAt: sameOrphanMap ? previous.orphanAt : orphanAt,\n      active,\n      draft: sameRange(draft, previous.draft) ? previous.draft : draft,\n      draftQuote,\n      open,\n      resolved,\n    })\n    if (available) queueHeal()\n  }\n\n  /** Where each unresolved thread without a text range was, from its anchor; empty without a Yjs session. */\n  function orphanPositions(instance: Editor, ranges: ReadonlyMap<string, DocRange>): ReadonlyMap<string, number> {\n    const resolver = anchorResolverOf(instance)\n    if (!resolver) return NO_POSITIONS\n    const size = instance.state.doc.content.size\n    let found: Map<string, number> | undefined\n    for (const thread of threads) {\n      if (thread.resolved || ranges.has(thread.id) || !thread.anchor) continue\n      const position = resolveThreadAnchor(instance.state, resolver, thread.anchor)\n      if (position !== null && position <= size) (found ??= new Map()).set(thread.id, position)\n    }\n    return found ?? NO_POSITIONS\n  }\n\n  // Threads from before anchors get theirs once they are seen with their text in the document (any client with a user\n  // writes it; the positions are equivalent, so concurrent writes agree). Queued: not written from inside a Yjs\n  // observer or a transaction listener.\n  function queueHeal() {\n    if (healQueued || !threads.some(t => !t.anchor && !anchorTried.has(t.id))) return\n    healQueued = true\n    queueMicrotask(() => {\n      healQueued = false\n      healAnchors()\n    })\n  }\n\n  function healAnchors() {\n    const ctx = writable()\n    const resolver = ctx && anchorResolverOf(ctx.editor)\n    if (!ctx || !resolver || ctx.editor !== bound) return\n    const { ranges } = store.get()\n    const written: [Y.Map<unknown>, CommentAnchor][] = []\n    for (const { id, anchor } of threads) {\n      const range = ranges.get(id)\n      if (anchor || anchorTried.has(id) || !range) continue\n      anchorTried.add(id)\n      const thread = threadMap(ctx.map, id)\n      const captured = thread && captureThreadAnchor(ctx.editor.state, resolver, range)\n      if (thread && captured) written.push([thread, captured])\n    }\n    if (written.length) ctx.ydoc.transact(() => written.forEach(([thread, captured]) => thread.set('anchor', captured)))\n  }\n\n  // Highlights appear and disappear on every client as threads arrive, get resolved or deleted. The active thread\n  // stays highlighted even when resolved (a resolved thread activated from its card), so a thread that turns resolved\n  // or disappears while active is deactivated here, on every client, not only on the one that resolved or deleted it.\n  // Queued (not dispatched from inside the Yjs observer or a transaction listener).\n  function queueSync() {\n    if (syncQueued) return\n    syncQueued = true\n    queueMicrotask(() => {\n      syncQueued = false\n      syncPlugin()\n    })\n  }\n\n  function syncPlugin() {\n    const instance = current()\n    if (!instance || instance !== bound) return\n    const value = commentsKey.getState(instance.state)\n    if (!value) return\n    const known = new Set(threads.map(t => t.id))\n    const hidden = new Set(threads.filter(t => t.resolved).map(t => t.id))\n    const meta: CommentsMeta = { known, hidden }\n    const before = value.active ? told.find(t => t.id === value.active) : undefined\n    if (value.active && before && !before.resolved && (!known.has(value.active) || hidden.has(value.active))) meta.active = null\n    told = threads\n    instance.view.dispatch(instance.state.tr.setMeta(commentsKey, meta).setMeta('addToHistory', false))\n  }\n\n  /** Follows the editor `getEditor` names now, and the Y.Doc of its collaboration session. */\n  function refresh() {\n    const instance = current()\n    if (instance !== bound) {\n      unbind()\n      unobserve()\n      bound = instance\n      threads = NO_THREADS\n      told = NO_THREADS\n      anchorTried.clear()\n      instance?.on('transaction', onTransaction)\n      instance?.on('update', onTransaction)\n      // The new editor's plugin knows no threads yet.\n      queueSync()\n    }\n    const ydoc = instance ? commentsDoc(instance) : null\n    if ((observed?.doc ?? null) !== ydoc) {\n      unobserve()\n      if (ydoc) {\n        const map = ydoc.getMap<unknown>(COMMENTS_FIELD)\n        observed = { doc: ydoc, map }\n        map.observeDeep(onThreadsChanged)\n        threads = [...map.values()].filter((t): t is Y.Map<unknown> => t instanceof Y.Map).map(snapshotOf)\n      }\n      else {\n        threads = NO_THREADS\n      }\n      queueSync()\n    }\n    recompute()\n  }\n\n  function dispose() {\n    unbind()\n    unobserve()\n    threads = NO_THREADS\n    told = NO_THREADS\n    anchorTried.clear()\n    store.set(EMPTY_SNAPSHOT)\n  }\n\n  /** Editor, thread map and user while comments are available; null otherwise. */\n  function writable() {\n    const instance = current()\n    const ydoc = instance && commentsDoc(instance)\n    const author = instance && commentsUser(instance)\n    if (!instance || !ydoc || !author) return null\n    return { editor: instance, ydoc, map: ydoc.getMap<unknown>(COMMENTS_FIELD), user: { id: author.id, name: author.name, color: author.color } }\n  }\n\n  /** Trimmed and cut to the limit; '' when nothing is left. */\n  const clean = (text: string) => text.trim().slice(0, COMMENT_LIMITS.text)\n\n  function threadMap(map: Y.Map<unknown>, threadId: string): Y.Map<unknown> | null {\n    const thread = map.get(threadId)\n    return thread instanceof Y.Map ? thread : null\n  }\n\n  function repliesOf(thread: Y.Map<unknown>): Y.Array<CommentReply> | null {\n    const replies = thread.get('replies')\n    return replies instanceof Y.Array ? replies as Y.Array<CommentReply> : null\n  }\n\n  function add(text: string): string | null {\n    const ctx = writable()\n    const body = clean(text)\n    const anchor = ctx && commentsKey.getState(ctx.editor.state)?.draft\n    const range = ctx && anchor ? resolveRange(ctx.editor.state, anchor) : null\n    const type = ctx?.editor.schema.marks.comment\n    if (!ctx || !anchor || !range || range.from >= range.to || !body || !type) return null\n    const id = newBlockId()\n    const { state } = ctx.editor\n    const resolver = anchorResolverOf(ctx.editor)\n    const threadAnchor = resolver ? captureThreadAnchor(state, resolver, range) : null\n    const quote = state.doc.textBetween(range.from, range.to, ' ').slice(0, COMMENT_LIMITS.quote)\n    const tr = state.tr.addMark(range.from, range.to, type.create({ id }))\n    // Text that takes no marks (code block, inline code): no thread that would start out without a range.\n    if (!tr.docChanged) return null\n    // Not undoable: the mark is the thread's anchor, not an edit of the text.\n    const meta: CommentsMeta = { draft: null, active: id }\n    ctx.editor.view.dispatch(tr.setMeta(commentsKey, meta).setMeta('addToHistory', false))\n    releaseRanges(ctx.editor, [anchor])\n    const thread = new Y.Map<unknown>()\n    thread.set('id', id)\n    thread.set('author', ctx.user)\n    thread.set('text', body)\n    thread.set('createdAt', new Date().toISOString())\n    thread.set('quote', quote)\n    thread.set('resolved', false)\n    if (threadAnchor) thread.set('anchor', threadAnchor)\n    thread.set('replies', new Y.Array<CommentReply>())\n    ctx.map.set(id, thread)\n    return id\n  }\n\n  function reply(threadId: string, text: string): void {\n    const ctx = writable()\n    const body = clean(text)\n    const thread = ctx && threadMap(ctx.map, threadId)\n    const replies = thread && repliesOf(thread)\n    if (!ctx || !replies || !body) return\n    replies.push([{ id: newBlockId(), author: ctx.user, text: body, createdAt: new Date().toISOString() }])\n  }\n\n  function edit(threadId: string, replyId: string | null, text: string): void {\n    const ctx = writable()\n    const body = clean(text)\n    const thread = ctx && threadMap(ctx.map, threadId)\n    if (!ctx || !thread || !body) return\n    const now = new Date().toISOString()\n    if (replyId === null) {\n      if ((thread.get('author') as CommentThread['author'] | undefined)?.id !== ctx.user.id || thread.get('text') === body) return\n      ctx.ydoc.transact(() => {\n        thread.set('text', body)\n        thread.set('editedAt', now)\n      })\n      return\n    }\n    const replies = repliesOf(thread)\n    const index = replies ? replies.toArray().findIndex(r => r.id === replyId) : -1\n    const previous = replies && index >= 0 ? replies.get(index) : undefined\n    if (!replies || !previous || previous.author.id !== ctx.user.id || previous.text === body) return\n    ctx.ydoc.transact(() => {\n      replies.delete(index, 1)\n      replies.insert(index, [{ ...previous, text: body, editedAt: now }])\n    })\n  }\n\n  function setResolved(threadId: string, value: boolean): void {\n    const ctx = writable()\n    const thread = ctx && threadMap(ctx.map, threadId)\n    if (!ctx || !thread) return\n    thread.set('resolved', value)\n    if (value && commentsKey.getState(ctx.editor.state)?.active === threadId) setActiveComment(ctx.editor, null)\n  }\n\n  function remove(threadId: string): void {\n    const ctx = writable()\n    const thread = ctx && threadMap(ctx.map, threadId)\n    if (!ctx || !thread || (thread.get('author') as CommentThread['author'] | undefined)?.id !== ctx.user.id) return\n    const { state } = ctx.editor\n    const tr = state.tr\n    state.doc.descendants((node, pos) => {\n      if (!node.isText) return\n      const mark = node.marks.find(m => m.type.name === 'comment' && m.attrs.id === threadId)\n      if (mark) tr.removeMark(pos, pos + node.nodeSize, mark)\n    })\n    if (commentsKey.getState(state)?.active === threadId) tr.setMeta(commentsKey, { active: null } satisfies CommentsMeta)\n    if (tr.docChanged || tr.getMeta(commentsKey)) ctx.editor.view.dispatch(tr.setMeta('addToHistory', false))\n    ctx.map.delete(threadId)\n  }\n\n  function removeReply(threadId: string, replyId: string): void {\n    const ctx = writable()\n    const thread = ctx && threadMap(ctx.map, threadId)\n    const replies = thread && repliesOf(thread)\n    if (!ctx || !replies) return\n    const index = replies.toArray().findIndex(r => r.id === replyId)\n    if (index >= 0 && replies.get(index).author.id === ctx.user.id) replies.delete(index, 1)\n  }\n\n  function activate(id: string | null, options: { reveal?: boolean } = {}): void {\n    const instance = current()\n    if (instance) setActiveComment(instance, id, options)\n  }\n\n  function startDraft(): void {\n    const ctx = writable()\n    if (ctx) startCommentDraft(ctx.editor)\n  }\n\n  function cancelDraft(): void {\n    const instance = current()\n    if (instance) cancelCommentDraft(instance)\n  }\n\n  return { state: store, refresh, dispose, add, reply, edit, setResolved, remove, removeReply, activate, startDraft, cancelDraft }\n}\n\n/** Creates the comments model of one editor, as a host supplies it to `commentsFeatureCore`. */\nexport type CommentsModelFactory = (getEditor: () => Editor | undefined) => CommentsModel\n\n// The host's model factory per surface context, set by the comments feature while the surface builds its extensions.\nconst modelFactories = new WeakMap<FeatureContext, CommentsModelFactory>()\n\n/** Registers the host model factory of `ctx` (the comments feature does this; hosts pass `model` to the feature). */\nexport function provideCommentsModel(ctx: FeatureContext, factory: CommentsModelFactory): void {\n  modelFactories.set(ctx, factory)\n}\n\n/** The host model factory the comments feature of `ctx` was configured with; undefined for the default Y.Doc model. */\nexport function commentsModelOf(ctx: FeatureContext): CommentsModelFactory | undefined {\n  return modelFactories.get(ctx)\n}\n\n/**\n * The comments model the framework hooks (`useComments`) use: the model of the surface `getEditor` belongs to\n * (`commentsModelOf` of its feature context: the host's `model` factory) and `createCommentsModel` for every other\n * editor. It follows the editor over time: when the editor changes to one of a surface with another model, the inner\n * model is replaced (disposed, created, refreshed) and `state` carries on with the new one. The factory runs once per\n * consumer of this function, so a host model that must share state across them keeps it outside the factory.\n */\nexport function createEditorCommentsModel(getEditor: () => Editor | undefined): CommentsModel {\n  const store = createStore<CommentsSnapshot>(EMPTY_SNAPSHOT)\n  let inner: { model: CommentsModel, factory: CommentsModelFactory, stop: () => void } | undefined\n\n  function release() {\n    inner?.stop()\n    inner?.model.dispose()\n    inner = undefined\n  }\n\n  /** The inner model for the editor now; a replacement when its surface brings another factory. */\n  function current(): CommentsModel {\n    const entry = editorEntryOf(getEditor())\n    const factory = (entry && commentsModelOf(entry.ctx)) ?? createCommentsModel\n    if (inner?.factory !== factory) {\n      release()\n      const model = factory(getEditor)\n      inner = { model, factory, stop: model.state.subscribe(snapshot => store.set(snapshot)) }\n      store.set(model.state.get())\n    }\n    return inner!.model\n  }\n\n  return {\n    state: store,\n    refresh: () => current().refresh(),\n    dispose: () => {\n      release()\n      store.set(EMPTY_SNAPSHOT)\n    },\n    add: text => current().add(text),\n    reply: (threadId, text) => current().reply(threadId, text),\n    edit: (threadId, replyId, text) => current().edit(threadId, replyId, text),\n    setResolved: (threadId, resolved) => current().setResolved(threadId, resolved),\n    remove: threadId => current().remove(threadId),\n    removeReply: (threadId, replyId) => current().removeReply(threadId, replyId),\n    activate: (id, options) => current().activate(id, options),\n    startDraft: () => current().startDraft(),\n    cancelDraft: () => current().cancelDraft(),\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"model.js","names":[],"sources":["../../../src/features/comments/model.ts"],"sourcesContent":["import type { Editor } from '@tiptap/core'\nimport * as Y from 'yjs'\nimport type { FeatureContext } from '../../core'\nimport type { CommentsModel, CommentsSnapshot, DocRange } from '../../core/backend-types'\nimport { anchorResolverOf, editorEntryOf, releaseRanges, resolveRange } from '../../core'\nimport { newBlockId } from '../../core/schema'\nimport { createStore } from '../../core/store'\nimport { cancelCommentDraft, commentsDoc, commentsKey, type CommentsMeta, commentsUser, setActiveComment, startCommentDraft } from './comments-plugin'\nimport { COMMENT_LIMITS, COMMENTS_FIELD, type CommentAnchor, type CommentReply, type CommentThread } from './schema'\nimport { EMPTY_SNAPSHOT, NO_POSITIONS, NO_RANGES, NO_THREADS, sameOrphanAt, sameRange, sameRanges, sameUser } from './snapshot-equality'\nimport { captureThreadAnchor, resolveThreadAnchor } from './thread-anchor'\n\nexport type { CommentsActions, CommentsModel, CommentsSnapshot, DocRange } from '../../core/backend-types'\n\n/** A thread's `Y.Map` as plain data; `replies` converted explicitly so it is always a plain array. */\nfunction snapshotOf(thread: Y.Map<unknown>): CommentThread {\n  const replies = thread.get('replies')\n  return { ...(thread.toJSON() as CommentThread), replies: replies instanceof Y.Array ? replies.toArray() as CommentReply[] : [] }\n}\n\n/**\n * The comment threads of a collaborative editor, stored in its Y.Doc (`COMMENTS_FIELD`, one nested `Y.Map` per thread,\n * replies in a nested `Y.Array`), so they sync live with the document and persist with its Yjs state. Keeps the\n * `Comments` plugin's `known`/`hidden` thread ids in step with the store (highlights), exposes the plugin's ranges,\n * active thread and draft, and the mutations. Mutations are no-ops without collaboration or user; editing and\n * deleting are limited to the user's own comments and replies (a client-side rule: the Y.Doc itself has no ACL).\n * `getEditor` names the editor to work on (it may change over time and may return a destroyed or no editor).\n * Each thread also keeps `anchor` (a Yjs relative position of its text's start, see `CommentAnchor`): `orphanAt` resolves\n * it for the threads whose text is gone. Threads from before anchors get theirs written once they are seen with a range.\n */\nexport function createCommentsModel(getEditor: () => Editor | undefined): CommentsModel {\n  const store = createStore<CommentsSnapshot>(EMPTY_SNAPSHOT)\n\n  const current = () => {\n    const instance = getEditor()\n    return instance && !instance.isDestroyed ? instance : undefined\n  }\n\n  // The editor whose transactions are followed, and the Y.Map of threads observed.\n  let bound: Editor | undefined\n  let observed: { doc: Y.Doc, map: Y.Map<unknown> } | undefined\n  let threads: readonly CommentThread[] = NO_THREADS\n  let syncQueued = false\n  // The thread list the plugin was last told about, for the deactivation rule.\n  let told: readonly CommentThread[] = NO_THREADS\n  // Threads already tried for an anchor (written, or not capturable), so a failed capture is not repeated on every change.\n  const anchorTried = new Set<string>()\n  let healQueued = false\n\n  function unobserve() {\n    observed?.map.unobserveDeep(onThreadsChanged)\n    observed = undefined\n  }\n\n  function onThreadsChanged() {\n    if (!observed) return\n    threads = [...observed.map.values()].filter((t): t is Y.Map<unknown> => t instanceof Y.Map).map(snapshotOf)\n    recompute()\n    queueSync()\n  }\n\n  function onTransaction() {\n    recompute()\n  }\n\n  function unbind() {\n    bound?.off('transaction', onTransaction)\n    // `setEditable` emits `update` only, and `canComment` follows `isEditable`.\n    bound?.off('update', onTransaction)\n    bound = undefined\n  }\n\n  /** The snapshot of the editor's current state; the previous object when nothing changed. */\n  function recompute() {\n    const instance = current()\n    if (!instance) {\n      store.set(EMPTY_SNAPSHOT)\n      return\n    }\n    const previous = store.get()\n    const ydoc = commentsDoc(instance)\n    const user = commentsUser(instance)\n    const plugin = commentsKey.getState(instance.state)\n    const ranges = plugin?.ranges ?? NO_RANGES\n    const orphanAt = orphanPositions(instance, ranges)\n    const active = plugin?.active ?? null\n    const anchor = plugin?.draft\n    const draft = anchor ? resolveRange(instance.state, anchor) : null\n    const draftQuote = draft ? instance.state.doc.textBetween(draft.from, draft.to, ' ').slice(0, COMMENT_LIMITS.quote) : ''\n    const available = !!ydoc && !!user\n    const canComment = available && instance.isEditable\n\n    const sameThreads = threads === previous.threads\n    const sameRangeMap = sameRanges(ranges, previous.ranges)\n    const sameOrphanMap = sameOrphanAt(orphanAt, previous.orphanAt)\n    if (\n      available === previous.available && canComment === previous.canComment && sameUser(user, previous.user) && sameThreads && sameRangeMap && sameOrphanMap\n      && active === previous.active && sameRange(draft, previous.draft) && draftQuote === previous.draftQuote\n    ) return\n\n    const kept = sameThreads && sameRangeMap\n    const open = kept\n      ? previous.open\n      : threads\n          .filter(t => !t.resolved)\n          .sort((a, b) => (ranges.get(a.id)?.from ?? Infinity) - (ranges.get(b.id)?.from ?? Infinity) || a.createdAt.localeCompare(b.createdAt))\n    const resolved = sameThreads\n      ? previous.resolved\n      : threads.filter(t => t.resolved).sort((a, b) => b.createdAt.localeCompare(a.createdAt))\n    store.set({\n      available,\n      canComment,\n      user,\n      threads,\n      ranges: sameRangeMap ? previous.ranges : ranges,\n      orphanAt: sameOrphanMap ? previous.orphanAt : orphanAt,\n      active,\n      draft: sameRange(draft, previous.draft) ? previous.draft : draft,\n      draftQuote,\n      open,\n      resolved,\n    })\n    if (available) queueHeal()\n  }\n\n  /** Where each unresolved thread without a text range was, from its anchor; empty without a Yjs session. */\n  function orphanPositions(instance: Editor, ranges: ReadonlyMap<string, DocRange>): ReadonlyMap<string, number> {\n    const resolver = anchorResolverOf(instance)\n    if (!resolver) return NO_POSITIONS\n    const size = instance.state.doc.content.size\n    let found: Map<string, number> | undefined\n    for (const thread of threads) {\n      if (thread.resolved || ranges.has(thread.id) || !thread.anchor) continue\n      const position = resolveThreadAnchor(instance.state, resolver, thread.anchor)\n      if (position !== null && position <= size) (found ??= new Map()).set(thread.id, position)\n    }\n    return found ?? NO_POSITIONS\n  }\n\n  // Threads from before anchors get theirs once they are seen with their text in the document (any client with a user\n  // writes it; the positions are equivalent, so concurrent writes agree). Queued: not written from inside a Yjs\n  // observer or a transaction listener.\n  function queueHeal() {\n    if (healQueued || !threads.some(t => !t.anchor && !anchorTried.has(t.id))) return\n    healQueued = true\n    queueMicrotask(() => {\n      healQueued = false\n      healAnchors()\n    })\n  }\n\n  function healAnchors() {\n    const ctx = writable()\n    const resolver = ctx && anchorResolverOf(ctx.editor)\n    if (!ctx || !resolver || ctx.editor !== bound) return\n    const { ranges } = store.get()\n    const written: [Y.Map<unknown>, CommentAnchor][] = []\n    for (const { id, anchor } of threads) {\n      const range = ranges.get(id)\n      if (anchor || anchorTried.has(id) || !range) continue\n      anchorTried.add(id)\n      const thread = threadMap(ctx.map, id)\n      const captured = thread && captureThreadAnchor(ctx.editor.state, resolver, range)\n      if (thread && captured) written.push([thread, captured])\n    }\n    if (written.length) ctx.ydoc.transact(() => written.forEach(([thread, captured]) => thread.set('anchor', captured)))\n  }\n\n  // Highlights appear and disappear on every client as threads arrive, get resolved or deleted. The active thread\n  // stays highlighted even when resolved (a resolved thread activated from its card), so a thread that turns resolved\n  // or disappears while active is deactivated here, on every client, not only on the one that resolved or deleted it.\n  // Queued (not dispatched from inside the Yjs observer or a transaction listener).\n  function queueSync() {\n    if (syncQueued) return\n    syncQueued = true\n    queueMicrotask(() => {\n      syncQueued = false\n      syncPlugin()\n    })\n  }\n\n  function syncPlugin() {\n    const instance = current()\n    if (!instance || instance !== bound) return\n    const value = commentsKey.getState(instance.state)\n    if (!value) return\n    const known = new Set(threads.map(t => t.id))\n    const hidden = new Set(threads.filter(t => t.resolved).map(t => t.id))\n    const meta: CommentsMeta = { known, hidden }\n    const before = value.active ? told.find(t => t.id === value.active) : undefined\n    if (value.active && before && !before.resolved && (!known.has(value.active) || hidden.has(value.active))) meta.active = null\n    told = threads\n    instance.view.dispatch(instance.state.tr.setMeta(commentsKey, meta).setMeta('addToHistory', false))\n  }\n\n  /** Follows the editor `getEditor` names now, and the Y.Doc of its collaboration session. */\n  function refresh() {\n    const instance = current()\n    if (instance !== bound) {\n      unbind()\n      unobserve()\n      bound = instance\n      threads = NO_THREADS\n      told = NO_THREADS\n      anchorTried.clear()\n      instance?.on('transaction', onTransaction)\n      instance?.on('update', onTransaction)\n      // The new editor's plugin knows no threads yet.\n      queueSync()\n    }\n    const ydoc = instance ? commentsDoc(instance) : null\n    if ((observed?.doc ?? null) !== ydoc) {\n      unobserve()\n      if (ydoc) {\n        const map = ydoc.getMap<unknown>(COMMENTS_FIELD)\n        observed = { doc: ydoc, map }\n        map.observeDeep(onThreadsChanged)\n        threads = [...map.values()].filter((t): t is Y.Map<unknown> => t instanceof Y.Map).map(snapshotOf)\n      }\n      else {\n        threads = NO_THREADS\n      }\n      queueSync()\n    }\n    recompute()\n  }\n\n  function dispose() {\n    unbind()\n    unobserve()\n    threads = NO_THREADS\n    told = NO_THREADS\n    anchorTried.clear()\n    store.set(EMPTY_SNAPSHOT)\n  }\n\n  /** Editor, thread map and user while comments are available; null otherwise. */\n  function writable() {\n    const instance = current()\n    const ydoc = instance && commentsDoc(instance)\n    const author = instance && commentsUser(instance)\n    if (!instance || !ydoc || !author) return null\n    return { editor: instance, ydoc, map: ydoc.getMap<unknown>(COMMENTS_FIELD), user: { id: author.id, name: author.name, color: author.color } }\n  }\n\n  /** Trimmed and cut to the limit; '' when nothing is left. */\n  const clean = (text: string) => text.trim().slice(0, COMMENT_LIMITS.text)\n\n  function threadMap(map: Y.Map<unknown>, threadId: string): Y.Map<unknown> | null {\n    const thread = map.get(threadId)\n    return thread instanceof Y.Map ? thread : null\n  }\n\n  function repliesOf(thread: Y.Map<unknown>): Y.Array<CommentReply> | null {\n    const replies = thread.get('replies')\n    return replies instanceof Y.Array ? replies as Y.Array<CommentReply> : null\n  }\n\n  function add(text: string): string | null {\n    const ctx = writable()\n    const body = clean(text)\n    const anchor = ctx && commentsKey.getState(ctx.editor.state)?.draft\n    const range = ctx && anchor ? resolveRange(ctx.editor.state, anchor) : null\n    const type = ctx?.editor.schema.marks.comment\n    if (!ctx || !anchor || !range || range.from >= range.to || !body || !type) return null\n    const id = newBlockId()\n    const { state } = ctx.editor\n    const resolver = anchorResolverOf(ctx.editor)\n    const threadAnchor = resolver ? captureThreadAnchor(state, resolver, range) : null\n    const quote = state.doc.textBetween(range.from, range.to, ' ').slice(0, COMMENT_LIMITS.quote)\n    const tr = state.tr.addMark(range.from, range.to, type.create({ id }))\n    // Text that takes no marks (code block, inline code): no thread that would start out without a range.\n    if (!tr.docChanged) return null\n    // Not undoable: the mark is the thread's anchor, not an edit of the text.\n    const meta: CommentsMeta = { draft: null, active: id }\n    ctx.editor.view.dispatch(tr.setMeta(commentsKey, meta).setMeta('addToHistory', false))\n    releaseRanges(ctx.editor, [anchor])\n    const thread = new Y.Map<unknown>()\n    thread.set('id', id)\n    thread.set('author', ctx.user)\n    thread.set('text', body)\n    thread.set('createdAt', new Date().toISOString())\n    thread.set('quote', quote)\n    thread.set('resolved', false)\n    if (threadAnchor) thread.set('anchor', threadAnchor)\n    thread.set('replies', new Y.Array<CommentReply>())\n    ctx.map.set(id, thread)\n    return id\n  }\n\n  function reply(threadId: string, text: string): void {\n    const ctx = writable()\n    const body = clean(text)\n    const thread = ctx && threadMap(ctx.map, threadId)\n    const replies = thread && repliesOf(thread)\n    if (!ctx || !replies || !body) return\n    replies.push([{ id: newBlockId(), author: ctx.user, text: body, createdAt: new Date().toISOString() }])\n  }\n\n  function edit(threadId: string, replyId: string | null, text: string): void {\n    const ctx = writable()\n    const body = clean(text)\n    const thread = ctx && threadMap(ctx.map, threadId)\n    if (!ctx || !thread || !body) return\n    const now = new Date().toISOString()\n    if (replyId === null) {\n      if ((thread.get('author') as CommentThread['author'] | undefined)?.id !== ctx.user.id || thread.get('text') === body) return\n      ctx.ydoc.transact(() => {\n        thread.set('text', body)\n        thread.set('editedAt', now)\n      })\n      return\n    }\n    const replies = repliesOf(thread)\n    const index = replies ? replies.toArray().findIndex(r => r.id === replyId) : -1\n    const previous = replies && index >= 0 ? replies.get(index) : undefined\n    if (!replies || !previous || previous.author.id !== ctx.user.id || previous.text === body) return\n    ctx.ydoc.transact(() => {\n      replies.delete(index, 1)\n      replies.insert(index, [{ ...previous, text: body, editedAt: now }])\n    })\n  }\n\n  function setResolved(threadId: string, value: boolean): void {\n    const ctx = writable()\n    const thread = ctx && threadMap(ctx.map, threadId)\n    if (!ctx || !thread) return\n    thread.set('resolved', value)\n    if (value && commentsKey.getState(ctx.editor.state)?.active === threadId) setActiveComment(ctx.editor, null)\n  }\n\n  function remove(threadId: string): void {\n    const ctx = writable()\n    const thread = ctx && threadMap(ctx.map, threadId)\n    if (!ctx || !thread || (thread.get('author') as CommentThread['author'] | undefined)?.id !== ctx.user.id) return\n    const { state } = ctx.editor\n    const tr = state.tr\n    state.doc.descendants((node, pos) => {\n      if (!node.isText) return\n      const mark = node.marks.find(m => m.type.name === 'comment' && m.attrs.id === threadId)\n      if (mark) tr.removeMark(pos, pos + node.nodeSize, mark)\n    })\n    if (commentsKey.getState(state)?.active === threadId) tr.setMeta(commentsKey, { active: null } satisfies CommentsMeta)\n    if (tr.docChanged || tr.getMeta(commentsKey)) ctx.editor.view.dispatch(tr.setMeta('addToHistory', false))\n    ctx.map.delete(threadId)\n  }\n\n  function removeReply(threadId: string, replyId: string): void {\n    const ctx = writable()\n    const thread = ctx && threadMap(ctx.map, threadId)\n    const replies = thread && repliesOf(thread)\n    if (!ctx || !replies) return\n    const index = replies.toArray().findIndex(r => r.id === replyId)\n    if (index >= 0 && replies.get(index).author.id === ctx.user.id) replies.delete(index, 1)\n  }\n\n  function activate(id: string | null, options: { reveal?: boolean } = {}): void {\n    const instance = current()\n    if (instance) setActiveComment(instance, id, options)\n  }\n\n  function startDraft(): void {\n    const ctx = writable()\n    if (ctx) startCommentDraft(ctx.editor)\n  }\n\n  function cancelDraft(): void {\n    const instance = current()\n    if (instance) cancelCommentDraft(instance)\n  }\n\n  return { state: store, refresh, dispose, add, reply, edit, setResolved, remove, removeReply, activate, startDraft, cancelDraft }\n}\n\n/** Creates the comments model of one editor, as a host supplies it to `commentsFeatureCore`. */\nexport type CommentsModelFactory = (getEditor: () => Editor | undefined) => CommentsModel\n\n// The host's model factory per surface context, set by the comments feature while the surface builds its extensions.\nconst modelFactories = new WeakMap<FeatureContext, CommentsModelFactory>()\n\n/** Registers the host model factory of `ctx` (the comments feature does this; hosts pass `model` to the feature). */\nexport function provideCommentsModel(ctx: FeatureContext, factory: CommentsModelFactory): void {\n  modelFactories.set(ctx, factory)\n}\n\n/** The host model factory the comments feature of `ctx` was configured with; undefined for the default Y.Doc model. */\nexport function commentsModelOf(ctx: FeatureContext): CommentsModelFactory | undefined {\n  return modelFactories.get(ctx)\n}\n\n/**\n * The comments model the framework hooks (`useComments`) use: the model of the surface `getEditor` belongs to\n * (`commentsModelOf` of its feature context: the host's `model` factory) and `createCommentsModel` for every other\n * editor. It follows the editor over time: when the editor changes to one of a surface with another model, the inner\n * model is replaced (disposed, created, refreshed) and `state` carries on with the new one. The factory runs once per\n * consumer of this function, so a host model that must share state across them keeps it outside the factory.\n */\nexport function createEditorCommentsModel(getEditor: () => Editor | undefined): CommentsModel {\n  const store = createStore<CommentsSnapshot>(EMPTY_SNAPSHOT)\n  let inner: { model: CommentsModel, factory: CommentsModelFactory, stop: () => void } | undefined\n\n  function release() {\n    inner?.stop()\n    inner?.model.dispose()\n    inner = undefined\n  }\n\n  /** The inner model for the editor now; a replacement when its surface brings another factory. */\n  function current(): CommentsModel {\n    const entry = editorEntryOf(getEditor())\n    const factory = (entry && commentsModelOf(entry.ctx)) ?? createCommentsModel\n    if (inner?.factory !== factory) {\n      release()\n      const model = factory(getEditor)\n      inner = { model, factory, stop: model.state.subscribe(snapshot => store.set(snapshot)) }\n      store.set(model.state.get())\n    }\n    return inner!.model\n  }\n\n  return {\n    state: store,\n    refresh: () => current().refresh(),\n    dispose: () => {\n      release()\n      store.set(EMPTY_SNAPSHOT)\n    },\n    add: text => current().add(text),\n    reply: (threadId, text) => current().reply(threadId, text),\n    edit: (threadId, replyId, text) => current().edit(threadId, replyId, text),\n    setResolved: (threadId, resolved) => current().setResolved(threadId, resolved),\n    remove: threadId => current().remove(threadId),\n    removeReply: (threadId, replyId) => current().removeReply(threadId, replyId),\n    activate: (id, options) => current().activate(id, options),\n    startDraft: () => current().startDraft(),\n    cancelDraft: () => current().cancelDraft(),\n  }\n}\n"],"mappings":"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"}

package/dist/features/comments/react/CommentThreadView.d.ts

@@ -1,7 +1,8 @@
 import { AuthorIdentity } from "../../../core/feature.js";
+import { CommentThread, CommentsActions } from "../../../core/backend-types.js";
 import "../../../core/index.js";
-import { CommentThread } from "../schema.js";
-import { CommentsActions } from "../model.js";
+import "../model.js";
+import "../schema.js";
 //#region src/features/comments/react/CommentThreadView.d.ts
 /**
  * One comment thread as a card: root comment (with the commented text, or „Textstelle gelöscht“ for an orphan),

package/dist/features/comments/react/use-comments.d.ts

@@ -1,4 +1,5 @@
-import { CommentsActions, CommentsSnapshot } from "../model.js";
+import { CommentsActions, CommentsSnapshot } from "../../../core/backend-types.js";
+import "../model.js";
 import { Editor } from "@tiptap/core";
 //#region src/features/comments/react/use-comments.d.ts
 /** What `useComments` returns; layouts pass it on to `CommentThreadView`. */

package/dist/features/comments/react.d.ts

@@ -1,6 +1,6 @@
-import { CommentsFeatureOptions } from "./feature.js";
 import { ReactFeature } from "../../react/EditorSurface.js";
 import "../../react/index.js";
+import { CommentsFeatureOptions } from "./feature.js";
 import { CommentBubble } from "./react/CommentBubble.js";
 import { CommentComposer } from "./react/CommentComposer.js";
 import { CommentsListMenu } from "./react/CommentsListMenu.js";

package/dist/features/comments/schema.d.ts

@@ -1,5 +1,5 @@
 import { COMMENTS_LAYOUTS, CommentsLayout } from "../../settings/values.js";
-import { AuthorIdentity } from "../../core/feature.js";
+import { CommentAnchor, CommentAuthor, CommentReply, CommentThread } from "../../core/backend-types.js";
 import "../../core/schema/mark-flags.js";
 import { AnyExtension, Mark } from "@tiptap/core";
 //#region src/features/comments/schema.d.ts
@@ -10,56 +10,6 @@ export declare const COMMENT_LIMITS: {
   readonly text: 5000;
   readonly quote: 200;
 };
-/** Who wrote a comment or reply: the writing user's identity, copied in when writing. */
-export type CommentAuthor = AuthorIdentity;
-export interface CommentReply {
-  id: string;
-  author: CommentAuthor;
-  text: string;
-  /** ISO timestamps; `editedAt` once the author changed the text. */
-  createdAt: string;
-  editedAt?: string;
-}
-/**
- * Where a thread's text starts, as the JSON form of a Yjs relative position (`Y.relativePositionToJSON`): bound to the
- * first commented character, so it keeps pointing at the place after that text was deleted (and moves with the text
- * around it). Stored in the thread's `Y.Map` under `anchor`, so every collaborator resolves the same place.
- */
-export interface CommentAnchor {
-  type?: {
-    client: number;
-    clock: number;
-  };
-  tname?: string;
-  item?: {
-    client: number;
-    clock: number;
-  };
-  assoc?: number;
-}
-/**
- * A comment thread: the root comment plus its replies. Stored as a nested `Y.Map` in `ydoc.getMap(COMMENTS_FIELD)`
- * (replies as a nested `Y.Array`), so concurrent replies and edits of different users merge. Its text range is the
- * `comment` mark with the thread's `id`.
- */
-export interface CommentThread {
-  id: string;
-  author: CommentAuthor;
-  text: string;
-  createdAt: string;
-  editedAt?: string;
-  /** The commented text when the thread was created, cut to `COMMENT_LIMITS.quote`. */
-  quote: string;
-  /** Resolved threads are kept, without highlight, until reopened. */
-  resolved: boolean;
-  /**
-   * Start of the commented text as a Yjs relative position, written when the thread is created (older threads get it
-   * once they are seen with their text still in the document). Tells where an orphaned thread's text was. Absent on threads
-   * not yet seen with a range, and when the position could not be captured.
-   */
-  anchor?: CommentAnchor;
-  replies: CommentReply[];
-}
 /**
  * Anchors a comment thread to text (attribute `id` = the thread's id). Storage only: the visible highlight is a
  * client-side decoration driven by the thread's state (`Comments` extension). `excludes: ''` lets the marks of
@@ -70,5 +20,5 @@ export declare const CommentMark: Mark<any, any>;
 /** The comment mark of the document schema. */
 export declare const commentsSchemaExtensions: () => AnyExtension[];
 //#endregion
-export { COMMENTS_LAYOUTS, type CommentsLayout };
+export { COMMENTS_LAYOUTS, type CommentAnchor, type CommentAuthor, type CommentReply, type CommentThread, type CommentsLayout };
 //# sourceMappingURL=schema.d.ts.map

package/dist/features/comments/schema.js.map

@@ -1 +1 @@
-{"version":3,"file":"schema.js","names":[],"sources":["../../../src/features/comments/schema.ts"],"sourcesContent":["import { type AnyExtension, Mark, mergeAttributes } from '@tiptap/core'\nimport type { AuthorIdentity } from '../../core/feature'\nimport '../../core/schema/mark-flags'\n\n// Vue-free and server-importable (`@ecsplico/editor/comments/schema`): the comment mark that anchors a thread to\n// text, the thread data model and the limits. The Y.Map store, the highlights and the UI live in the feature.\n\nexport { COMMENTS_LAYOUTS, type CommentsLayout } from '../../settings/values'\n\n/** Name of the `Y.Map` holding the comment threads in the Y.Doc, beside the document's 'default' XmlFragment. */\nexport const COMMENTS_FIELD = 'comments'\n\n/** Maximum lengths of a comment's or reply's text and of the quoted text a thread keeps of its range. */\nexport const COMMENT_LIMITS = { text: 5000, quote: 200 } as const\n\n/** Who wrote a comment or reply: the writing user's identity, copied in when writing. */\nexport type CommentAuthor = AuthorIdentity\n\nexport interface CommentReply {\n  id: string\n  author: CommentAuthor\n  text: string\n  /** ISO timestamps; `editedAt` once the author changed the text. */\n  createdAt: string\n  editedAt?: string\n}\n\n/**\n * Where a thread's text starts, as the JSON form of a Yjs relative position (`Y.relativePositionToJSON`): bound to the\n * first commented character, so it keeps pointing at the place after that text was deleted (and moves with the text\n * around it). Stored in the thread's `Y.Map` under `anchor`, so every collaborator resolves the same place.\n */\nexport interface CommentAnchor {\n  type?: { client: number, clock: number }\n  tname?: string\n  item?: { client: number, clock: number }\n  assoc?: number\n}\n\n/**\n * A comment thread: the root comment plus its replies. Stored as a nested `Y.Map` in `ydoc.getMap(COMMENTS_FIELD)`\n * (replies as a nested `Y.Array`), so concurrent replies and edits of different users merge. Its text range is the\n * `comment` mark with the thread's `id`.\n */\nexport interface CommentThread {\n  id: string\n  author: CommentAuthor\n  text: string\n  createdAt: string\n  editedAt?: string\n  /** The commented text when the thread was created, cut to `COMMENT_LIMITS.quote`. */\n  quote: string\n  /** Resolved threads are kept, without highlight, until reopened. */\n  resolved: boolean\n  /**\n   * Start of the commented text as a Yjs relative position, written when the thread is created (older threads get it\n   * once they are seen with their text still in the document). Tells where an orphaned thread's text was. Absent on threads\n   * not yet seen with a range, and when the position could not be captured.\n   */\n  anchor?: CommentAnchor\n  replies: CommentReply[]\n}\n\n/**\n * Anchors a comment thread to text (attribute `id` = the thread's id). Storage only: the visible highlight is a\n * client-side decoration driven by the thread's state (`Comments` extension). `excludes: ''` lets the marks of\n * overlapping threads coexist on the same text; `inclusive: false` keeps text typed at the end of a range outside it.\n * No Markdown form (`markdownInvisible`).\n */\nexport const CommentMark = Mark.create({\n  name: 'comment',\n  excludes: '',\n  inclusive: false,\n  markdownInvisible: true,\n  addAttributes() {\n    return {\n      id: {\n        default: null,\n        parseHTML: el => el.getAttribute('data-comment-id'),\n        renderHTML: attrs => ({ 'data-comment-id': attrs.id }),\n      },\n    }\n  },\n  parseHTML: () => [{ tag: 'span[data-comment-id]' }],\n  renderHTML: ({ HTMLAttributes }) => ['span', mergeAttributes(HTMLAttributes, { class: 'comment' }), 0],\n})\n\n/** The comment mark of the document schema. */\nexport const commentsSchemaExtensions = (): AnyExtension[] => [CommentMark]\n"],"mappings":";;;;AAUA,MAAa,iBAAiB;;AAG9B,MAAa,iBAAiB;CAAE,MAAM;CAAM,OAAO;AAAI;;;;;;;AAwDvD,MAAa,cAAc,KAAK,OAAO;CACrC,MAAM;CACN,UAAU;CACV,WAAW;CACX,mBAAmB;CACnB,gBAAgB;EACd,OAAO,EACL,IAAI;GACF,SAAS;GACT,YAAW,OAAM,GAAG,aAAa,iBAAiB;GAClD,aAAY,WAAU,EAAE,mBAAmB,MAAM,GAAG;EACtD,EACF;CACF;CACA,iBAAiB,CAAC,EAAE,KAAK,wBAAwB,CAAC;CAClD,aAAa,EAAE,qBAAqB;EAAC;EAAQ,gBAAgB,gBAAgB,EAAE,OAAO,UAAU,CAAC;EAAG;CAAC;AACvG,CAAC;;AAGD,MAAa,iCAAiD,CAAC,WAAW"}
+{"version":3,"file":"schema.js","names":[],"sources":["../../../src/features/comments/schema.ts"],"sourcesContent":["import { type AnyExtension, Mark, mergeAttributes } from '@tiptap/core'\nimport '../../core/schema/mark-flags'\n\n// Vue-free and server-importable (`@ecsplico/editor/comments/schema`): the comment mark that anchors a thread to\n// text, the thread data model and the limits. The Y.Map store, the highlights and the UI live in the feature.\n\nexport { COMMENTS_LAYOUTS, type CommentsLayout } from '../../settings/values'\n\n/** Name of the `Y.Map` holding the comment threads in the Y.Doc, beside the document's 'default' XmlFragment. */\nexport const COMMENTS_FIELD = 'comments'\n\n/** Maximum lengths of a comment's or reply's text and of the quoted text a thread keeps of its range. */\nexport const COMMENT_LIMITS = { text: 5000, quote: 200 } as const\n\n// The thread data model (`CommentThread`, its replies, author and anchor) is core's, because `EditorBackend.comments`\n// returns a model of them; this entry exports the types as before.\nexport type { CommentAnchor, CommentAuthor, CommentReply, CommentThread } from '../../core/backend-types'\n\n/**\n * Anchors a comment thread to text (attribute `id` = the thread's id). Storage only: the visible highlight is a\n * client-side decoration driven by the thread's state (`Comments` extension). `excludes: ''` lets the marks of\n * overlapping threads coexist on the same text; `inclusive: false` keeps text typed at the end of a range outside it.\n * No Markdown form (`markdownInvisible`).\n */\nexport const CommentMark = Mark.create({\n  name: 'comment',\n  excludes: '',\n  inclusive: false,\n  markdownInvisible: true,\n  addAttributes() {\n    return {\n      id: {\n        default: null,\n        parseHTML: el => el.getAttribute('data-comment-id'),\n        renderHTML: attrs => ({ 'data-comment-id': attrs.id }),\n      },\n    }\n  },\n  parseHTML: () => [{ tag: 'span[data-comment-id]' }],\n  renderHTML: ({ HTMLAttributes }) => ['span', mergeAttributes(HTMLAttributes, { class: 'comment' }), 0],\n})\n\n/** The comment mark of the document schema. */\nexport const commentsSchemaExtensions = (): AnyExtension[] => [CommentMark]\n"],"mappings":";;;;AASA,MAAa,iBAAiB;;AAG9B,MAAa,iBAAiB;CAAE,MAAM;CAAM,OAAO;AAAI;;;;;;;AAYvD,MAAa,cAAc,KAAK,OAAO;CACrC,MAAM;CACN,UAAU;CACV,WAAW;CACX,mBAAmB;CACnB,gBAAgB;EACd,OAAO,EACL,IAAI;GACF,SAAS;GACT,YAAW,OAAM,GAAG,aAAa,iBAAiB;GAClD,aAAY,WAAU,EAAE,mBAAmB,MAAM,GAAG;EACtD,EACF;CACF;CACA,iBAAiB,CAAC,EAAE,KAAK,wBAAwB,CAAC;CAClD,aAAa,EAAE,qBAAqB;EAAC;EAAQ,gBAAgB,gBAAgB,EAAE,OAAO,UAAU,CAAC;EAAG;CAAC;AACvG,CAAC;;AAGD,MAAa,iCAAiD,CAAC,WAAW"}

package/dist/features/comments/snapshot-equality.js.map

@@ -1 +1 @@
-{"version":3,"file":"snapshot-equality.js","names":[],"sources":["../../../src/features/comments/snapshot-equality.ts"],"sourcesContent":["import type { AuthorIdentity } from '../../core'\nimport type { CommentsSnapshot, DocRange } from './model'\nimport type { CommentThread } from './schema'\n\n// What both comments models (the Y.Doc one in `./model` and the REST one in `adapters/comments/client`) need to hand\n// out a snapshot that keeps its identity while nothing in it changed. Type-only imports: this module stays free of `yjs`.\n\nexport const NO_RANGES: ReadonlyMap<string, DocRange> = new Map()\nexport const NO_THREADS: readonly CommentThread[] = []\nexport const NO_POSITIONS: ReadonlyMap<string, number> = new Map()\n\n/** The snapshot of an editor that has no comments (yet). */\nexport const EMPTY_SNAPSHOT: CommentsSnapshot = {\n  available: false,\n  canComment: false,\n  user: null,\n  threads: NO_THREADS,\n  ranges: NO_RANGES,\n  orphanAt: NO_POSITIONS,\n  active: null,\n  draft: null,\n  draftQuote: '',\n  open: NO_THREADS,\n  resolved: NO_THREADS,\n}\n\nexport function sameRange(a: DocRange | null, b: DocRange | null): boolean {\n  return a === b || (!!a && !!b && a.from === b.from && a.to === b.to)\n}\n\nexport function sameRanges(a: ReadonlyMap<string, DocRange>, b: ReadonlyMap<string, DocRange>): boolean {\n  if (a === b) return true\n  if (a.size !== b.size) return false\n  for (const [id, range] of a) {\n    if (!sameRange(range, b.get(id) ?? null)) return false\n  }\n  return true\n}\n\nexport function sameOrphanAt(a: ReadonlyMap<string, number>, b: ReadonlyMap<string, number>): boolean {\n  if (a === b) return true\n  if (a.size !== b.size) return false\n  for (const [id, position] of a) {\n    if (b.get(id) !== position) return false\n  }\n  return true\n}\n\nexport function sameUser(a: AuthorIdentity | null, b: AuthorIdentity | null): boolean {\n  return a === b || (!!a && !!b && a.id === b.id && a.name === b.name && a.color === b.color)\n}\n"],"mappings":";AAOA,MAAa,4BAA2C,IAAI,IAAI;AAChE,MAAa,aAAuC,CAAC;AACrD,MAAa,+BAA4C,IAAI,IAAI;;AAGjE,MAAa,iBAAmC;CAC9C,WAAW;CACX,YAAY;CACZ,MAAM;CACN,SAAS;CACT,QAAQ;CACR,UAAU;CACV,QAAQ;CACR,OAAO;CACP,YAAY;CACZ,MAAM;CACN,UAAU;AACZ;AAEA,SAAgB,UAAU,GAAoB,GAA6B;CACzE,OAAO,MAAM,KAAM,CAAC,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,OAAO,EAAE;AACnE;AAEA,SAAgB,WAAW,GAAkC,GAA2C;CACtG,IAAI,MAAM,GAAG,OAAO;CACpB,IAAI,EAAE,SAAS,EAAE,MAAM,OAAO;CAC9B,KAAK,MAAM,CAAC,IAAI,UAAU,GACxB,IAAI,CAAC,UAAU,OAAO,EAAE,IAAI,EAAE,KAAK,IAAI,GAAG,OAAO;CAEnD,OAAO;AACT;AAEA,SAAgB,aAAa,GAAgC,GAAyC;CACpG,IAAI,MAAM,GAAG,OAAO;CACpB,IAAI,EAAE,SAAS,EAAE,MAAM,OAAO;CAC9B,KAAK,MAAM,CAAC,IAAI,aAAa,GAC3B,IAAI,EAAE,IAAI,EAAE,MAAM,UAAU,OAAO;CAErC,OAAO;AACT;AAEA,SAAgB,SAAS,GAA0B,GAAmC;CACpF,OAAO,MAAM,KAAM,CAAC,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,UAAU,EAAE;AACvF"}
+{"version":3,"file":"snapshot-equality.js","names":[],"sources":["../../../src/features/comments/snapshot-equality.ts"],"sourcesContent":["import type { AuthorIdentity } from '../../core'\nimport type { CommentsSnapshot, DocRange } from './model'\nimport type { CommentThread } from './schema'\n\n// What both comments models (the Y.Doc one in `./model` and the REST one in `adapters/comments/rest-model`) need to hand\n// out a snapshot that keeps its identity while nothing in it changed. Type-only imports: this module stays free of `yjs`.\n\nexport const NO_RANGES: ReadonlyMap<string, DocRange> = new Map()\nexport const NO_THREADS: readonly CommentThread[] = []\nexport const NO_POSITIONS: ReadonlyMap<string, number> = new Map()\n\n/** The snapshot of an editor that has no comments (yet). */\nexport const EMPTY_SNAPSHOT: CommentsSnapshot = {\n  available: false,\n  canComment: false,\n  user: null,\n  threads: NO_THREADS,\n  ranges: NO_RANGES,\n  orphanAt: NO_POSITIONS,\n  active: null,\n  draft: null,\n  draftQuote: '',\n  open: NO_THREADS,\n  resolved: NO_THREADS,\n}\n\nexport function sameRange(a: DocRange | null, b: DocRange | null): boolean {\n  return a === b || (!!a && !!b && a.from === b.from && a.to === b.to)\n}\n\nexport function sameRanges(a: ReadonlyMap<string, DocRange>, b: ReadonlyMap<string, DocRange>): boolean {\n  if (a === b) return true\n  if (a.size !== b.size) return false\n  for (const [id, range] of a) {\n    if (!sameRange(range, b.get(id) ?? null)) return false\n  }\n  return true\n}\n\nexport function sameOrphanAt(a: ReadonlyMap<string, number>, b: ReadonlyMap<string, number>): boolean {\n  if (a === b) return true\n  if (a.size !== b.size) return false\n  for (const [id, position] of a) {\n    if (b.get(id) !== position) return false\n  }\n  return true\n}\n\nexport function sameUser(a: AuthorIdentity | null, b: AuthorIdentity | null): boolean {\n  return a === b || (!!a && !!b && a.id === b.id && a.name === b.name && a.color === b.color)\n}\n"],"mappings":";AAOA,MAAa,4BAA2C,IAAI,IAAI;AAChE,MAAa,aAAuC,CAAC;AACrD,MAAa,+BAA4C,IAAI,IAAI;;AAGjE,MAAa,iBAAmC;CAC9C,WAAW;CACX,YAAY;CACZ,MAAM;CACN,SAAS;CACT,QAAQ;CACR,UAAU;CACV,QAAQ;CACR,OAAO;CACP,YAAY;CACZ,MAAM;CACN,UAAU;AACZ;AAEA,SAAgB,UAAU,GAAoB,GAA6B;CACzE,OAAO,MAAM,KAAM,CAAC,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,OAAO,EAAE;AACnE;AAEA,SAAgB,WAAW,GAAkC,GAA2C;CACtG,IAAI,MAAM,GAAG,OAAO;CACpB,IAAI,EAAE,SAAS,EAAE,MAAM,OAAO;CAC9B,KAAK,MAAM,CAAC,IAAI,UAAU,GACxB,IAAI,CAAC,UAAU,OAAO,EAAE,IAAI,EAAE,KAAK,IAAI,GAAG,OAAO;CAEnD,OAAO;AACT;AAEA,SAAgB,aAAa,GAAgC,GAAyC;CACpG,IAAI,MAAM,GAAG,OAAO;CACpB,IAAI,EAAE,SAAS,EAAE,MAAM,OAAO;CAC9B,KAAK,MAAM,CAAC,IAAI,aAAa,GAC3B,IAAI,EAAE,IAAI,EAAE,MAAM,UAAU,OAAO;CAErC,OAAO;AACT;AAEA,SAAgB,SAAS,GAA0B,GAAmC;CACpF,OAAO,MAAM,KAAM,CAAC,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,UAAU,EAAE;AACvF"}

package/dist/features/comments/use-comments.d.ts

@@ -1,7 +1,8 @@
 import { AuthorIdentity } from "../../core/feature.js";
+import { CommentThread, CommentsActions, DocRange } from "../../core/backend-types.js";
 import "../../core/index.js";
-import { CommentThread } from "./schema.js";
-import { CommentsActions, DocRange } from "./model.js";
+import "./model.js";
+import "./schema.js";
 import { Editor } from "@tiptap/core";
 import { ComputedRef, MaybeRefOrGetter, Ref } from "vue";
 //#region src/features/comments/use-comments.d.ts

package/dist/features/comments/vue.d.ts

@@ -1,5 +1,5 @@
-import { CommentsFeatureOptions } from "./feature.js";
 import { VueFeature } from "../../vue/index.js";
+import { CommentsFeatureOptions } from "./feature.js";
 import _default from "./components/CommentBubble.vue.js";
 import _default$1 from "./components/CommentComposer.vue.js";
 import _default$3 from "./components/CommentsListMenu.vue.js";

package/dist/features/composites/accepted-children.d.ts

@@ -1,5 +1,6 @@
 import { Translate } from "../../i18n/index.js";
 import { Notifier } from "../../core/notify.js";
+import "../../core/command-types.js";
 import { Extension } from "@tiptap/core";
 import { Node as Node$1 } from "@tiptap/pm/model";
 //#region src/features/composites/accepted-children.d.ts

package/dist/features/composites/accepted-children.js

@@ -50,6 +50,21 @@ function nestingViolations(doc, kinds) {
 	walk(doc, null);
 	return found;
 }
+/**
+* The insert guard of the composites feature: a Baustein of kind `creates.attrs.kind` may be created only where the
+* nearest Baustein around the insertion point (`$parent` and outward; quotes and lists in between do not count)
+* accepts that kind, or where there is none. Uses `kindAccepts`, the rule `AcceptedChildren` enforces on transactions
+* through `nestingViolations`, so the `/` menu and toolbar offer exactly what an edit would not be refused for.
+*/
+const compositeInsertGuard = (editor, $parent, creates) => {
+	const child = creates.attrs?.kind;
+	if (creates.type !== "composite" || typeof child !== "string") return true;
+	for (let depth = $parent.depth; depth >= 0; depth--) {
+		const node = $parent.node(depth);
+		if (node.type.name === "composite") return kindAccepts(compositeKindsOf(editor), String(node.attrs.kind), child);
+	}
+	return true;
+};
 /** A step that cannot change which Baustein sits in which: marks, text typed or deleted inside one textblock, attributes other than `kind`. */
 function keepsNesting(step, before) {
 	if (step instanceof AddMarkStep || step instanceof RemoveMarkStep) return true;
@@ -121,6 +136,6 @@ const AcceptedChildren = Extension.create({
 	}
 });
 //#endregion
-export { AcceptedChildren, nestingReason, nestingViolations, outermostComposites };
+export { AcceptedChildren, compositeInsertGuard, nestingReason, nestingViolations, outermostComposites };
 
 //# sourceMappingURL=accepted-children.js.map