@ecsplico/editor 2.0.0 → 2.1.1

package/dist/features/comments/thread-anchor.js

@@ -0,0 +1,33 @@
+import * as Y from "yjs";
+//#region src/features/comments/thread-anchor.ts
+/** The document position `anchor` points at now; null when it cannot be resolved (no Yjs session, or the text's block is gone for good). */
+function resolveThreadAnchor(state, resolver, anchor) {
+	try {
+		const position = Y.createRelativePositionFromJSON(anchor);
+		return resolver.resolve(state, {
+			from: position,
+			to: position
+		})?.from ?? null;
+	} catch {
+		return null;
+	}
+}
+/**
+* The anchor of the text in `range` (its first character); null without a Yjs session or when the position does not
+* resolve back to `range.from` (a document the editor has not rendered yet), so no wrong place is ever stored.
+* `state` must match the Y document.
+*/
+function captureThreadAnchor(state, resolver, range) {
+	try {
+		const start = resolver.capture(state, range, true)?.from;
+		if (!(start instanceof Y.RelativePosition)) return null;
+		const anchor = JSON.parse(JSON.stringify(Y.relativePositionToJSON(start)));
+		return resolveThreadAnchor(state, resolver, anchor) === range.from ? anchor : null;
+	} catch {
+		return null;
+	}
+}
+//#endregion
+export { captureThreadAnchor, resolveThreadAnchor };
+
+//# sourceMappingURL=thread-anchor.js.map

package/dist/features/comments/thread-anchor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"thread-anchor.js","names":[],"sources":["../../../src/features/comments/thread-anchor.ts"],"sourcesContent":["import type { EditorState } from '@tiptap/pm/state'\nimport * as Y from 'yjs'\nimport type { AnchorResolver } from '../../core'\nimport type { CommentAnchor } from './schema'\n\n// The thread anchor: where a thread's text starts, as a Yjs relative position kept in the thread's Y.Map. The position\n// mapping is the document's `AnchorResolver` (collab feature), the same one the `DocAnchors` of AI flows use.\n\n/** The document position `anchor` points at now; null when it cannot be resolved (no Yjs session, or the text's block is gone for good). */\nexport function resolveThreadAnchor(state: EditorState, resolver: AnchorResolver, anchor: CommentAnchor): number | null {\n  try {\n    const position = Y.createRelativePositionFromJSON(anchor)\n    return resolver.resolve(state, { from: position, to: position })?.from ?? null\n  }\n  catch {\n    return null\n  }\n}\n\n/**\n * The anchor of the text in `range` (its first character); null without a Yjs session or when the position does not\n * resolve back to `range.from` (a document the editor has not rendered yet), so no wrong place is ever stored.\n * `state` must match the Y document.\n */\nexport function captureThreadAnchor(state: EditorState, resolver: AnchorResolver, range: { from: number, to: number }): CommentAnchor | null {\n  try {\n    // The Yjs resolver's range token is `{ from, to }` of relative positions; the thread keeps the start.\n    const start = (resolver.capture(state, range, true) as { from?: unknown } | null)?.from\n    if (!(start instanceof Y.RelativePosition)) return null\n    // Plain JSON (the Y.ID instances of the relative position become `{ client, clock }`).\n    const anchor = JSON.parse(JSON.stringify(Y.relativePositionToJSON(start))) as CommentAnchor\n    return resolveThreadAnchor(state, resolver, anchor) === range.from ? anchor : null\n  }\n  catch {\n    return null\n  }\n}\n"],"mappings":";;;AASA,SAAgB,oBAAoB,OAAoB,UAA0B,QAAsC;CACtH,IAAI;EACF,MAAM,WAAW,EAAE,+BAA+B,MAAM;EACxD,OAAO,SAAS,QAAQ,OAAO;GAAE,MAAM;GAAU,IAAI;EAAS,CAAC,CAAC,EAAE,QAAQ;CAC5E,QACM;EACJ,OAAO;CACT;AACF;;;;;;AAOA,SAAgB,oBAAoB,OAAoB,UAA0B,OAA2D;CAC3I,IAAI;EAEF,MAAM,QAAS,SAAS,QAAQ,OAAO,OAAO,IAAI,CAAC,EAAgC;EACnF,IAAI,EAAE,iBAAiB,EAAE,mBAAmB,OAAO;EAEnD,MAAM,SAAS,KAAK,MAAM,KAAK,UAAU,EAAE,uBAAuB,KAAK,CAAC,CAAC;EACzE,OAAO,oBAAoB,OAAO,UAAU,MAAM,MAAM,MAAM,OAAO,SAAS;CAChF,QACM;EACJ,OAAO;CACT;AACF"}

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

@@ -2,8 +2,8 @@ import { AuthorIdentity } from "../../core/feature.js";
 import "../../core/index.js";
 import { CommentThread } from "./schema.js";
 import { CommentsActions, DocRange } from "./model.js";
-import { ComputedRef, MaybeRefOrGetter, Ref } from "vue";
 import { Editor } from "@tiptap/core";
