@ecsplico/editor 3.1.1 → 3.3.0

package/dist/integrations/composite-ai/index.js

@@ -1,15 +1,18 @@
+import { withHeading } from "../../features/ai/protocol/tasks.js";
 import { ABILITY } from "../../core/schema/abilities.js";
 import { compositeKind } from "../../features/composites/kinds.js";
 import { compositeFence } from "../../features/composites/fences.js";
 import { compositeKindsOf } from "../../features/composites/nodes.js";
-import { withHeading } from "../../features/ai/protocol/tasks.js";
 import { modelProfiles } from "../../features/ai/model-profiles.js";
 import { structureOf } from "../../features/composites/structure.js";
 import { fillComposite, generateCompositeBody } from "./composite-fill.js";
-import { canDeriveAfter, derivableKindsOf, deriveComposite, isDerivableSource } from "./derive.js";
+import { canDeriveAfter, derivableKindsOf, deriveComposite, discardDerived, isDerivableSource, writeDerivedBody } from "./derive.js";
 import { canFetchBibliography, doiOf, fetchBibliography } from "./bibliography-fetch.js";
 import { COMPOSITE_BODY_START, compositeSourceText, summarizeComposite } from "./composite-summary.js";
 import { canCreateRendition, canRegenerateRendition, createRendition, regenerateRendition } from "./rendition.js";
+import { applyOutline, collectHeadings, parseOutlineResponse, sanitizeOutline } from "./outline-sanitize.js";
+import { bodyUnchanged, splitByInsertedHeadings, splitCompositeWithAi } from "./split.js";
+import { bulletsTransform, summaryTransform, transferRequest } from "./transfer-transforms.js";
 import { Extension } from "@tiptap/core";
 //#region src/integrations/composite-ai/index.ts
 /** The editor command `fetchCompositeBibliography` (declared by composites) behind the bibliography editor's „DOI abrufen“ button; absent without the AI capability. */
@@ -98,9 +101,49 @@ function compositeAiActions(ctx) {
 			run: ({ editor, pos }) => {
 				regenerateRendition(editor, pos, ai, modelProfiles(ctx.app).modelRef, ctx.notify, ctx.t);
 			}
+		},
+		...["children", "siblings"].map((mode) => ({
+			id: `composite-split-ai-${mode}`,
+			label: ctx.t(`integrations.compositeSplit.ai.${mode}`),
+			icon: "i-lucide-sparkles",
+			ability: ABILITY.aiGenerate,
+			order: mode === "children" ? 454 : 455,
+			isVisible: ({ node }) => node.type.name === "composite" && compositeSourceText(node).trim().length > 0,
+			run: ({ editor, pos }) => {
+				const { blocks } = ctx.settings.get();
+				splitCompositeWithAi(editor, pos, mode, ai, modelProfiles(ctx.app).modelRef, ctx.notify, ctx.t, {
+					targetChars: blocks.splitTargetChars,
+					defaultKind: blocks.defaultKind
+				});
+			}
+		})),
+		{
+			id: "outline-sanitize",
+			label: ctx.t("integrations.outlineSanitize.label"),
+			icon: "i-lucide-list-tree",
+			ability: ABILITY.aiGenerate,
+			order: 456,
+			isVisible: ({ node }) => node.type.name === "heading",
+			run: ({ editor }) => {
+				sanitizeOutline(editor, ai, modelProfiles(ctx.app).modelRef, ctx.notify, ctx.t);
+			}
 		}
 	];
 }