+import { ComputedRef, MaybeRefOrGetter, Ref } from "vue";
 //#region src/features/comments/use-comments.d.ts
 /** What `useComments` returns; layouts pass it on to `CommentThreadView`. */
 export interface CommentsStore extends CommentsActions {
@@ -16,6 +16,8 @@ export interface CommentsStore extends CommentsActions {
   threads: Readonly<Ref<readonly CommentThread[]>>;
   /** Current text range per thread id (threads without one are orphans). */
   ranges: ComputedRef<ReadonlyMap<string, DocRange>>;
+  /** Where the text of an orphaned open thread was (document position); absent for orphans without a usable anchor. */
+  orphanAt: ComputedRef<ReadonlyMap<string, number>>;
   active: ComputedRef<string | null>;
   /** Current range of the draft a new comment is being written for. */
   draft: ComputedRef<DocRange | null>;

package/dist/features/comments/use-comments.js

@@ -22,6 +22,7 @@ function useComments(editor) {
 		user: computed(() => snapshot.value.user),
 		threads: computed(() => snapshot.value.threads),
 		ranges: computed(() => snapshot.value.ranges),
+		orphanAt: computed(() => snapshot.value.orphanAt),
 		active: computed(() => snapshot.value.active),
 		draft: computed(() => snapshot.value.draft),
 		draftQuote: computed(() => snapshot.value.draftQuote),

package/dist/features/comments/use-comments.js.map

@@ -1 +1 @@
-{"version":3,"file":"use-comments.js","names":[],"sources":["../../../src/features/comments/use-comments.ts"],"sourcesContent":["import type { Editor } from '@tiptap/core'\nimport { computed, type ComputedRef, getCurrentScope, type MaybeRefOrGetter, onScopeDispose, type Ref, toRaw, toValue, watch } from 'vue'\nimport type { AuthorIdentity } from '../../core'\nimport { useStoreRef } from '../../vue/store-ref'\nimport { type CommentsActions, createEditorCommentsModel, type DocRange } from './model'\nimport type { CommentThread } from './schema'\n\n/** What `useComments` returns; layouts pass it on to `CommentThreadView`. */\nexport interface CommentsStore extends CommentsActions {\n  /** Comments need a collaborative editor whose `Comments` extension has a user. */\n  available: ComputedRef<boolean>\n  /** The user may compose a comment now: the default model needs an editable editor, a host model may allow readers. */\n  canComment: ComputedRef<boolean>\n  user: ComputedRef<AuthorIdentity | null>\n  /** Plain snapshots of all threads in the Y.Doc, replaced on every change. */\n  threads: Readonly<Ref<readonly CommentThread[]>>\n  /** Current text range per thread id (threads without one are orphans). */\n  ranges: ComputedRef<ReadonlyMap<string, DocRange>>\n  active: ComputedRef<string | null>\n  /** Current range of the draft a new comment is being written for. */\n  draft: ComputedRef<DocRange | null>\n  /** The draft's text as the new thread will keep it (`quote`). */\n  draftQuote: ComputedRef<string>\n  /** Unresolved threads in document order, orphans last; resolved ones newest first. */\n  open: ComputedRef<readonly CommentThread[]>\n  resolved: ComputedRef<readonly CommentThread[]>\n  /** The thread's text was deleted (no `comment` mark left). */\n  isOrphan: (id: string) => boolean\n}\n\n/**\n * The comment threads of an editor as Vue refs: a thin hook over the comments model of the editor's surface (the host's\n * `model` of `commentsFeature`, else `createCommentsModel`: see there for storage and rules). `editor` may be a ref or getter that changes or turns `undefined` (the hook is then idle: no Y.Doc\n * observer). Stops with the current effect scope.\n */\nexport function useComments(editor: MaybeRefOrGetter<Editor | undefined>): CommentsStore {\n  // The surface registry is keyed by the raw editor instance, not by a reactive proxy of it.\n  const model = createEditorCommentsModel(() => {\n    const value = toValue(editor)\n    return value && toRaw(value)\n  })\n  const snapshot = useStoreRef(model.state)\n  if (getCurrentScope()) onScopeDispose(model.dispose)\n  watch(() => toValue(editor), () => model.refresh(), { immediate: true })\n\n  const { add, reply, edit, setResolved, remove, removeReply, activate, startDraft, cancelDraft } = model\n  return {\n    available: computed(() => snapshot.value.available),\n    canComment: computed(() => snapshot.value.canComment),\n    user: computed(() => snapshot.value.user),\n    threads: computed(() => snapshot.value.threads),\n    ranges: computed(() => snapshot.value.ranges),\n    active: computed(() => snapshot.value.active),\n    draft: computed(() => snapshot.value.draft),\n    draftQuote: computed(() => snapshot.value.draftQuote),\n    open: computed(() => snapshot.value.open),\n    resolved: computed(() => snapshot.value.resolved),\n    isOrphan: id => !snapshot.value.ranges.has(id),\n    add,\n    reply,\n    edit,\n    setResolved,\n    remove,\n    removeReply,\n    activate,\n    startDraft,\n    cancelDraft,\n  }\n}\n"],"mappings":";;;;;;;;;AAmCA,SAAgB,YAAY,QAA6D;CAEvF,MAAM,QAAQ,gCAAgC;EAC5C,MAAM,QAAQ,QAAQ,MAAM;EAC5B,OAAO,SAAS,MAAM,KAAK;CAC7B,CAAC;CACD,MAAM,WAAW,YAAY,MAAM,KAAK;CACxC,IAAI,gBAAgB,GAAG,eAAe,MAAM,OAAO;CACnD,YAAY,QAAQ,MAAM,SAAS,MAAM,QAAQ,GAAG,EAAE,WAAW,KAAK,CAAC;CAEvE,MAAM,EAAE,KAAK,OAAO,MAAM,aAAa,QAAQ,aAAa,UAAU,YAAY,gBAAgB;CAClG,OAAO;EACL,WAAW,eAAe,SAAS,MAAM,SAAS;EAClD,YAAY,eAAe,SAAS,MAAM,UAAU;EACpD,MAAM,eAAe,SAAS,MAAM,IAAI;EACxC,SAAS,eAAe,SAAS,MAAM,OAAO;EAC9C,QAAQ,eAAe,SAAS,MAAM,MAAM;EAC5C,QAAQ,eAAe,SAAS,MAAM,MAAM;EAC5C,OAAO,eAAe,SAAS,MAAM,KAAK;EAC1C,YAAY,eAAe,SAAS,MAAM,UAAU;EACpD,MAAM,eAAe,SAAS,MAAM,IAAI;EACxC,UAAU,eAAe,SAAS,MAAM,QAAQ;EAChD,WAAU,OAAM,CAAC,SAAS,MAAM,OAAO,IAAI,EAAE;EAC7C;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;CACF;AACF"}
+{"version":3,"file":"use-comments.js","names":[],"sources":["../../../src/features/comments/use-comments.ts"],"sourcesContent":["import type { Editor } from '@tiptap/core'\nimport { computed, type ComputedRef, getCurrentScope, type MaybeRefOrGetter, onScopeDispose, type Ref, toRaw, toValue, watch } from 'vue'\nimport type { AuthorIdentity } from '../../core'\nimport { useStoreRef } from '../../vue/store-ref'\nimport { type CommentsActions, createEditorCommentsModel, type DocRange } from './model'\nimport type { CommentThread } from './schema'\n\n/** What `useComments` returns; layouts pass it on to `CommentThreadView`. */\nexport interface CommentsStore extends CommentsActions {\n  /** Comments need a collaborative editor whose `Comments` extension has a user. */\n  available: ComputedRef<boolean>\n  /** The user may compose a comment now: the default model needs an editable editor, a host model may allow readers. */\n  canComment: ComputedRef<boolean>\n  user: ComputedRef<AuthorIdentity | null>\n  /** Plain snapshots of all threads in the Y.Doc, replaced on every change. */\n  threads: Readonly<Ref<readonly CommentThread[]>>\n  /** Current text range per thread id (threads without one are orphans). */\n  ranges: ComputedRef<ReadonlyMap<string, DocRange>>\n  /** Where the text of an orphaned open thread was (document position); absent for orphans without a usable anchor. */\n  orphanAt: ComputedRef<ReadonlyMap<string, number>>\n  active: ComputedRef<string | null>\n  /** Current range of the draft a new comment is being written for. */\n  draft: ComputedRef<DocRange | null>\n  /** The draft's text as the new thread will keep it (`quote`). */\n  draftQuote: ComputedRef<string>\n  /** Unresolved threads in document order, orphans last; resolved ones newest first. */\n  open: ComputedRef<readonly CommentThread[]>\n  resolved: ComputedRef<readonly CommentThread[]>\n  /** The thread's text was deleted (no `comment` mark left). */\n  isOrphan: (id: string) => boolean\n}\n\n/**\n * The comment threads of an editor as Vue refs: a thin hook over the comments model of the editor's surface (the host's\n * `model` of `commentsFeature`, else `createCommentsModel`: see there for storage and rules). `editor` may be a ref or getter that changes or turns `undefined` (the hook is then idle: no Y.Doc\n * observer). Stops with the current effect scope.\n */\nexport function useComments(editor: MaybeRefOrGetter<Editor | undefined>): CommentsStore {\n  // The surface registry is keyed by the raw editor instance, not by a reactive proxy of it.\n  const model = createEditorCommentsModel(() => {\n    const value = toValue(editor)\n    return value && toRaw(value)\n  })\n  const snapshot = useStoreRef(model.state)\n  if (getCurrentScope()) onScopeDispose(model.dispose)\n  watch(() => toValue(editor), () => model.refresh(), { immediate: true })\n\n  const { add, reply, edit, setResolved, remove, removeReply, activate, startDraft, cancelDraft } = model\n  return {\n    available: computed(() => snapshot.value.available),\n    canComment: computed(() => snapshot.value.canComment),\n    user: computed(() => snapshot.value.user),\n    threads: computed(() => snapshot.value.threads),\n    ranges: computed(() => snapshot.value.ranges),\n    orphanAt: computed(() => snapshot.value.orphanAt),\n    active: computed(() => snapshot.value.active),\n    draft: computed(() => snapshot.value.draft),\n    draftQuote: computed(() => snapshot.value.draftQuote),\n    open: computed(() => snapshot.value.open),\n    resolved: computed(() => snapshot.value.resolved),\n    isOrphan: id => !snapshot.value.ranges.has(id),\n    add,\n    reply,\n    edit,\n    setResolved,\n    remove,\n    removeReply,\n    activate,\n    startDraft,\n    cancelDraft,\n  }\n}\n"],"mappings":";;;;;;;;;AAqCA,SAAgB,YAAY,QAA6D;CAEvF,MAAM,QAAQ,gCAAgC;EAC5C,MAAM,QAAQ,QAAQ,MAAM;EAC5B,OAAO,SAAS,MAAM,KAAK;CAC7B,CAAC;CACD,MAAM,WAAW,YAAY,MAAM,KAAK;CACxC,IAAI,gBAAgB,GAAG,eAAe,MAAM,OAAO;CACnD,YAAY,QAAQ,MAAM,SAAS,MAAM,QAAQ,GAAG,EAAE,WAAW,KAAK,CAAC;CAEvE,MAAM,EAAE,KAAK,OAAO,MAAM,aAAa,QAAQ,aAAa,UAAU,YAAY,gBAAgB;CAClG,OAAO;EACL,WAAW,eAAe,SAAS,MAAM,SAAS;EAClD,YAAY,eAAe,SAAS,MAAM,UAAU;EACpD,MAAM,eAAe,SAAS,MAAM,IAAI;EACxC,SAAS,eAAe,SAAS,MAAM,OAAO;EAC9C,QAAQ,eAAe,SAAS,MAAM,MAAM;EAC5C,UAAU,eAAe,SAAS,MAAM,QAAQ;EAChD,QAAQ,eAAe,SAAS,MAAM,MAAM;EAC5C,OAAO,eAAe,SAAS,MAAM,KAAK;EAC1C,YAAY,eAAe,SAAS,MAAM,UAAU;EACpD,MAAM,eAAe,SAAS,MAAM,IAAI;EACxC,UAAU,eAAe,SAAS,MAAM,QAAQ;EAChD,WAAU,OAAM,CAAC,SAAS,MAAM,OAAO,IAAI,EAAE;EAC7C;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;CACF;AACF"}

package/dist/features/comments/use-margin-layout.js

@@ -0,0 +1,29 @@
+import { createMarginController } from "./margin-controller.js";
+import { useStoreRef } from "../../vue/store-ref.js";
+import { nextTick, onBeforeUnmount, onMounted, toValue, watch } from "vue";
+//#region src/features/comments/use-margin-layout.ts
+/**
+* The layout of the comments margin as Vue state: a thin hook over `createMarginController` (see there for the
+* measuring). Hand the column, the card and the resolved section elements in through the returned `set*` functions
+* (as function refs); `state` holds the measured tops. Re-measures when `source`'s cards or active card change.
+* Call from `setup()`; it starts on mount and stops on unmount.
+*/
+function useMarginLayout(options) {
+	const controller = createMarginController(options.source);
+	const state = useStoreRef(controller.state);
+	watch(() => toValue(options.editor), (editor) => controller.setEditor(editor), { immediate: true });
+	watch(() => toValue(options.container), (container) => controller.setContainer(container), { immediate: true });
+	watch([() => options.source.cards(), () => options.source.activeId()], () => nextTick(controller.schedule));
+	onMounted(controller.connect);
+	onBeforeUnmount(controller.disconnect);
+	return {
+		state,
+		setColumn: controller.setColumn,
+		setResolvedSection: controller.setResolvedSection,
+		setCard: controller.setCard
+	};
+}
+//#endregion
+export { useMarginLayout };
+
+//# sourceMappingURL=use-margin-layout.js.map

package/dist/features/comments/use-margin-layout.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-margin-layout.js","names":[],"sources":["../../../src/features/comments/use-margin-layout.ts"],"sourcesContent":["import type { Editor } from '@tiptap/core'\nimport { type MaybeRefOrGetter, nextTick, onBeforeUnmount, onMounted, toValue, watch } from 'vue'\nimport { useStoreRef } from '../../vue/store-ref'\nimport { createMarginController, type MarginSource } from './margin-controller'\n\n/**\n * The layout of the comments margin as Vue state: a thin hook over `createMarginController` (see there for the\n * measuring). Hand the column, the card and the resolved section elements in through the returned `set*` functions\n * (as function refs); `state` holds the measured tops. Re-measures when `source`'s cards or active card change.\n * Call from `setup()`; it starts on mount and stops on unmount.\n */\nexport function useMarginLayout(options: {\n  editor: MaybeRefOrGetter<Editor | undefined>\n  /** The editor's scroll container, which the column sits in: its size changes re-run the layout. */\n  container: MaybeRefOrGetter<HTMLElement | null>\n  source: MarginSource\n}) {\n  const controller = createMarginController(options.source)\n  const state = useStoreRef(controller.state)\n\n  watch(() => toValue(options.editor), editor => controller.setEditor(editor), { immediate: true })\n  watch(() => toValue(options.container), container => controller.setContainer(container), { immediate: true })\n  // Cards appearing, disappearing or expanding: measure once the DOM has them.\n  watch([() => options.source.cards(), () => options.source.activeId()], () => nextTick(controller.schedule))\n\n  onMounted(controller.connect)\n  onBeforeUnmount(controller.disconnect)\n\n  return { state, setColumn: controller.setColumn, setResolvedSection: controller.setResolvedSection, setCard: controller.setCard }\n}\n"],"mappings":";;;;;;;;;;AAWA,SAAgB,gBAAgB,SAK7B;CACD,MAAM,aAAa,uBAAuB,QAAQ,MAAM;CACxD,MAAM,QAAQ,YAAY,WAAW,KAAK;CAE1C,YAAY,QAAQ,QAAQ,MAAM,IAAG,WAAU,WAAW,UAAU,MAAM,GAAG,EAAE,WAAW,KAAK,CAAC;CAChG,YAAY,QAAQ,QAAQ,SAAS,IAAG,cAAa,WAAW,aAAa,SAAS,GAAG,EAAE,WAAW,KAAK,CAAC;CAE5G,MAAM,OAAO,QAAQ,OAAO,MAAM,SAAS,QAAQ,OAAO,SAAS,CAAC,SAAS,SAAS,WAAW,QAAQ,CAAC;CAE1G,UAAU,WAAW,OAAO;CAC5B,gBAAgB,WAAW,UAAU;CAErC,OAAO;EAAE;EAAO,WAAW,WAAW;EAAW,oBAAoB,WAAW;EAAoB,SAAS,WAAW;CAAQ;AAClI"}

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

@@ -1,5 +1,5 @@
-import { VueFeature } from "../../vue/index.js";
 import { CommentsFeatureOptions } from "./feature.js";
+import { VueFeature } from "../../vue/index.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

@@ -0,0 +1,21 @@
+import { Translate } from "../../i18n/index.js";
+import { Notifier } from "../../core/notify.js";
+import { Extension } from "@tiptap/core";
+import { Node as Node$1 } from "@tiptap/pm/model";
+//#region src/features/composites/accepted-children.d.ts
+export interface AcceptedChildrenOptions {
+  /** Shows the notice of a refused edit (default: dropped). The composites feature passes the surface's `ctx.notify`. */
+  notify: Notifier;
+  /** The translator of the notice. The composites feature passes the surface's `ctx.t`. */
+  t: Translate;
+}
+/**
+ * Enforces the kinds' accepted children (`CompositeKind.accepts`) for every local edit at one place: a transaction that
+ * leaves the document with more Bausteine nested in a Baustein that does not accept them than before is refused — block
+ * drag, „In Baustein umwandeln“, paste, AI inserts and review acceptance, `moveBlockInto` — and the user is told why.
+ * Existing violations stay: transactions that add none (typing, undoing) pass, and so do collaboration replays, undo/redo
+ * and loading a whole document. Client-only, no schema: kinds are read from the editor (`compositeKindsOf`).
+ */
+export declare const AcceptedChildren: Extension<AcceptedChildrenOptions, any>;
+//#endregion
+//# sourceMappingURL=accepted-children.d.ts.map

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

@@ -0,0 +1,126 @@
+import { createTranslator } from "../../i18n/index.js";
+import { compositeKind, kindAccepts } from "./kinds.js";
+import { compositeKindsOf } from "./nodes.js";
+import { Extension } from "@tiptap/core";
+import { Plugin, PluginKey } from "@tiptap/pm/state";
+import { AddMarkStep, AttrStep, RemoveMarkStep, ReplaceStep } from "@tiptap/pm/transform";
+//#region src/features/composites/accepted-children.ts
+/** The short sentence for a refused nesting, naming both kinds by label (German: „Notiz nimmt keine Aufgabe auf.“). */
+function nestingReason(kinds, parent, child, t) {
+	return t("composites.nesting.refused", {
+		parent: compositeKind(kinds, parent).label,
+		child: compositeKind(kinds, child).label
+	});
+}
+/**
+* The Bausteine of `node`'s subtree, outermost first: `node` itself when it is a Baustein, otherwise the Bausteine
+* directly inside it (not those nested in another Baustein).
+*/
+function outermostComposites(node) {
+	if (node.type.name === "composite") return [node];
+	const found = [];
+	node.descendants((child) => {
+		if (child.type.name === "composite") {
+			found.push(child);
+			return false;
+		}
+		return !child.isTextblock;
+	});
+	return found;
+}
+/**
+* Every Baustein in `doc` whose nearest Baustein ancestor (quotes and lists in between do not count) does not accept
+* its kind, in document order. Top-level Bausteine have no parent and never violate.
+*/
+function nestingViolations(doc, kinds) {
+	const found = [];
+	function walk(node, parentKind) {
+		node.forEach((child) => {
+			if (child.isTextblock || child.isLeaf) return;
+			if (child.type.name === "composite") {
+				const kind = String(child.attrs.kind);
+				if (parentKind !== null && !kindAccepts(kinds, parentKind, kind)) found.push({
+					parent: parentKind,
+					child: kind
+				});
+				walk(child, kind);
+			} else walk(child, parentKind);
+		});
+	}
+	walk(doc, null);
+	return found;
+}
+/** 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;
+	if (step instanceof AttrStep) return step.attr !== "kind";
+	if (step instanceof ReplaceStep) {
+		const { slice } = step;
+		if (slice.openStart !== 0 || slice.openEnd !== 0 || !slice.content.content.every((child) => child.isInline)) return false;
+		const $from = before.resolve(step.from);
+		return $from.parent.isTextblock && $from.sameParent(before.resolve(step.to));
+	}
+	return false;
+}
+/**
+* Transactions that were not made by this user's edit: collaboration (y-sync marks remote changes and Yjs undo/redo
+* with `isChangeOrigin`) and prosemirror-history's undo/redo. They replay what was allowed, or what others wrote.
+*/
+function isReplay(tr) {
+	return tr.getMeta("y-sync$")?.isChangeOrigin === true || tr.getMeta("history$") !== void 0;
+}
+/** The pair of kinds that occurs more often in `after` than in `before`, if any. */
+function addedViolation(before, after) {
+	const counts = /* @__PURE__ */ new Map();
+	const key = (v) => JSON.stringify([v.parent, v.child]);
+	for (const v of before) counts.set(key(v), (counts.get(key(v)) ?? 0) + 1);
+	for (const v of after) {
+		const left = counts.get(key(v)) ?? 0;
+		if (left === 0) return v;
+		counts.set(key(v), left - 1);
+	}
+	return after[0];
+}
+/**
+* Enforces the kinds' accepted children (`CompositeKind.accepts`) for every local edit at one place: a transaction that
+* leaves the document with more Bausteine nested in a Baustein that does not accept them than before is refused — block
+* drag, „In Baustein umwandeln“, paste, AI inserts and review acceptance, `moveBlockInto` — and the user is told why.
+* Existing violations stay: transactions that add none (typing, undoing) pass, and so do collaboration replays, undo/redo
+* and loading a whole document. Client-only, no schema: kinds are read from the editor (`compositeKindsOf`).
+*/
+const AcceptedChildren = Extension.create({
+	name: "acceptedChildren",
+	addOptions: () => ({
+		notify: () => {},
+		t: createTranslator()
+	}),
+	addProseMirrorPlugins() {
+		const { editor } = this;
+		const { notify, t } = this.options;
+		return [new Plugin({
+			key: new PluginKey("acceptedChildren"),
+			filterTransaction(tr, state) {
+				if (!tr.docChanged || isReplay(tr)) return true;
+				if (tr.steps.some((step, index) => step instanceof ReplaceStep && step.from === 0 && step.to === tr.docs[index].content.size)) return true;
+				if (tr.steps.every((step, index) => keepsNesting(step, tr.docs[index]))) return true;
+				const kinds = compositeKindsOf(editor);
+				const before = nestingViolations(state.doc, kinds);
+				const after = nestingViolations(tr.doc, kinds);
+				if (after.length <= before.length) return true;
+				const added = addedViolation(before, after);
+				notify({
+					id: "composites-accepted-children",
+					title: t("composites.nesting.title"),
+					...added && { description: nestingReason(kinds, added.parent, added.child, t) },
+					kind: "warning",
+					icon: "i-lucide-ban"
+				});
+				return false;
+			}
+		})];
+	}
+});
+//#endregion
+export { AcceptedChildren, nestingReason, nestingViolations, outermostComposites };
+
+//# sourceMappingURL=accepted-children.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"accepted-children.js","names":[],"sources":["../../../src/features/composites/accepted-children.ts"],"sourcesContent":["import { Extension } from '@tiptap/core'\nimport type { Node as PMNode } from '@tiptap/pm/model'\nimport { Plugin, PluginKey, type Transaction } from '@tiptap/pm/state'\nimport { AddMarkStep, AttrStep, RemoveMarkStep, ReplaceStep, type Step } from '@tiptap/pm/transform'\nimport type { Notifier } from '../../core/notify'\nimport { createTranslator, type Translate } from '../../i18n'\nimport { type CompositeKind, compositeKind, kindAccepts } from './kinds'\nimport { compositeKindsOf } from './nodes'\n\n/** One Baustein nested in a Baustein that does not accept its kind (both kind ids). */\nexport interface NestingViolation {\n  parent: string\n  child: string\n}\n\n/** The short sentence for a refused nesting, naming both kinds by label (German: „Notiz nimmt keine Aufgabe auf.“). */\nexport function nestingReason(kinds: readonly CompositeKind[], parent: string, child: string, t: Translate): string {\n  return t('composites.nesting.refused', { parent: compositeKind(kinds, parent).label, child: compositeKind(kinds, child).label })\n}\n\n/**\n * The Bausteine of `node`'s subtree, outermost first: `node` itself when it is a Baustein, otherwise the Bausteine\n * directly inside it (not those nested in another Baustein).\n */\nexport function outermostComposites(node: PMNode): PMNode[] {\n  if (node.type.name === 'composite') return [node]\n  const found: PMNode[] = []\n  node.descendants((child) => {\n    if (child.type.name === 'composite') {\n      found.push(child)\n      return false\n    }\n    return !child.isTextblock\n  })\n  return found\n}\n\n/**\n * Every Baustein in `doc` whose nearest Baustein ancestor (quotes and lists in between do not count) does not accept\n * its kind, in document order. Top-level Bausteine have no parent and never violate.\n */\nexport function nestingViolations(doc: PMNode, kinds: readonly CompositeKind[]): NestingViolation[] {\n  const found: NestingViolation[] = []\n  function walk(node: PMNode, parentKind: string | null) {\n    node.forEach((child) => {\n      if (child.isTextblock || child.isLeaf) return\n      if (child.type.name === 'composite') {\n        const kind = String(child.attrs.kind)\n        if (parentKind !== null && !kindAccepts(kinds, parentKind, kind)) found.push({ parent: parentKind, child: kind })\n        walk(child, kind)\n      }\n      else walk(child, parentKind)\n    })\n  }\n  walk(doc, null)\n  return found\n}\n\n/** A step that cannot change which Baustein sits in which: marks, text typed or deleted inside one textblock, attributes other than `kind`. */\nfunction keepsNesting(step: Step, before: PMNode): boolean {\n  if (step instanceof AddMarkStep || step instanceof RemoveMarkStep) return true\n  if (step instanceof AttrStep) return step.attr !== 'kind'\n  if (step instanceof ReplaceStep) {\n    const { slice } = step\n    if (slice.openStart !== 0 || slice.openEnd !== 0 || !slice.content.content.every(child => child.isInline)) return false\n    const $from = before.resolve(step.from)\n    return $from.parent.isTextblock && $from.sameParent(before.resolve(step.to))\n  }\n  return false\n}\n\n/**\n * Transactions that were not made by this user's edit: collaboration (y-sync marks remote changes and Yjs undo/redo\n * with `isChangeOrigin`) and prosemirror-history's undo/redo. They replay what was allowed, or what others wrote.\n */\nfunction isReplay(tr: Transaction): boolean {\n  const sync = tr.getMeta('y-sync$') as { isChangeOrigin?: boolean } | undefined\n  return sync?.isChangeOrigin === true || tr.getMeta('history$') !== undefined\n}\n\n/** The pair of kinds that occurs more often in `after` than in `before`, if any. */\nfunction addedViolation(before: readonly NestingViolation[], after: readonly NestingViolation[]): NestingViolation | undefined {\n  const counts = new Map<string, number>()\n  const key = (v: NestingViolation) => JSON.stringify([v.parent, v.child])\n  for (const v of before) counts.set(key(v), (counts.get(key(v)) ?? 0) + 1)\n  for (const v of after) {\n    const left = counts.get(key(v)) ?? 0\n    if (left === 0) return v\n    counts.set(key(v), left - 1)\n  }\n  return after[0]\n}\n\nexport interface AcceptedChildrenOptions {\n  /** Shows the notice of a refused edit (default: dropped). The composites feature passes the surface's `ctx.notify`. */\n  notify: Notifier\n  /** The translator of the notice. The composites feature passes the surface's `ctx.t`. */\n  t: Translate\n}\n\n/**\n * Enforces the kinds' accepted children (`CompositeKind.accepts`) for every local edit at one place: a transaction that\n * leaves the document with more Bausteine nested in a Baustein that does not accept them than before is refused — block\n * drag, „In Baustein umwandeln“, paste, AI inserts and review acceptance, `moveBlockInto` — and the user is told why.\n * Existing violations stay: transactions that add none (typing, undoing) pass, and so do collaboration replays, undo/redo\n * and loading a whole document. Client-only, no schema: kinds are read from the editor (`compositeKindsOf`).\n */\nexport const AcceptedChildren = Extension.create<AcceptedChildrenOptions>({\n  name: 'acceptedChildren',\n  addOptions: () => ({ notify: () => {}, t: createTranslator() }),\n  addProseMirrorPlugins() {\n    const { editor } = this\n    const { notify, t } = this.options\n    return [new Plugin({\n      key: new PluginKey('acceptedChildren'),\n      filterTransaction(tr, state) {\n        if (!tr.docChanged || isReplay(tr)) return true\n        // `setContent` loads a whole new document; that is not an edit of the existing one.\n        if (tr.steps.some((step, index) => step instanceof ReplaceStep && step.from === 0 && step.to === tr.docs[index]!.content.size)) return true\n        if (tr.steps.every((step, index) => keepsNesting(step, tr.docs[index]!))) return true\n        const kinds = compositeKindsOf(editor)\n        const before = nestingViolations(state.doc, kinds)\n        const after = nestingViolations(tr.doc, kinds)\n        if (after.length <= before.length) return true\n        const added = addedViolation(before, after)\n        notify({\n          id: 'composites-accepted-children',\n          title: t('composites.nesting.title'),\n          ...(added && { description: nestingReason(kinds, added.parent, added.child, t) }),\n          kind: 'warning',\n          icon: 'i-lucide-ban',\n        })\n        return false\n      },\n    })]\n  },\n})\n"],"mappings":";;;;;;;;AAgBA,SAAgB,cAAc,OAAiC,QAAgB,OAAe,GAAsB;CAClH,OAAO,EAAE,8BAA8B;EAAE,QAAQ,cAAc,OAAO,MAAM,CAAC,CAAC;EAAO,OAAO,cAAc,OAAO,KAAK,CAAC,CAAC;CAAM,CAAC;AACjI;;;;;AAMA,SAAgB,oBAAoB,MAAwB;CAC1D,IAAI,KAAK,KAAK,SAAS,aAAa,OAAO,CAAC,IAAI;CAChD,MAAM,QAAkB,CAAC;CACzB,KAAK,aAAa,UAAU;EAC1B,IAAI,MAAM,KAAK,SAAS,aAAa;GACnC,MAAM,KAAK,KAAK;GAChB,OAAO;EACT;EACA,OAAO,CAAC,MAAM;CAChB,CAAC;CACD,OAAO;AACT;;;;;AAMA,SAAgB,kBAAkB,KAAa,OAAqD;CAClG,MAAM,QAA4B,CAAC;CACnC,SAAS,KAAK,MAAc,YAA2B;EACrD,KAAK,SAAS,UAAU;GACtB,IAAI,MAAM,eAAe,MAAM,QAAQ;GACvC,IAAI,MAAM,KAAK,SAAS,aAAa;IACnC,MAAM,OAAO,OAAO,MAAM,MAAM,IAAI;IACpC,IAAI,eAAe,QAAQ,CAAC,YAAY,OAAO,YAAY,IAAI,GAAG,MAAM,KAAK;KAAE,QAAQ;KAAY,OAAO;IAAK,CAAC;IAChH,KAAK,OAAO,IAAI;GAClB,OACK,KAAK,OAAO,UAAU;EAC7B,CAAC;CACH;CACA,KAAK,KAAK,IAAI;CACd,OAAO;AACT;;AAGA,SAAS,aAAa,MAAY,QAAyB;CACzD,IAAI,gBAAgB,eAAe,gBAAgB,gBAAgB,OAAO;CAC1E,IAAI,gBAAgB,UAAU,OAAO,KAAK,SAAS;CACnD,IAAI,gBAAgB,aAAa;EAC/B,MAAM,EAAE,UAAU;EAClB,IAAI,MAAM,cAAc,KAAK,MAAM,YAAY,KAAK,CAAC,MAAM,QAAQ,QAAQ,OAAM,UAAS,MAAM,QAAQ,GAAG,OAAO;EAClH,MAAM,QAAQ,OAAO,QAAQ,KAAK,IAAI;EACtC,OAAO,MAAM,OAAO,eAAe,MAAM,WAAW,OAAO,QAAQ,KAAK,EAAE,CAAC;CAC7E;CACA,OAAO;AACT;;;;;AAMA,SAAS,SAAS,IAA0B;CAE1C,OADa,GAAG,QAAQ,SACd,CAAC,EAAE,mBAAmB,QAAQ,GAAG,QAAQ,UAAU,MAAM,KAAA;AACrE;;AAGA,SAAS,eAAe,QAAqC,OAAkE;CAC7H,MAAM,yBAAS,IAAI,IAAoB;CACvC,MAAM,OAAO,MAAwB,KAAK,UAAU,CAAC,EAAE,QAAQ,EAAE,KAAK,CAAC;CACvE,KAAK,MAAM,KAAK,QAAQ,OAAO,IAAI,IAAI,CAAC,IAAI,OAAO,IAAI,IAAI,CAAC,CAAC,KAAK,KAAK,CAAC;CACxE,KAAK,MAAM,KAAK,OAAO;EACrB,MAAM,OAAO,OAAO,IAAI,IAAI,CAAC,CAAC,KAAK;EACnC,IAAI,SAAS,GAAG,OAAO;EACvB,OAAO,IAAI,IAAI,CAAC,GAAG,OAAO,CAAC;CAC7B;CACA,OAAO,MAAM;AACf;;;;;;;;AAgBA,MAAa,mBAAmB,UAAU,OAAgC;CACxE,MAAM;CACN,mBAAmB;EAAE,cAAc,CAAC;EAAG,GAAG,iBAAiB;CAAE;CAC7D,wBAAwB;EACtB,MAAM,EAAE,WAAW;EACnB,MAAM,EAAE,QAAQ,MAAM,KAAK;EAC3B,OAAO,CAAC,IAAI,OAAO;GACjB,KAAK,IAAI,UAAU,kBAAkB;GACrC,kBAAkB,IAAI,OAAO;IAC3B,IAAI,CAAC,GAAG,cAAc,SAAS,EAAE,GAAG,OAAO;IAE3C,IAAI,GAAG,MAAM,MAAM,MAAM,UAAU,gBAAgB,eAAe,KAAK,SAAS,KAAK,KAAK,OAAO,GAAG,KAAK,MAAM,CAAE,QAAQ,IAAI,GAAG,OAAO;IACvI,IAAI,GAAG,MAAM,OAAO,MAAM,UAAU,aAAa,MAAM,GAAG,KAAK,MAAO,CAAC,GAAG,OAAO;IACjF,MAAM,QAAQ,iBAAiB,MAAM;IACrC,MAAM,SAAS,kBAAkB,MAAM,KAAK,KAAK;IACjD,MAAM,QAAQ,kBAAkB,GAAG,KAAK,KAAK;IAC7C,IAAI,MAAM,UAAU,OAAO,QAAQ,OAAO;IAC1C,MAAM,QAAQ,eAAe,QAAQ,KAAK;IAC1C,OAAO;KACL,IAAI;KACJ,OAAO,EAAE,0BAA0B;KACnC,GAAI,SAAS,EAAE,aAAa,cAAc,OAAO,MAAM,QAAQ,MAAM,OAAO,CAAC,EAAE;KAC/E,MAAM;KACN,MAAM;IACR,CAAC;IACD,OAAO;GACT;EACF,CAAC,CAAC;CACJ;AACF,CAAC"}

package/dist/features/composites/components/CompositeDetails.js

@@ -1,6 +1,6 @@
+import { compositeKindsOf } from "../nodes.js";
 import { useUiKit } from "../../../vue/kit/use-ui-kit.js";
 import { useEditorI18n } from "../../../vue/use-editor-i18n.js";
-import { compositeKindsOf } from "../nodes.js";
 import { compositeOfRow } from "../rows.js";
 import _sfc_main$1 from "./CompositeFieldEditor.js";
 import _sfc_main$2 from "./CompositeSummaryEditor.js";