+/** The ⌘K entry „Gliederung bereinigen (KI)“ (no toolbar button); absent without the AI capability. */
+function compositeAiCommands(ctx) {
+	const ai = ctx.backend.ai;
+	if (!ai) return [];
+	return [{
+		id: "outline-sanitize",
+		label: ctx.t("integrations.outlineSanitize.label"),
+		icon: "i-lucide-list-tree",
+		toolbar: false,
+		run: (editor) => {
+			sanitizeOutline(editor, ai, modelProfiles(ctx.app).modelRef, ctx.notify, ctx.t);
+		}
+	}];
+}
 /**
 * AI on composites (requires `composites`, `ai`, `media`): the „Baustein füllen (KI)“ block action (on composites of
 * kinds with an `ai` configuration: brief + document → task `fill-block`, the result opens the diff review over the
@@ -112,7 +155,9 @@ function compositeAiActions(ctx) {
 * has a heading is inserted as a `section` composite fence, otherwise (and in flat structure) the base AI heading
 * is used. It is the preset's single `formatAiResult` contributor. The base AI feature and the composites feature do
 * not know it. Framework-free: notices go through the surface's `ctx.notify`, the model through the app's
-* `modelProfiles(ctx.app)`.
+* `modelProfiles(ctx.app)`. Also „Mit KI in (Unter-)Bausteine teilen“ (block actions on composites: the model inserts
+* headings, the body is split at them) and „Gliederung bereinigen (KI)“ (⌘K command and block action on headings:
+* repairs the heading outline of the whole document).
 */
 function compositeAiFeature() {
 	return {
@@ -125,6 +170,7 @@ function compositeAiFeature() {
 		],
 		blockActions: compositeAiActions,
 		extensions: bibliographyFetchExtensions,
+		commands: compositeAiCommands,
 		formatAiResult: (editor, markdown, heading) => {
 			if (!heading) return markdown;
 			const text = withHeading(heading, markdown);
@@ -133,6 +179,6 @@ function compositeAiFeature() {
 	};
 }
 //#endregion
-export { COMPOSITE_BODY_START, canCreateRendition, canDeriveAfter, canFetchBibliography, canRegenerateRendition, compositeAiFeature, compositeSourceText, createRendition, derivableKindsOf, deriveComposite, doiOf, fetchBibliography, fillComposite, generateCompositeBody, isDerivableSource, regenerateRendition, summarizeComposite };
+export { COMPOSITE_BODY_START, applyOutline, bodyUnchanged, bulletsTransform, canCreateRendition, canDeriveAfter, canFetchBibliography, canRegenerateRendition, collectHeadings, compositeAiFeature, compositeSourceText, createRendition, derivableKindsOf, deriveComposite, discardDerived, doiOf, fetchBibliography, fillComposite, generateCompositeBody, isDerivableSource, parseOutlineResponse, regenerateRendition, sanitizeOutline, splitByInsertedHeadings, splitCompositeWithAi, summarizeComposite, summaryTransform, transferRequest, writeDerivedBody };
 
 //# sourceMappingURL=index.js.map

package/dist/integrations/composite-ai/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../../../src/integrations/composite-ai/index.ts"],"sourcesContent":["import { type AnyExtension, Extension } from '@tiptap/core'\nimport type { BlockAction, EditorFeature, FeatureContext } from '../../core'\nimport { ABILITY } from '../../core/schema'\nimport { modelProfiles, withHeading } from '../../features/ai'\nimport { structureOf } from '../../features/composites'\nimport '../../features/composites/bibliography-command'\nimport { compositeFence, compositeKind, compositeKindsOf } from '../../features/composites/schema'\nimport { fillComposite } from './composite-fill'\nimport { canDeriveAfter, derivableKindsOf, deriveComposite, isDerivableSource } from './derive'\nimport { canFetchBibliography, fetchBibliography } from './bibliography-fetch'\nimport { compositeSourceText, summarizeComposite } from './composite-summary'\nimport { canCreateRendition, canRegenerateRendition, createRendition, regenerateRendition } from './rendition'\n\nexport { type CompositeBodyResult, fillComposite, generateCompositeBody } from './composite-fill'\nexport { COMPOSITE_BODY_START, compositeSourceText, summarizeComposite } from './composite-summary'\nexport { canCreateRendition, canRegenerateRendition, createRendition, regenerateRendition, type RenditionOptions } from './rendition'\nexport { canDeriveAfter, derivableKindsOf, deriveComposite, isDerivableSource } from './derive'\nexport { canFetchBibliography, doiOf, fetchBibliography } from './bibliography-fetch'\n\n/** The editor command `fetchCompositeBibliography` (declared by composites) behind the bibliography editor's „DOI abrufen“ button; absent without the AI capability. */\nfunction bibliographyFetchExtensions(ctx: FeatureContext): AnyExtension[] {\n  const ai = ctx.backend.ai\n  if (!ai) return []\n  return [Extension.create({\n    name: 'compositeBibliographyFetch',\n    addCommands: () => ({\n      fetchCompositeBibliography: (pos: number) => ({ editor }) => {\n        void fetchBibliography(editor, pos, ai, modelProfiles(ctx.app).modelRef, ctx.notify, ctx.t, ctx.documentId)\n        return true\n      },\n    }),\n  })]\n}\n\nfunction compositeAiActions(ctx: FeatureContext): BlockAction[] {\n  const ai = ctx.backend.ai\n  // Without the AI capability there is nothing to run (`composeEditor` omits the integration in that case).\n  if (!ai) return []\n  return [\n    {\n      id: 'composite-fill',\n      label: ctx.t('integrations.compositeFill.action'),\n      icon: 'i-lucide-wand-sparkles',\n      ability: ABILITY.aiGenerate,\n      order: 25,\n      isVisible: ({ editor, node }) => node.type.name === 'composite' && compositeKind(compositeKindsOf(editor), String(node.attrs.kind)).ai !== undefined,\n      run: ({ editor, pos }) => {\n        void fillComposite(editor, pos, ai, modelProfiles(ctx.app).modelRef, ctx.notify, ctx.t)\n      },\n    },\n    {\n      id: 'composite-summarize',\n      label: ctx.t('integrations.compositeSummary.action'),\n      icon: 'i-lucide-text-quote',\n      ability: ABILITY.compositeSummarize,\n      order: 30,\n      isVisible: ({ node }) => compositeSourceText(node).trim().length > 0,\n      run: ({ editor, pos }) => {\n        void summarizeComposite(editor, pos, ai, modelProfiles(ctx.app).modelRef, ctx.notify, ctx.t)\n      },\n    },\n    {\n      id: 'composite-derive',\n      label: ctx.t('integrations.compositeDerive.action'),\n      icon: 'i-lucide-git-branch',\n      ability: ABILITY.compositeDerive,\n      order: 452,\n      isVisible: ({ editor, node }) => isDerivableSource(editor, node),\n      menu: ({ editor, pos }) => derivableKindsOf(editor).map(kind => ({\n        label: kind.label,\n        icon: kind.icon,\n        disabled: !canDeriveAfter(editor, pos, kind.id),\n        onSelect: () => {\n          void deriveComposite(editor, pos, kind.id, ai, modelProfiles(ctx.app).modelRef, ctx.notify, ctx.t)\n        },\n      })),\n    },\n    {\n      id: 'bibliography-fetch',\n      label: ctx.t('integrations.bibliographyFetch.action'),\n      icon: 'i-lucide-book-marked',\n      ability: ABILITY.compositeDerive,\n      order: 453,\n      isVisible: ({ editor, node }) => canFetchBibliography(editor, node),\n      run: ({ editor, pos }) => {\n        void fetchBibliography(editor, pos, ai, modelProfiles(ctx.app).modelRef, ctx.notify, ctx.t, ctx.documentId)\n      },\n    },\n    {\n      id: 'rendition-create',\n      label: ctx.t('integrations.rendition.action'),\n      icon: 'i-lucide-captions',\n      ability: ABILITY.compositeDerive,\n      order: 450,\n      isVisible: ({ editor, node }) => canCreateRendition(editor, node, !!ctx.ai?.transcription),\n      run: ({ editor, pos }) => {\n        void createRendition(editor, pos, ai, modelProfiles(ctx.app).modelRef, ctx.notify, ctx.t)\n      },\n    },\n    {\n      id: 'rendition-regenerate',\n      label: ctx.t('integrations.rendition.regenerate'),\n      icon: 'i-lucide-refresh-cw',\n      ability: ABILITY.compositeDerive,\n      order: 451,\n      isVisible: ({ editor, node, pos }) => canRegenerateRendition(editor, node, pos, !!ctx.ai?.transcription),\n      run: ({ editor, pos }) => {\n        regenerateRendition(editor, pos, ai, modelProfiles(ctx.app).modelRef, ctx.notify, ctx.t)\n      },\n    },\n  ]\n}\n\n/**\n * AI on composites (requires `composites`, `ai`, `media`): the „Baustein füllen (KI)“ block action (on composites of\n * kinds with an `ai` configuration: brief + document → task `fill-block`, the result opens the diff review over the\n * body), the „Zusammenfassung erzeugen“ block action (streams a\n * summary of a composite's body into its description), the „Lesefassung erzeugen“ / „Neu erzeugen (ersetzen)“\n * actions of source-holding Bausteine (`ai.extract`: a rendition child with the transcript, full text or description of\n * the source; a recording needs the app's public AI configuration to enable transcription),\n * and the composite-structure form of AI results: with `composite` structure an AI result that\n * has a heading is inserted as a `section` composite fence, otherwise (and in flat structure) the base AI heading\n * is used. It is the preset's single `formatAiResult` contributor. The base AI feature and the composites feature do\n * not know it. Framework-free: notices go through the surface's `ctx.notify`, the model through the app's\n * `modelProfiles(ctx.app)`.\n */\nexport function compositeAiFeature(): EditorFeature<never> {\n  return {\n    id: 'composite-ai',\n    dimension: 'ai',\n    requires: ['composites', 'ai', 'media'],\n    blockActions: compositeAiActions,\n    extensions: bibliographyFetchExtensions,\n    formatAiResult: (editor, markdown, heading) => {\n      if (!heading) return markdown\n      const text = withHeading(heading, markdown)\n      return structureOf(editor) === 'composite' ? compositeFence('section', {}, text) : text\n    },\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"index.js","names":[],"sources":["../../../src/integrations/composite-ai/index.ts"],"sourcesContent":["import { type AnyExtension, Extension } from '@tiptap/core'\nimport type { BlockAction, CommandDef, EditorFeature, FeatureContext } from '../../core'\nimport { ABILITY } from '../../core/schema'\nimport { modelProfiles, withHeading } from '../../features/ai'\nimport { structureOf } from '../../features/composites'\nimport '../../features/composites/bibliography-command'\nimport { compositeFence, compositeKind, compositeKindsOf } from '../../features/composites/schema'\nimport { fillComposite } from './composite-fill'\nimport { canDeriveAfter, derivableKindsOf, deriveComposite, isDerivableSource } from './derive'\nimport { canFetchBibliography, fetchBibliography } from './bibliography-fetch'\nimport { compositeSourceText, summarizeComposite } from './composite-summary'\nimport { canCreateRendition, canRegenerateRendition, createRendition, regenerateRendition } from './rendition'\nimport { sanitizeOutline } from './outline-sanitize'\nimport { splitCompositeWithAi } from './split'\n\nexport { bulletsTransform, summaryTransform, transferRequest } from './transfer-transforms'\n\nexport { type CompositeBodyResult, fillComposite, generateCompositeBody } from './composite-fill'\nexport { COMPOSITE_BODY_START, compositeSourceText, summarizeComposite } from './composite-summary'\nexport { canCreateRendition, canRegenerateRendition, createRendition, regenerateRendition, type RenditionOptions } from './rendition'\nexport { canDeriveAfter, derivableKindsOf, deriveComposite, discardDerived, isDerivableSource, writeDerivedBody } from './derive'\nexport { canFetchBibliography, doiOf, fetchBibliography } from './bibliography-fetch'\nexport { applyOutline, collectHeadings, type OutlineEntry, type OutlineHeading, parseOutlineResponse, sanitizeOutline } from './outline-sanitize'\nexport { bodyUnchanged, splitByInsertedHeadings, splitCompositeWithAi } from './split'\n\n/** The editor command `fetchCompositeBibliography` (declared by composites) behind the bibliography editor's „DOI abrufen“ button; absent without the AI capability. */\nfunction bibliographyFetchExtensions(ctx: FeatureContext): AnyExtension[] {\n  const ai = ctx.backend.ai\n  if (!ai) return []\n  return [Extension.create({\n    name: 'compositeBibliographyFetch',\n    addCommands: () => ({\n      fetchCompositeBibliography: (pos: number) => ({ editor }) => {\n        void fetchBibliography(editor, pos, ai, modelProfiles(ctx.app).modelRef, ctx.notify, ctx.t, ctx.documentId)\n        return true\n      },\n    }),\n  })]\n}\n\nfunction compositeAiActions(ctx: FeatureContext): BlockAction[] {\n  const ai = ctx.backend.ai\n  // Without the AI capability there is nothing to run (`composeEditor` omits the integration in that case).\n  if (!ai) return []\n  return [\n    {\n      id: 'composite-fill',\n      label: ctx.t('integrations.compositeFill.action'),\n      icon: 'i-lucide-wand-sparkles',\n      ability: ABILITY.aiGenerate,\n      order: 25,\n      isVisible: ({ editor, node }) => node.type.name === 'composite' && compositeKind(compositeKindsOf(editor), String(node.attrs.kind)).ai !== undefined,\n      run: ({ editor, pos }) => {\n        void fillComposite(editor, pos, ai, modelProfiles(ctx.app).modelRef, ctx.notify, ctx.t)\n      },\n    },\n    {\n      id: 'composite-summarize',\n      label: ctx.t('integrations.compositeSummary.action'),\n      icon: 'i-lucide-text-quote',\n      ability: ABILITY.compositeSummarize,\n      order: 30,\n      isVisible: ({ node }) => compositeSourceText(node).trim().length > 0,\n      run: ({ editor, pos }) => {\n        void summarizeComposite(editor, pos, ai, modelProfiles(ctx.app).modelRef, ctx.notify, ctx.t)\n      },\n    },\n    {\n      id: 'composite-derive',\n      label: ctx.t('integrations.compositeDerive.action'),\n      icon: 'i-lucide-git-branch',\n      ability: ABILITY.compositeDerive,\n      order: 452,\n      isVisible: ({ editor, node }) => isDerivableSource(editor, node),\n      menu: ({ editor, pos }) => derivableKindsOf(editor).map(kind => ({\n        label: kind.label,\n        icon: kind.icon,\n        disabled: !canDeriveAfter(editor, pos, kind.id),\n        onSelect: () => {\n          void deriveComposite(editor, pos, kind.id, ai, modelProfiles(ctx.app).modelRef, ctx.notify, ctx.t)\n        },\n      })),\n    },\n    {\n      id: 'bibliography-fetch',\n      label: ctx.t('integrations.bibliographyFetch.action'),\n      icon: 'i-lucide-book-marked',\n      ability: ABILITY.compositeDerive,\n      order: 453,\n      isVisible: ({ editor, node }) => canFetchBibliography(editor, node),\n      run: ({ editor, pos }) => {\n        void fetchBibliography(editor, pos, ai, modelProfiles(ctx.app).modelRef, ctx.notify, ctx.t, ctx.documentId)\n      },\n    },\n    {\n      id: 'rendition-create',\n      label: ctx.t('integrations.rendition.action'),\n      icon: 'i-lucide-captions',\n      ability: ABILITY.compositeDerive,\n      order: 450,\n      isVisible: ({ editor, node }) => canCreateRendition(editor, node, !!ctx.ai?.transcription),\n      run: ({ editor, pos }) => {\n        void createRendition(editor, pos, ai, modelProfiles(ctx.app).modelRef, ctx.notify, ctx.t)\n      },\n    },\n    {\n      id: 'rendition-regenerate',\n      label: ctx.t('integrations.rendition.regenerate'),\n      icon: 'i-lucide-refresh-cw',\n      ability: ABILITY.compositeDerive,\n      order: 451,\n      isVisible: ({ editor, node, pos }) => canRegenerateRendition(editor, node, pos, !!ctx.ai?.transcription),\n      run: ({ editor, pos }) => {\n        regenerateRendition(editor, pos, ai, modelProfiles(ctx.app).modelRef, ctx.notify, ctx.t)\n      },\n    },\n    ...(['children', 'siblings'] as const).map((mode): BlockAction => ({\n      id: `composite-split-ai-${mode}`,\n      label: ctx.t(`integrations.compositeSplit.ai.${mode}`),\n      icon: 'i-lucide-sparkles',\n      ability: ABILITY.aiGenerate,\n      order: mode === 'children' ? 454 : 455,\n      isVisible: ({ node }) => node.type.name === 'composite' && compositeSourceText(node).trim().length > 0,\n      run: ({ editor, pos }) => {\n        const { blocks } = ctx.settings.get()\n        void splitCompositeWithAi(editor, pos, mode, ai, modelProfiles(ctx.app).modelRef, ctx.notify, ctx.t, { targetChars: blocks.splitTargetChars, defaultKind: blocks.defaultKind })\n      },\n    })),\n    {\n      id: 'outline-sanitize',\n      label: ctx.t('integrations.outlineSanitize.label'),\n      icon: 'i-lucide-list-tree',\n      ability: ABILITY.aiGenerate,\n      order: 456,\n      isVisible: ({ node }) => node.type.name === 'heading',\n      run: ({ editor }) => {\n        void sanitizeOutline(editor, ai, modelProfiles(ctx.app).modelRef, ctx.notify, ctx.t)\n      },\n    },\n  ]\n}\n\n/** The ⌘K entry „Gliederung bereinigen (KI)“ (no toolbar button); absent without the AI capability. */\nfunction compositeAiCommands(ctx: FeatureContext): CommandDef<never>[] {\n  const ai = ctx.backend.ai\n  if (!ai) return []\n  return [{\n    id: 'outline-sanitize',\n    label: ctx.t('integrations.outlineSanitize.label'),\n    icon: 'i-lucide-list-tree',\n    toolbar: false,\n    run: (editor) => {\n      void sanitizeOutline(editor, ai, modelProfiles(ctx.app).modelRef, ctx.notify, ctx.t)\n    },\n  }]\n}\n\n/**\n * AI on composites (requires `composites`, `ai`, `media`): the „Baustein füllen (KI)“ block action (on composites of\n * kinds with an `ai` configuration: brief + document → task `fill-block`, the result opens the diff review over the\n * body), the „Zusammenfassung erzeugen“ block action (streams a\n * summary of a composite's body into its description), the „Lesefassung erzeugen“ / „Neu erzeugen (ersetzen)“\n * actions of source-holding Bausteine (`ai.extract`: a rendition child with the transcript, full text or description of\n * the source; a recording needs the app's public AI configuration to enable transcription),\n * and the composite-structure form of AI results: with `composite` structure an AI result that\n * has a heading is inserted as a `section` composite fence, otherwise (and in flat structure) the base AI heading\n * is used. It is the preset's single `formatAiResult` contributor. The base AI feature and the composites feature do\n * not know it. Framework-free: notices go through the surface's `ctx.notify`, the model through the app's\n * `modelProfiles(ctx.app)`. Also „Mit KI in (Unter-)Bausteine teilen“ (block actions on composites: the model inserts\n * headings, the body is split at them) and „Gliederung bereinigen (KI)“ (⌘K command and block action on headings:\n * repairs the heading outline of the whole document).\n */\nexport function compositeAiFeature(): EditorFeature<never> {\n  return {\n    id: 'composite-ai',\n    dimension: 'ai',\n    requires: ['composites', 'ai', 'media'],\n    blockActions: compositeAiActions,\n    extensions: bibliographyFetchExtensions,\n    commands: compositeAiCommands,\n    formatAiResult: (editor, markdown, heading) => {\n      if (!heading) return markdown\n      const text = withHeading(heading, markdown)\n      return structureOf(editor) === 'composite' ? compositeFence('section', {}, text) : text\n    },\n  }\n}\n"],"mappings":"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"}

package/dist/integrations/composite-ai/outline-sanitize.d.ts

@@ -0,0 +1,48 @@
+import { Translate } from "../../i18n/index.js";
+import { EditorBackend } from "../../core/backend.js";
+import { Notifier } from "../../core/notify.js";
+import { ModelRef } from "../../core/backend-types.js";
+import "../../features/ai/index.js";
+import { Editor } from "@tiptap/core";
+import { Transaction } from "@tiptap/pm/state";
+import { Node as Node$1 } from "@tiptap/pm/model";
+//#region src/integrations/composite-ai/outline-sanitize.d.ts
+/** A heading of the document as the model sees it, plus where it is: `i` is its index in document order, `chars` the text length of the blocks under it up to the next heading of the same or a higher level. */
+export interface OutlineHeading {
+  i: number;
+  level: number;
+  text: string;
+  chars: number;
+  pos: number;
+}
+/** The model's answer for one heading: its level and text (empty: the heading is removed). */
+export interface OutlineEntry {
+  i: number;
+  level: number;
+  text: string;
+}
+/** Every `heading` node of `doc` (any depth, document order). */
+export declare function collectHeadings(doc: Node$1): OutlineHeading[];
+/**
+ * The model's answer as one entry per heading, or `null` when it is not exactly that: a JSON list (a Markdown code
+ * fence around it is tolerated) of the same length as `headings`, `i` equal to the position, `level` an integer 1..6,
+ * `text` a string.
+ */
+export declare function parseOutlineResponse(text: string, headings: readonly {
+  i: number;
+}[]): OutlineEntry[] | null;
+/**
+ * Writes `outline` into `tr` for the `headings` collected from `tr.doc` (so far unchanged): an empty text removes the
+ * heading, otherwise its level and, when it differs, its text (as plain text) are set. Runs from the last heading to
+ * the first, so the positions of the earlier ones stay valid. Returns how many headings changed.
+ */
+export declare function applyOutline(tr: Transaction, headings: readonly OutlineHeading[], outline: readonly OutlineEntry[]): number;
+/**
+ * „Gliederung bereinigen (KI)“: sends the headings of the whole document (task `outline-sanitize`, `generate` slot) and
+ * applies the model's repaired outline (levels without gaps, numbering and trailing punctuation gone, empty headings
+ * merged into the next) in one transaction. A malformed answer, or a document whose headings changed while the model
+ * ran, writes nothing and shows a notice. Notices go through `notify`, in the language of `t`.
+ */
+export declare function sanitizeOutline(editor: Editor, ai: NonNullable<EditorBackend['ai']>, modelRef: (slot: 'generate') => ModelRef, notify: Notifier, t: Translate): Promise<void>;
+//#endregion
+//# sourceMappingURL=outline-sanitize.d.ts.map

package/dist/integrations/composite-ai/outline-sanitize.js

@@ -0,0 +1,175 @@
+import { AI_LIMITS } from "../../features/ai/protocol/tasks.js";
+import { headingGroupRange } from "../../features/composites/heading-composites.js";
+import { notifyAiRateLimited } from "../../features/ai/rate-limit.js";
+import { postAiSse } from "../../features/ai/ai-sse.js";
+//#region src/integrations/composite-ai/outline-sanitize.ts
+/** Every `heading` node of `doc` (any depth, document order). */
+function collectHeadings(doc) {
+	const headings = [];
+	doc.descendants((node, pos, parent, index) => {
+		if (node.type.name !== "heading" || !parent) return;
+		const { to } = headingGroupRange(parent, index);
+		let chars = 0;
+		for (let sibling = index + 1; sibling < to; sibling++) chars += parent.child(sibling).textContent.length;
+		headings.push({
+			i: headings.length,
+			level: node.attrs.level,
+			text: node.textContent,
+			chars,
+			pos
+		});
+	});
+	return headings;
+}
+/**
+* The model's answer as one entry per heading, or `null` when it is not exactly that: a JSON list (a Markdown code
+* fence around it is tolerated) of the same length as `headings`, `i` equal to the position, `level` an integer 1..6,
+* `text` a string.
+*/
+function parseOutlineResponse(text, headings) {
+	let parsed;
+	try {
+		parsed = JSON.parse(text.trim().replace(/^```(?:json)?\s*/i, "").replace(/\s*```$/, ""));
+	} catch {
+		return null;
+	}
+	if (!Array.isArray(parsed) || parsed.length !== headings.length) return null;
+	const entries = [];
+	for (const [index, item] of parsed.entries()) {
+		const { i, level, text: value } = item ?? {};
+		if (i !== index || typeof level !== "number" || !Number.isInteger(level) || level < 1 || level > 6 || typeof value !== "string") return null;
+		entries.push({
+			i,
+			level,
+			text: value.trim()
+		});
+	}
+	return entries;
+}
+/**
+* Writes `outline` into `tr` for the `headings` collected from `tr.doc` (so far unchanged): an empty text removes the
+* heading, otherwise its level and, when it differs, its text (as plain text) are set. Runs from the last heading to
+* the first, so the positions of the earlier ones stay valid. Returns how many headings changed.
+*/
+function applyOutline(tr, headings, outline) {
+	let changed = 0;
+	for (let index = headings.length - 1; index >= 0; index--) {
+		const { pos } = headings[index];
+		const { level, text } = outline[index];
+		const node = tr.doc.nodeAt(pos);
+		if (node?.type.name !== "heading") continue;
+		if (!text) {
+			tr.delete(pos, pos + node.nodeSize);
+			changed++;
+			continue;
+		}
+		const retext = text !== node.textContent;
+		if (!retext && level === node.attrs.level) continue;
+		if (level !== node.attrs.level) tr.setNodeMarkup(pos, void 0, {
+			...node.attrs,
+			level
+		});
+		if (retext) tr.replaceWith(pos + 1, pos + 1 + node.content.size, tr.doc.type.schema.text(text));
+		changed++;
+	}
+	return changed;
+}
+/**
+* „Gliederung bereinigen (KI)“: sends the headings of the whole document (task `outline-sanitize`, `generate` slot) and
+* applies the model's repaired outline (levels without gaps, numbering and trailing punctuation gone, empty headings
+* merged into the next) in one transaction. A malformed answer, or a document whose headings changed while the model
+* ran, writes nothing and shows a notice. Notices go through `notify`, in the language of `t`.
+*/
+async function sanitizeOutline(editor, ai, modelRef, notify, t) {
+	const headings = collectHeadings(editor.state.doc);
+	if (!headings.length) {
+		notify({
+			title: t("integrations.outlineSanitize.none"),
+			kind: "info"
+		});
+		return;
+	}
+	const selection = JSON.stringify(headings.map(({ i, level, text, chars }) => ({
+		i,
+		level,
+		text,
+		chars
+	})));
+	if (selection.length > AI_LIMITS.selection) {
+		notify({
+			title: t("integrations.outlineSanitize.tooLong"),
+			kind: "error"
+		});
+		return;
+	}
+	const toastId = "outline-sanitize";
+	const controller = new AbortController();
+	const abort = () => controller.abort();
+	editor.on("destroy", abort);
+	notify({
+		id: toastId,
+		title: t("integrations.outlineSanitize.running"),
+		kind: "info",
+		icon: "i-lucide-loader-circle",
+		duration: 0
+	});
+	let output = "";
+	try {
+		const outcome = await postAiSse(ai, "generate", {
+			task: "outline-sanitize",
+			prompt: "",
+			selection,
+			context: "",
+			model: modelRef("generate")
+		}, {
+			signal: controller.signal,
+			t,
+			onDelta: (text) => {
+				output += text;
+			}
+		});
+		if (outcome.status === "aborted" || editor.isDestroyed) return;
+		if (outcome.status === "rate-limited") {
+			notifyAiRateLimited(notify, t);
+			return;
+		}
+		if (outcome.status === "error") {
+			notify({
+				title: t("integrations.outlineSanitize.failed"),
+				description: outcome.message,
+				kind: "error"
+			});
+			return;
+		}
+		const outline = parseOutlineResponse(output, headings);
+		if (!outline) {
+			notify({
+				title: t("integrations.outlineSanitize.invalid"),
+				kind: "warning"
+			});
+			return;
+		}
+		const current = collectHeadings(editor.state.doc);
+		if (current.length !== headings.length || current.some((heading, index) => heading.pos !== headings[index].pos || heading.level !== headings[index].level || heading.text !== headings[index].text)) {
+			notify({
+				title: t("integrations.outlineSanitize.gone"),
+				kind: "error"
+			});
+			return;
+		}
+		const tr = editor.state.tr;
+		if (applyOutline(tr, current, outline)) editor.view.dispatch(tr);
+		notify({
+			title: t("integrations.outlineSanitize.done"),
+			kind: "success",
+			icon: "i-lucide-list-tree"
+		});
+	} finally {
+		notify.dismiss?.(toastId);
+		editor.off("destroy", abort);
+	}
+}
+//#endregion
+export { applyOutline, collectHeadings, parseOutlineResponse, sanitizeOutline };
+
+//# sourceMappingURL=outline-sanitize.js.map

package/dist/integrations/composite-ai/outline-sanitize.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"outline-sanitize.js","names":[],"sources":["../../../src/integrations/composite-ai/outline-sanitize.ts"],"sourcesContent":["import type { Editor } from '@tiptap/core'\nimport type { Node as PMNode } from '@tiptap/pm/model'\nimport type { Transaction } from '@tiptap/pm/state'\nimport type { EditorBackend } from '../../core/backend'\nimport type { Notifier } from '../../core/notify'\nimport type { Translate } from '../../i18n'\nimport { AI_LIMITS, type ModelRef, notifyAiRateLimited, postAiSse } from '../../features/ai'\nimport { headingGroupRange } from '../../features/composites/schema'\n\n/** A heading of the document as the model sees it, plus where it is: `i` is its index in document order, `chars` the text length of the blocks under it up to the next heading of the same or a higher level. */\nexport interface OutlineHeading { i: number, level: number, text: string, chars: number, pos: number }\n\n/** The model's answer for one heading: its level and text (empty: the heading is removed). */\nexport interface OutlineEntry { i: number, level: number, text: string }\n\n/** Every `heading` node of `doc` (any depth, document order). */\nexport function collectHeadings(doc: PMNode): OutlineHeading[] {\n  const headings: OutlineHeading[] = []\n  doc.descendants((node, pos, parent, index) => {\n    if (node.type.name !== 'heading' || !parent) return\n    const { to } = headingGroupRange(parent, index)\n    let chars = 0\n    for (let sibling = index + 1; sibling < to; sibling++) chars += parent.child(sibling).textContent.length\n    headings.push({ i: headings.length, level: node.attrs.level as number, text: node.textContent, chars, pos })\n  })\n  return headings\n}\n\n/**\n * The model's answer as one entry per heading, or `null` when it is not exactly that: a JSON list (a Markdown code\n * fence around it is tolerated) of the same length as `headings`, `i` equal to the position, `level` an integer 1..6,\n * `text` a string.\n */\nexport function parseOutlineResponse(text: string, headings: readonly { i: number }[]): OutlineEntry[] | null {\n  let parsed: unknown\n  try {\n    parsed = JSON.parse(text.trim().replace(/^```(?:json)?\\s*/i, '').replace(/\\s*```$/, ''))\n  }\n  catch {\n    return null\n  }\n  if (!Array.isArray(parsed) || parsed.length !== headings.length) return null\n  const entries: OutlineEntry[] = []\n  for (const [index, item] of parsed.entries()) {\n    const { i, level, text: value } = (item ?? {}) as Partial<Record<'i' | 'level' | 'text', unknown>>\n    if (i !== index || typeof level !== 'number' || !Number.isInteger(level) || level < 1 || level > 6 || typeof value !== 'string') return null\n    entries.push({ i, level, text: value.trim() })\n  }\n  return entries\n}\n\n/**\n * Writes `outline` into `tr` for the `headings` collected from `tr.doc` (so far unchanged): an empty text removes the\n * heading, otherwise its level and, when it differs, its text (as plain text) are set. Runs from the last heading to\n * the first, so the positions of the earlier ones stay valid. Returns how many headings changed.\n */\nexport function applyOutline(tr: Transaction, headings: readonly OutlineHeading[], outline: readonly OutlineEntry[]): number {\n  let changed = 0\n  for (let index = headings.length - 1; index >= 0; index--) {\n    const { pos } = headings[index]!\n    const { level, text } = outline[index]!\n    const node = tr.doc.nodeAt(pos)\n    if (node?.type.name !== 'heading') continue\n    if (!text) {\n      tr.delete(pos, pos + node.nodeSize)\n      changed++\n      continue\n    }\n    const retext = text !== node.textContent\n    if (!retext && level === node.attrs.level) continue\n    if (level !== node.attrs.level) tr.setNodeMarkup(pos, undefined, { ...node.attrs, level })\n    if (retext) tr.replaceWith(pos + 1, pos + 1 + node.content.size, tr.doc.type.schema.text(text))\n    changed++\n  }\n  return changed\n}\n\n/**\n * „Gliederung bereinigen (KI)“: sends the headings of the whole document (task `outline-sanitize`, `generate` slot) and\n * applies the model's repaired outline (levels without gaps, numbering and trailing punctuation gone, empty headings\n * merged into the next) in one transaction. A malformed answer, or a document whose headings changed while the model\n * ran, writes nothing and shows a notice. Notices go through `notify`, in the language of `t`.\n */\nexport async function sanitizeOutline(editor: Editor, ai: NonNullable<EditorBackend['ai']>, modelRef: (slot: 'generate') => ModelRef, notify: Notifier, t: Translate): Promise<void> {\n  const headings = collectHeadings(editor.state.doc)\n  if (!headings.length) {\n    notify({ title: t('integrations.outlineSanitize.none'), kind: 'info' })\n    return\n  }\n  const selection = JSON.stringify(headings.map(({ i, level, text, chars }) => ({ i, level, text, chars })))\n  if (selection.length > AI_LIMITS.selection) {\n    notify({ title: t('integrations.outlineSanitize.tooLong'), kind: 'error' })\n    return\n  }\n\n  const toastId = 'outline-sanitize'\n  const controller = new AbortController()\n  const abort = () => controller.abort()\n  editor.on('destroy', abort)\n  notify({ id: toastId, title: t('integrations.outlineSanitize.running'), kind: 'info', icon: 'i-lucide-loader-circle', duration: 0 })\n  let output = ''\n  try {\n    const outcome = await postAiSse(ai, 'generate', {\n      task: 'outline-sanitize',\n      prompt: '',\n      selection,\n      context: '',\n      model: modelRef('generate'),\n    }, { signal: controller.signal, t, onDelta: (text) => { output += text } })\n\n    if (outcome.status === 'aborted' || editor.isDestroyed) return\n    if (outcome.status === 'rate-limited') {\n      notifyAiRateLimited(notify, t)\n      return\n    }\n    if (outcome.status === 'error') {\n      notify({ title: t('integrations.outlineSanitize.failed'), description: outcome.message, kind: 'error' })\n      return\n    }\n    const outline = parseOutlineResponse(output, headings)\n    if (!outline) {\n      notify({ title: t('integrations.outlineSanitize.invalid'), kind: 'warning' })\n      return\n    }\n\n    const current = collectHeadings(editor.state.doc)\n    if (current.length !== headings.length || current.some((heading, index) => heading.pos !== headings[index]!.pos || heading.level !== headings[index]!.level || heading.text !== headings[index]!.text)) {\n      notify({ title: t('integrations.outlineSanitize.gone'), kind: 'error' })\n      return\n    }\n    const tr = editor.state.tr\n    if (applyOutline(tr, current, outline)) editor.view.dispatch(tr)\n    notify({ title: t('integrations.outlineSanitize.done'), kind: 'success', icon: 'i-lucide-list-tree' })\n  }\n  finally {\n    notify.dismiss?.(toastId)\n    editor.off('destroy', abort)\n  }\n}\n"],"mappings":"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"}

package/dist/integrations/composite-ai/split.d.ts

@@ -0,0 +1,44 @@
+import { Translate } from "../../i18n/index.js";
+import { EditorBackend } from "../../core/backend.js";
+import { Notifier } from "../../core/notify.js";
+import { ModelRef } from "../../core/backend-types.js";
+import "../../features/ai/index.js";
+import { SplitMode } from "../../features/composites/split.js";
+import { Editor } from "@tiptap/core";
+import { Node as Node$1, Schema } from "@tiptap/pm/model";
+//#region src/integrations/composite-ai/split.d.ts
+/**
+ * Whether the model only inserted headings: `result` without its heading lines equals `original` with whitespace
+ * collapsed (so line breaks and blank lines may differ, words may not). Heading lines the original already has stay
+ * part of the comparison, so the model cannot drop or rewrite them.
+ */
+export declare function bodyUnchanged(original: string, result: string): boolean;
+/**
+ * The nodes that replace `composite` when the model's result (`blocks`, the result Markdown as blocks, with headings
+ * inserted) is split at those headings, or `null` when it yields fewer than two parts. Every part gets the model's
+ * heading as a hidden title (`meta.titleHidden`), no block id.
+ *
+ * - `children`: one node, the composite with the blocks before the first heading followed by one sub-Baustein of
+ *   `kind` per heading.
+ * - `siblings`: the composite keeps the blocks before the first heading (without any, the body of the first heading
+ *   group, its heading is dropped); every further heading group becomes a following sibling of the composite's own kind.
+ *
+ * The headings of the result are level 2, so only the lowest level present is grouped (`groupHeadingsIntoComposites`,
+ * not recursive).
+ */
+export declare function splitByInsertedHeadings(schema: Schema, composite: Node$1, blocks: readonly Node$1[], mode: SplitMode, kind: string): Node$1[] | null;
+/**
+ * „Mit KI teilen“: asks the model to insert `##` headings into the body of the Baustein at `pos` (task `split-block`,
+ * `targetChars` as the wanted section size, `generate` slot) and splits the body at them, in `mode`:
+ * `children` makes sub-Bausteine, `siblings` makes following Bausteine of the same kind. The model may only insert
+ * headings: when the text minus those headings is not the original body (`bodyUnchanged`) nothing is written and a
+ * warning is shown. The Baustein is anchored while the model runs; edits to its body meanwhile discard the result.
+ * The write is one transaction. `defaultKind` is the setting `blocks.defaultKind` (see `childKindFor`). Notices go
+ * through `notify`, in the language of `t`.
+ */
+export declare function splitCompositeWithAi(editor: Editor, pos: number, mode: SplitMode, ai: NonNullable<EditorBackend['ai']>, modelRef: (slot: 'generate') => ModelRef, notify: Notifier, t: Translate, options: {
+  targetChars: number;
+  defaultKind: string;
+}): Promise<void>;
+//#endregion
+//# sourceMappingURL=split.d.ts.map

package/dist/integrations/composite-ai/split.js

@@ -0,0 +1,187 @@
+import { AI_LIMITS } from "../../features/ai/protocol/tasks.js";
+import { parseBlocks } from "../../core/pipeline.js";
+import { captureRange, releaseRanges, resolveRange } from "../../core/doc-anchors.js";
+import { TITLE_HIDDEN_KEY } from "../../features/composites/meta-keys.js";
+import { bodyMarkdown } from "../../features/composites/derivation.js";
+import { groupHeadingsIntoComposites } from "../../features/composites/heading-composites.js";
+import { compositeKindsOf } from "../../features/composites/nodes.js";
+import { notifyAiRateLimited } from "../../features/ai/rate-limit.js";
+import { postAiSse } from "../../features/ai/ai-sse.js";
+import { childKindFor } from "../../features/composites/split.js";
+import { Fragment } from "@tiptap/pm/model";
+//#region src/integrations/composite-ai/split.ts
+const HEADING_LINE = /^#{1,6}\s/;
+const collapse = (text) => text.replace(/\s+/g, " ").trim();
+/**
+* Whether the model only inserted headings: `result` without its heading lines equals `original` with whitespace
+* collapsed (so line breaks and blank lines may differ, words may not). Heading lines the original already has stay
+* part of the comparison, so the model cannot drop or rewrite them.
+*/
+function bodyUnchanged(original, result) {
+	const own = /* @__PURE__ */ new Map();
+	for (const line of original.split("\n")) {
+		if (!HEADING_LINE.test(line)) continue;
+		const key = collapse(line);
+		own.set(key, (own.get(key) ?? 0) + 1);
+	}
+	const kept = result.split("\n").filter((line) => {
+		if (!HEADING_LINE.test(line)) return true;
+		const key = collapse(line);
+		const left = own.get(key) ?? 0;
+		if (!left) return false;
+		own.set(key, left - 1);
+		return true;
+	});
+	return collapse(kept.join("\n")) === collapse(original);
+}
+/**
+* The nodes that replace `composite` when the model's result (`blocks`, the result Markdown as blocks, with headings
+* inserted) is split at those headings, or `null` when it yields fewer than two parts. Every part gets the model's
+* heading as a hidden title (`meta.titleHidden`), no block id.
+*
+* - `children`: one node, the composite with the blocks before the first heading followed by one sub-Baustein of
+*   `kind` per heading.
+* - `siblings`: the composite keeps the blocks before the first heading (without any, the body of the first heading
+*   group, its heading is dropped); every further heading group becomes a following sibling of the composite's own kind.
+*
+* The headings of the result are level 2, so only the lowest level present is grouped (`groupHeadingsIntoComposites`,
+* not recursive).
+*/
+function splitByInsertedHeadings(schema, composite, blocks, mode, kind) {
+	let minLevel = Infinity;
+	for (const block of blocks) if (block.type.name === "heading") minLevel = Math.min(minLevel, block.attrs.level);
+	if (minLevel === Infinity) return null;
+	const preambleLength = blocks.findIndex((block) => block.type.name === "heading" && block.attrs.level === minLevel);
+	const grouped = groupHeadingsIntoComposites(schema, blocks, false, kind);
+	if (!grouped) return null;
+	const preamble = grouped.slice(0, preambleLength);
+	const parts = grouped.slice(preambleLength).map((part) => part.type.create({
+		...part.attrs,
+		meta: {
+			...part.attrs.meta,
+			[TITLE_HIDDEN_KEY]: true
+		}
+	}, part.content));
+	if ((preamble.length ? 1 : 0) + parts.length < 2) return null;
+	const chrome = [];
+	composite.forEach((child, _offset, index) => {
+		if (index < 3) chrome.push(child);
+	});
+	const withBody = (body) => composite.copy(Fragment.from([...chrome, ...body]));
+	if (mode === "children") return [withBody([...preamble, ...parts])];
+	if (preamble.length) return [withBody(preamble), ...parts];
+	const [first, ...rest] = parts;
+	const firstBody = [];
+	first.forEach((child, _offset, index) => {
+		if (index >= 3) firstBody.push(child);
+	});
+	return [withBody(firstBody), ...rest];
+}
+/**
+* „Mit KI teilen“: asks the model to insert `##` headings into the body of the Baustein at `pos` (task `split-block`,
+* `targetChars` as the wanted section size, `generate` slot) and splits the body at them, in `mode`:
+* `children` makes sub-Bausteine, `siblings` makes following Bausteine of the same kind. The model may only insert
+* headings: when the text minus those headings is not the original body (`bodyUnchanged`) nothing is written and a
+* warning is shown. The Baustein is anchored while the model runs; edits to its body meanwhile discard the result.
+* The write is one transaction. `defaultKind` is the setting `blocks.defaultKind` (see `childKindFor`). Notices go
+* through `notify`, in the language of `t`.
+*/
+async function splitCompositeWithAi(editor, pos, mode, ai, modelRef, notify, t, options) {
+	const composite = editor.state.doc.nodeAt(pos);
+	if (composite?.type.name !== "composite") return;
+	const original = bodyMarkdown(editor, composite);
+	if (!original.trim()) return;
+	const kind = mode === "children" ? childKindFor(compositeKindsOf(editor), String(composite.attrs.kind), options.defaultKind) : String(composite.attrs.kind);
+	if (!kind) {
+		notify({
+			title: t("integrations.compositeSplit.notPossible"),
+			kind: "error"
+		});
+		return;
+	}
+	if (original.length > AI_LIMITS.selection) {
+		notify({
+			title: t("integrations.compositeSplit.tooLong"),
+			kind: "error"
+		});
+		return;
+	}
+	const anchor = captureRange(editor, {
+		from: pos,
+		to: pos + composite.nodeSize
+	}, { startInside: true });
+	const toastId = `split-${anchor.id}`;
+	const controller = new AbortController();
+	const abort = () => controller.abort();
+	editor.on("destroy", abort);
+	notify({
+		id: toastId,
+		title: t("integrations.compositeSplit.running"),
+		kind: "info",
+		icon: "i-lucide-loader-circle",
+		duration: 0
+	});
+	let output = "";
+	try {
+		const outcome = await postAiSse(ai, "generate", {
+			task: "split-block",
+			prompt: String(options.targetChars),
+			selection: original,
+			context: "",
+			model: modelRef("generate")
+		}, {
+			signal: controller.signal,
+			t,
+			onDelta: (text) => {
+				output += text;
+			}
+		});
+		if (outcome.status === "aborted" || editor.isDestroyed) return;
+		if (outcome.status === "rate-limited") {
+			notifyAiRateLimited(notify, t);
+			return;
+		}
+		if (outcome.status === "error") {
+			notify({
+				title: t("integrations.compositeSplit.failed"),
+				description: outcome.message,
+				kind: "error"
+			});
+			return;
+		}
+		if (!bodyUnchanged(original, output)) {
+			notify({
+				title: t("integrations.compositeSplit.changed"),
+				kind: "warning"
+			});
+			return;
+		}
+		const range = resolveRange(editor.state, anchor);
+		const current = range && editor.state.doc.nodeAt(range.from);
+		if (!range || current?.type.name !== "composite" || range.from + current.nodeSize !== range.to || bodyMarkdown(editor, current) !== original) {
+			notify({
+				title: t("integrations.compositeSplit.gone"),
+				kind: "error"
+			});
+			return;
+		}
+		const { schema } = editor;
+		const replacement = splitByInsertedHeadings(schema, current, parseBlocks(editor, output).blocks.map((block) => schema.nodeFromJSON(block)), mode, kind);
+		if (!replacement) {
+			notify({
+				title: t("integrations.compositeSplit.notPossible"),
+				kind: "error"
+			});
+			return;
+		}
+		editor.view.dispatch(editor.state.tr.replaceWith(range.from, range.to, replacement));
+	} finally {
+		notify.dismiss?.(toastId);
+		editor.off("destroy", abort);
+		releaseRanges(editor, [anchor]);
+	}
+}
+//#endregion
+export { bodyUnchanged, splitByInsertedHeadings, splitCompositeWithAi };
+
+//# sourceMappingURL=split.js.map