@ecsplico/editor 3.1.1 → 3.3.0

package/dist/features/composites/split.js

@@ -0,0 +1,172 @@
+import { EDITOR_SETTINGS_DEFAULTS } from "../../settings/index.js";
+import { kindAccepts } from "./kinds.js";
+import { TITLE_HIDDEN_KEY } from "./meta-keys.js";
+import { compositeAround, compositeKindsOf } from "./nodes.js";
+import { Extension } from "@tiptap/core";
+import { TextSelection } from "@tiptap/pm/state";
+import { Fragment } from "@tiptap/pm/model";
+//#region src/features/composites/split.ts
+/** Longest generated title; a longer first sentence is cut and ends in `…`. */
+const TITLE_MAX_CHARS = 60;
+/**
+* Groups `blocks` in order so that no group exceeds `targetChars` text characters, never splitting inside a block: a
+* new group starts when adding the block would exceed the target and the group is not empty, so a single block longer
+* than the target forms a group of its own.
+*/
+function splitBodyByLength(blocks, targetChars) {
+	const groups = [];
+	let current = [];
+	let size = 0;
+	for (const block of blocks) {
+		const chars = block.textContent.length;
+		if (current.length && size + chars > targetChars) {
+			groups.push(current);
+			current = [];
+			size = 0;
+		}
+		current.push(block);
+		size += chars;
+	}
+	if (current.length) groups.push(current);
+	return groups;
+}
+/** Text of the first non-empty textblock in `blocks` (nested ones included), or ''. */
+function firstText(blocks) {
+	let found = "";
+	for (const block of blocks) {
+		if (block.isTextblock) found = block.textContent.trim();
+		else block.descendants((node) => {
+			if (found) return false;
+			if (node.isTextblock) found = node.textContent.trim();
+			return !node.isTextblock;
+		});
+		if (found) return found;
+	}
+	return "";
+}
+/**
+* Title for a part holding `blocks`: the first sentence of its first textblock (up to the first `.`, `!` or `?` that
+* is followed by white space or ends the text; the mark itself is left out), at most 60 characters, `…` appended when
+* cut. '' when the blocks hold no text.
+*/
+function generatedTitle(blocks) {
+	const text = firstText(blocks).replace(/\s+/g, " ");
+	const end = text.search(/[.!?](?=\s|$)/);
+	const sentence = (end === -1 ? text : text.slice(0, end)).trim();
+	return sentence.length > TITLE_MAX_CHARS ? `${sentence.slice(0, TITLE_MAX_CHARS).trimEnd()}…` : sentence;
+}
+/**
+* Kind of the sub-Bausteine a split of a `parentKind` Baustein creates: `defaultKind` when the parent accepts it, else
+* the parent's own kind when it accepts itself, else null (the split is refused).
+*/
+function childKindFor(kinds, parentKind, defaultKind) {
+	if (kindAccepts(kinds, parentKind, defaultKind)) return defaultKind;
+	if (kindAccepts(kinds, parentKind, parentKind)) return parentKind;
+	return null;
+}
+function chromeOf(composite) {
+	const chrome = [];
+	for (let i = 0; i < 3; i++) chrome.push(composite.child(i));
+	return chrome;
+}
+function bodyOf(composite) {
+	const body = [];
+	composite.forEach((child, _offset, index) => {
+		if (index >= 3) body.push(child);
+	});
+	return body;
+}
+/** A new Baustein of `kind` holding `group`, titled by `generatedTitle(group)`. */
+function newPart(schema, kind, group, hideTitle) {
+	const { nodes } = schema;
+	const title = generatedTitle(group);
+	return nodes.composite.create({
+		kind,
+		meta: hideTitle ? { [TITLE_HIDDEN_KEY]: true } : {}
+	}, [
+		nodes.compositeTitle.create(null, title ? schema.text(title) : null),
+		nodes.compositeDescription.create(),
+		nodes.compositeTags.create(),
+		...group.length ? group : [nodes.paragraph.create()]
+	]);
+}
+/**
+* The nodes that replace `composite` once its body is cut into `groups` (in order, each non-empty).
+* - `children`: one node, `composite` with its own title, description, tags and meta whose body is one new Baustein of
+*   `childKind` per group.
+* - `siblings`: `composite` itself keeping the first group, then one new Baustein of the same kind per further group.
+* New parts carry a generated title, hidden when `hideTitles`, and no block id.
+*/
+function splitComposite(schema, composite, groups, mode, childKind, hideTitles) {
+	const chrome = chromeOf(composite);
+	if (mode === "children") return [composite.copy(Fragment.from([...chrome, ...groups.map((group) => newPart(schema, childKind, group, hideTitles))]))];
+	const [first = [], ...rest] = groups;
+	return [composite.copy(Fragment.from([...chrome, ...first.length ? first : [schema.nodes.paragraph.create()]])), ...rest.map((group) => newPart(schema, composite.attrs.kind, group, hideTitles))];
+}
+/** The composite whose content starts at `pos` in `state`, or the caret's innermost one when `pos` is undefined. */
+function targetComposite(state, pos) {
+	if (pos === void 0) return compositeAround(state.selection.$head);
+	const node = state.doc.nodeAt(pos);
+	return node?.type.name === "composite" ? {
+		pos,
+		node
+	} : null;
+}
+/** Position right in front of the body of `composite`, which starts at `pos`. */
+function bodyStartOf(pos, composite) {
+	return pos + 1 + chromeOf(composite).reduce((size, child) => size + child.nodeSize, 0);
+}
+/** Position in front of the body of the last part among `nodes`, which replaced a composite starting at `pos`. */
+function lastPartBodyStart(pos, nodes, mode) {
+	if (mode === "children") {
+		const parent = nodes[0];
+		const last = parent.lastChild;
+		return bodyStartOf(pos + parent.nodeSize - 1 - last.nodeSize, last);
+	}
+	const last = nodes[nodes.length - 1];
+	return bodyStartOf(pos + nodes.reduce((size, node) => size + node.nodeSize, 0) - last.nodeSize, last);
+}
+/** Client-only, no schema: the split commands of Bausteine. */
+const CompositeSplit = Extension.create({
+	name: "compositeSplit",
+	addOptions: () => ({
+		defaultKind: () => EDITOR_SETTINGS_DEFAULTS.blocks.defaultKind,
+		targetChars: () => EDITOR_SETTINGS_DEFAULTS.blocks.splitTargetChars
+	}),
+	addCommands() {
+		/** The kind of the sub-Bausteine (`children`) or of the composite itself (`siblings`); null when a `children` split has no accepted kind. */
+		const partKind = (composite, mode) => mode === "siblings" ? composite.attrs.kind : childKindFor(compositeKindsOf(this.editor), composite.attrs.kind, this.options.defaultKind());
+		return {
+			splitCompositeAtCaret: ({ mode }) => ({ state, tr, dispatch }) => {
+				const { $head } = state.selection;
+				const found = compositeAround($head);
+				if (!found) return false;
+				const index = $head.index(found.depth) - 3;
+				if (index < 1) return false;
+				const kind = partKind(found.node, mode);
+				if (kind === null) return false;
+				if (dispatch) {
+					const body = bodyOf(found.node);
+					const nodes = splitComposite(state.schema, found.node, [body.slice(0, index), body.slice(index)], mode, kind, true);
+					tr.replaceWith(found.pos, found.pos + found.node.nodeSize, nodes);
+					tr.setSelection(TextSelection.near(tr.doc.resolve(lastPartBodyStart(found.pos, nodes, mode))));
+				}
+				return true;
+			},
+			splitCompositeByLength: ({ mode, targetChars, pos }) => ({ state, tr, dispatch }) => {
+				const found = targetComposite(state, pos);
+				if (!found) return false;
+				const groups = splitBodyByLength(bodyOf(found.node), targetChars ?? this.options.targetChars());
+				if (groups.length < 2) return false;
+				const kind = partKind(found.node, mode);
+				if (kind === null) return false;
+				if (dispatch) tr.replaceWith(found.pos, found.pos + found.node.nodeSize, splitComposite(state.schema, found.node, groups, mode, kind, true));
+				return true;
+			}
+		};
+	}
+});
+//#endregion
+export { CompositeSplit, childKindFor, generatedTitle, splitBodyByLength, splitComposite };
+
+//# sourceMappingURL=split.js.map

package/dist/features/composites/split.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"split.js","names":[],"sources":["../../../src/features/composites/split.ts"],"sourcesContent":["// Splitting a Baustein: at the caret or by length, into sibling Bausteine or into sub-Bausteine. The pure parts\n// (`splitBodyByLength`, `generatedTitle`, `childKindFor`, `splitComposite`) know nothing about the editor; the\n// `CompositeSplit` extension wraps them into commands. Generated parts get a title from their first sentence and hide it.\nimport { Extension } from '@tiptap/core'\nimport { Fragment, type Node as PMNode, type Schema } from '@tiptap/pm/model'\nimport { type EditorState, TextSelection } from '@tiptap/pm/state'\nimport { EDITOR_SETTINGS_DEFAULTS } from '../../settings'\nimport { type CompositeKind, kindAccepts } from './kinds'\nimport { TITLE_HIDDEN_KEY } from './meta-keys'\nimport { COMPOSITE_CHROME_COUNT, compositeAround, compositeKindsOf } from './nodes'\n\n/** Where the parts of a split go: next to the split Baustein (`siblings`) or into it as sub-Bausteine (`children`). */\nexport type SplitMode = 'siblings' | 'children'\n\n/** Longest generated title; a longer first sentence is cut and ends in `…`. */\nconst TITLE_MAX_CHARS = 60\n\n/**\n * Groups `blocks` in order so that no group exceeds `targetChars` text characters, never splitting inside a block: a\n * new group starts when adding the block would exceed the target and the group is not empty, so a single block longer\n * than the target forms a group of its own.\n */\nexport function splitBodyByLength(blocks: readonly PMNode[], targetChars: number): PMNode[][] {\n  const groups: PMNode[][] = []\n  let current: PMNode[] = []\n  let size = 0\n  for (const block of blocks) {\n    const chars = block.textContent.length\n    if (current.length && size + chars > targetChars) {\n      groups.push(current)\n      current = []\n      size = 0\n    }\n    current.push(block)\n    size += chars\n  }\n  if (current.length) groups.push(current)\n  return groups\n}\n\n/** Text of the first non-empty textblock in `blocks` (nested ones included), or ''. */\nfunction firstText(blocks: readonly PMNode[]): string {\n  let found = ''\n  for (const block of blocks) {\n    if (block.isTextblock) found = block.textContent.trim()\n    else block.descendants((node) => {\n      if (found) return false\n      if (node.isTextblock) found = node.textContent.trim()\n      return !node.isTextblock\n    })\n    if (found) return found\n  }\n  return ''\n}\n\n/**\n * Title for a part holding `blocks`: the first sentence of its first textblock (up to the first `.`, `!` or `?` that\n * is followed by white space or ends the text; the mark itself is left out), at most 60 characters, `…` appended when\n * cut. '' when the blocks hold no text.\n */\nexport function generatedTitle(blocks: readonly PMNode[]): string {\n  const text = firstText(blocks).replace(/\\s+/g, ' ')\n  const end = text.search(/[.!?](?=\\s|$)/)\n  const sentence = (end === -1 ? text : text.slice(0, end)).trim()\n  return sentence.length > TITLE_MAX_CHARS ? `${sentence.slice(0, TITLE_MAX_CHARS).trimEnd()}…` : sentence\n}\n\n/**\n * Kind of the sub-Bausteine a split of a `parentKind` Baustein creates: `defaultKind` when the parent accepts it, else\n * the parent's own kind when it accepts itself, else null (the split is refused).\n */\nexport function childKindFor(kinds: readonly CompositeKind[], parentKind: string, defaultKind: string): string | null {\n  if (kindAccepts(kinds, parentKind, defaultKind)) return defaultKind\n  if (kindAccepts(kinds, parentKind, parentKind)) return parentKind\n  return null\n}\n\nfunction chromeOf(composite: PMNode): PMNode[] {\n  const chrome: PMNode[] = []\n  for (let i = 0; i < COMPOSITE_CHROME_COUNT; i++) chrome.push(composite.child(i))\n  return chrome\n}\n\nfunction bodyOf(composite: PMNode): PMNode[] {\n  const body: PMNode[] = []\n  composite.forEach((child, _offset, index) => {\n    if (index >= COMPOSITE_CHROME_COUNT) body.push(child)\n  })\n  return body\n}\n\n/** A new Baustein of `kind` holding `group`, titled by `generatedTitle(group)`. */\nfunction newPart(schema: Schema, kind: string, group: readonly PMNode[], hideTitle: boolean): PMNode {\n  const { nodes } = schema\n  const title = generatedTitle(group)\n  return nodes.composite!.create({ kind, meta: hideTitle ? { [TITLE_HIDDEN_KEY]: true } : {} }, [\n    nodes.compositeTitle!.create(null, title ? schema.text(title) : null),\n    nodes.compositeDescription!.create(),\n    nodes.compositeTags!.create(),\n    ...(group.length ? group : [nodes.paragraph!.create()]),\n  ])\n}\n\n/**\n * The nodes that replace `composite` once its body is cut into `groups` (in order, each non-empty).\n * - `children`: one node, `composite` with its own title, description, tags and meta whose body is one new Baustein of\n *   `childKind` per group.\n * - `siblings`: `composite` itself keeping the first group, then one new Baustein of the same kind per further group.\n * New parts carry a generated title, hidden when `hideTitles`, and no block id.\n */\nexport function splitComposite(schema: Schema, composite: PMNode, groups: readonly (readonly PMNode[])[], mode: SplitMode, childKind: string, hideTitles: boolean): PMNode[] {\n  const chrome = chromeOf(composite)\n  if (mode === 'children') return [composite.copy(Fragment.from([...chrome, ...groups.map(group => newPart(schema, childKind, group, hideTitles))]))]\n  const [first = [], ...rest] = groups\n  return [\n    composite.copy(Fragment.from([...chrome, ...(first.length ? first : [schema.nodes.paragraph!.create()])])),\n    ...rest.map(group => newPart(schema, composite.attrs.kind as string, group, hideTitles)),\n  ]\n}\n\ndeclare module '@tiptap/core' {\n  interface Commands<ReturnType> {\n    compositeSplit: {\n      /**\n       * Split the caret's innermost Baustein in front of the body block holding the caret (refused when that is the first body block or the caret is not in a body): the part before and the part from the caret on become sibling Bausteine or sub-Bausteine (`children`, of the default kind or the parent's own; refused when neither is accepted). The caret moves into the new part.\n       */\n      splitCompositeAtCaret: (options: { mode: SplitMode }) => ReturnType\n      /**\n       * Split the Baustein at `pos` (default: the caret's innermost one) into parts of about `targetChars` characters (default: setting `blocks.splitTargetChars`) without cutting inside a block. Refused with fewer than two parts, or in `children` mode when no child kind is accepted. The generated titles are hidden.\n       */\n      splitCompositeByLength: (options: { mode: SplitMode, targetChars?: number, pos?: number }) => ReturnType\n    }\n  }\n}\n\n/** Options of `CompositeSplit`: read on every use, so a changed setting applies without recreating the editor. */\nexport interface CompositeSplitOptions {\n  /** Kind of the sub-Bausteine a `children` split creates when the parent accepts it (setting `blocks.defaultKind`). */\n  defaultKind: () => string\n  /** Target size in characters of a length split (setting `blocks.splitTargetChars`). */\n  targetChars: () => number\n}\n\n/** The composite whose content starts at `pos` in `state`, or the caret's innermost one when `pos` is undefined. */\nfunction targetComposite(state: EditorState, pos: number | undefined): { pos: number, node: PMNode } | null {\n  if (pos === undefined) return compositeAround(state.selection.$head)\n  const node = state.doc.nodeAt(pos)\n  return node?.type.name === 'composite' ? { pos, node } : null\n}\n\n/** Position right in front of the body of `composite`, which starts at `pos`. */\nfunction bodyStartOf(pos: number, composite: PMNode): number {\n  return pos + 1 + chromeOf(composite).reduce((size, child) => size + child.nodeSize, 0)\n}\n\n/** Position in front of the body of the last part among `nodes`, which replaced a composite starting at `pos`. */\nfunction lastPartBodyStart(pos: number, nodes: readonly PMNode[], mode: SplitMode): number {\n  if (mode === 'children') {\n    const parent = nodes[0]!\n    const last = parent.lastChild!\n    return bodyStartOf(pos + parent.nodeSize - 1 - last.nodeSize, last)\n  }\n  const last = nodes[nodes.length - 1]!\n  return bodyStartOf(pos + nodes.reduce((size, node) => size + node.nodeSize, 0) - last.nodeSize, last)\n}\n\n/** Client-only, no schema: the split commands of Bausteine. */\nexport const CompositeSplit = Extension.create<CompositeSplitOptions>({\n  name: 'compositeSplit',\n  addOptions: () => ({\n    defaultKind: () => EDITOR_SETTINGS_DEFAULTS.blocks.defaultKind,\n    targetChars: () => EDITOR_SETTINGS_DEFAULTS.blocks.splitTargetChars,\n  }),\n  addCommands() {\n    /** The kind of the sub-Bausteine (`children`) or of the composite itself (`siblings`); null when a `children` split has no accepted kind. */\n    const partKind = (composite: PMNode, mode: SplitMode): string | null =>\n      mode === 'siblings' ? composite.attrs.kind as string : childKindFor(compositeKindsOf(this.editor), composite.attrs.kind as string, this.options.defaultKind())\n\n    return {\n      splitCompositeAtCaret: ({ mode }) => ({ state, tr, dispatch }) => {\n        const { $head } = state.selection\n        const found = compositeAround($head)\n        if (!found) return false\n        const index = $head.index(found.depth) - COMPOSITE_CHROME_COUNT\n        if (index < 1) return false\n        const kind = partKind(found.node, mode)\n        if (kind === null) return false\n        if (dispatch) {\n          const body = bodyOf(found.node)\n          const nodes = splitComposite(state.schema, found.node, [body.slice(0, index), body.slice(index)], mode, kind, true)\n          tr.replaceWith(found.pos, found.pos + found.node.nodeSize, nodes)\n          tr.setSelection(TextSelection.near(tr.doc.resolve(lastPartBodyStart(found.pos, nodes, mode))))\n        }\n        return true\n      },\n\n      splitCompositeByLength: ({ mode, targetChars, pos }) => ({ state, tr, dispatch }) => {\n        const found = targetComposite(state, pos)\n        if (!found) return false\n        const groups = splitBodyByLength(bodyOf(found.node), targetChars ?? this.options.targetChars())\n        if (groups.length < 2) return false\n        const kind = partKind(found.node, mode)\n        if (kind === null) return false\n        if (dispatch) tr.replaceWith(found.pos, found.pos + found.node.nodeSize, splitComposite(state.schema, found.node, groups, mode, kind, true))\n        return true\n      },\n    }\n  },\n})\n"],"mappings":"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"}

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

@@ -9,8 +9,9 @@ import _default$5 from "./components/CompositeSummaryEditor.vue.js";
 import _default$6 from "./components/CompositeTable.vue.js";
 import _default$7 from "./components/CompositeTagsEditor.vue.js";
 import _default$8 from "./components/CompositeView.vue.js";
-import _default$9 from "./components/ReferenceView.vue.js";
-import _default$10 from "./components/SettingsEditingTab.vue.js";
+import _default$9 from "./components/FocusChip.vue.js";
+import _default$10 from "./components/ReferenceView.vue.js";
+import _default$11 from "./components/SettingsEditingTab.vue.js";
 import { useCompositeAnchors } from "./use-composite-anchors.js";
 import { CompositeRowsModel, useCompositeRows } from "./use-composite-rows.js";
 //#region src/features/composites/vue.d.ts
@@ -20,5 +21,5 @@ import { CompositeRowsModel, useCompositeRows } from "./use-composite-rows.js";
  */
 export declare function compositeFeature(options?: CompositeFeatureOptions): VueFeature;
 //#endregion
-export { _default as CompositeChrome, _default$1 as CompositeDetails, _default$2 as CompositeFieldEditor, _default$3 as CompositeInspector, type CompositeRowsModel, _default$4 as CompositeStatusMenu, _default$5 as CompositeSummaryEditor, _default$6 as CompositeTable, _default$7 as CompositeTagsEditor, _default$8 as CompositeView, _default$9 as ReferenceView, _default$10 as SettingsEditingTab, useCompositeAnchors, useCompositeRows };
+export { _default as CompositeChrome, _default$1 as CompositeDetails, _default$2 as CompositeFieldEditor, _default$3 as CompositeInspector, type CompositeRowsModel, _default$4 as CompositeStatusMenu, _default$5 as CompositeSummaryEditor, _default$6 as CompositeTable, _default$7 as CompositeTagsEditor, _default$8 as CompositeView, _default$9 as FocusChip, _default$10 as ReferenceView, _default$11 as SettingsEditingTab, useCompositeAnchors, useCompositeRows };
 //# sourceMappingURL=vue.d.ts.map

package/dist/features/composites/vue.js

@@ -8,8 +8,9 @@ import _sfc_main$4 from "./components/CompositeStatusMenu.js";
 import _sfc_main$7 from "./components/CompositeTagsEditor.js";
 import _sfc_main from "./components/CompositeChrome.js";
 import _sfc_main$8 from "./components/CompositeView.js";
-import _sfc_main$9 from "./components/ReferenceView.js";
-import _sfc_main$10 from "./components/SettingsEditingTab.js";
+import _sfc_main$9 from "./components/FocusChip.js";
+import _sfc_main$10 from "./components/ReferenceView.js";
+import _sfc_main$11 from "./components/SettingsEditingTab.js";
 import _sfc_main$3 from "./components/CompositeInspector.js";
 import _sfc_main$6 from "./components/CompositeTable.js";
 import { VueNodeViewRenderer } from "@tiptap/vue-3";
@@ -21,14 +22,15 @@ import { VueNodeViewRenderer } from "@tiptap/vue-3";
 function compositeFeature(options = {}) {
 	return compositeFeatureCore({
 		chrome: _sfc_main,
-		settingsTab: _sfc_main$10,
+		focusChip: _sfc_main$9,
+		settingsTab: _sfc_main$11,
 		nodeViews: {
 			composite: VueNodeViewRenderer(_sfc_main$8),
-			reference: VueNodeViewRenderer(_sfc_main$9)
+			reference: VueNodeViewRenderer(_sfc_main$10)
 		}
 	}, options);
 }
 //#endregion
-export { _sfc_main as CompositeChrome, _sfc_main$1 as CompositeDetails, _sfc_main$2 as CompositeFieldEditor, _sfc_main$3 as CompositeInspector, _sfc_main$4 as CompositeStatusMenu, _sfc_main$5 as CompositeSummaryEditor, _sfc_main$6 as CompositeTable, _sfc_main$7 as CompositeTagsEditor, _sfc_main$8 as CompositeView, _sfc_main$9 as ReferenceView, _sfc_main$10 as SettingsEditingTab, compositeFeature, useCompositeAnchors, useCompositeRows };
+export { _sfc_main as CompositeChrome, _sfc_main$1 as CompositeDetails, _sfc_main$2 as CompositeFieldEditor, _sfc_main$3 as CompositeInspector, _sfc_main$4 as CompositeStatusMenu, _sfc_main$5 as CompositeSummaryEditor, _sfc_main$6 as CompositeTable, _sfc_main$7 as CompositeTagsEditor, _sfc_main$8 as CompositeView, _sfc_main$9 as FocusChip, _sfc_main$10 as ReferenceView, _sfc_main$11 as SettingsEditingTab, compositeFeature, useCompositeAnchors, useCompositeRows };
 
 //# sourceMappingURL=vue.js.map

package/dist/features/composites/vue.js.map

@@ -1 +1 @@
-{"version":3,"file":"vue.js","names":["CompositeChrome","SettingsEditingTab","CompositeView","ReferenceView"],"sources":["../../../src/features/composites/vue.ts"],"sourcesContent":["import { VueNodeViewRenderer } from '@tiptap/vue-3'\nimport type { Component } from 'vue'\nimport type { VueFeature } from '../../vue'\nimport CompositeChrome from './components/CompositeChrome.vue'\nimport CompositeView from './components/CompositeView.vue'\nimport ReferenceView from './components/ReferenceView.vue'\nimport SettingsEditingTab from './components/SettingsEditingTab.vue'\nimport { type CompositeFeatureOptions, compositeFeatureCore } from './feature'\n\nexport { default as CompositeChrome } from './components/CompositeChrome.vue'\nexport { default as CompositeDetails } from './components/CompositeDetails.vue'\nexport { default as CompositeFieldEditor } from './components/CompositeFieldEditor.vue'\nexport { default as CompositeInspector } from './components/CompositeInspector.vue'\nexport { default as CompositeStatusMenu } from './components/CompositeStatusMenu.vue'\nexport { default as CompositeSummaryEditor } from './components/CompositeSummaryEditor.vue'\nexport { default as CompositeTable } from './components/CompositeTable.vue'\nexport { default as CompositeTagsEditor } from './components/CompositeTagsEditor.vue'\nexport { default as CompositeView } from './components/CompositeView.vue'\nexport { default as ReferenceView } from './components/ReferenceView.vue'\nexport { default as SettingsEditingTab } from './components/SettingsEditingTab.vue'\nexport { useCompositeAnchors } from './use-composite-anchors'\nexport { type CompositeRowsModel, useCompositeRows } from './use-composite-rows'\n\n/**\n * The Vue composites feature (Nuxt UI): see `compositeFeatureCore`. The host places `CompositeTable` and\n * `CompositeInspector` beside the editor.\n */\nexport function compositeFeature(options: CompositeFeatureOptions = {}): VueFeature {\n  return compositeFeatureCore<Component>({\n    chrome: CompositeChrome,\n    settingsTab: SettingsEditingTab,\n    nodeViews: { composite: VueNodeViewRenderer(CompositeView), reference: VueNodeViewRenderer(ReferenceView) },\n  }, options)\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AA2BA,SAAgB,iBAAiB,UAAmC,CAAC,GAAe;CAClF,OAAO,qBAAgC;EACrC,QAAQA;EACR,aAAaC;EACb,WAAW;GAAE,WAAW,oBAAoBC,WAAa;GAAG,WAAW,oBAAoBC,WAAa;EAAE;CAC5G,GAAG,OAAO;AACZ"}
+{"version":3,"file":"vue.js","names":["CompositeChrome","FocusChip","SettingsEditingTab","CompositeView","ReferenceView"],"sources":["../../../src/features/composites/vue.ts"],"sourcesContent":["import { VueNodeViewRenderer } from '@tiptap/vue-3'\nimport type { Component } from 'vue'\nimport type { VueFeature } from '../../vue'\nimport CompositeChrome from './components/CompositeChrome.vue'\nimport CompositeView from './components/CompositeView.vue'\nimport FocusChip from './components/FocusChip.vue'\nimport ReferenceView from './components/ReferenceView.vue'\nimport SettingsEditingTab from './components/SettingsEditingTab.vue'\nimport { type CompositeFeatureOptions, compositeFeatureCore } from './feature'\n\nexport { default as CompositeChrome } from './components/CompositeChrome.vue'\nexport { default as CompositeDetails } from './components/CompositeDetails.vue'\nexport { default as CompositeFieldEditor } from './components/CompositeFieldEditor.vue'\nexport { default as CompositeInspector } from './components/CompositeInspector.vue'\nexport { default as CompositeStatusMenu } from './components/CompositeStatusMenu.vue'\nexport { default as CompositeSummaryEditor } from './components/CompositeSummaryEditor.vue'\nexport { default as CompositeTable } from './components/CompositeTable.vue'\nexport { default as CompositeTagsEditor } from './components/CompositeTagsEditor.vue'\nexport { default as CompositeView } from './components/CompositeView.vue'\nexport { default as FocusChip } from './components/FocusChip.vue'\nexport { default as ReferenceView } from './components/ReferenceView.vue'\nexport { default as SettingsEditingTab } from './components/SettingsEditingTab.vue'\nexport { useCompositeAnchors } from './use-composite-anchors'\nexport { type CompositeRowsModel, useCompositeRows } from './use-composite-rows'\n\n/**\n * The Vue composites feature (Nuxt UI): see `compositeFeatureCore`. The host places `CompositeTable` and\n * `CompositeInspector` beside the editor.\n */\nexport function compositeFeature(options: CompositeFeatureOptions = {}): VueFeature {\n  return compositeFeatureCore<Component>({\n    chrome: CompositeChrome,\n    focusChip: FocusChip,\n    settingsTab: SettingsEditingTab,\n    nodeViews: { composite: VueNodeViewRenderer(CompositeView), reference: VueNodeViewRenderer(ReferenceView) },\n  }, options)\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;AA6BA,SAAgB,iBAAiB,UAAmC,CAAC,GAAe;CAClF,OAAO,qBAAgC;EACrC,QAAQA;EACR,WAAWC;EACX,aAAaC;EACb,WAAW;GAAE,WAAW,oBAAoBC,WAAa;GAAG,WAAW,oBAAoBC,YAAa;EAAE;CAC5G,GAAG,OAAO;AACZ"}

package/dist/features/transfer/components/TransferMenu.js

@@ -0,0 +1,93 @@
+import { useUiKit } from "../../../vue/kit/use-ui-kit.js";
+import { useEditorI18n } from "../../../vue/use-editor-i18n.js";
+import { useStoreRef } from "../../../vue/store-ref.js";
+import { Fragment, computed, createBlock, createCommentVNode, createElementBlock, createElementVNode, defineComponent, normalizeStyle, onBeforeUnmount, openBlock, ref, renderList, toDisplayString, unref, watch } from "vue";
+//#region src/features/transfer/components/TransferMenu.vue
+const _hoisted_1 = ["aria-label"];
+const _hoisted_2 = { class: "px-2 py-1 text-xs text-[var(--sk-muted)]" };
+/**
+* The transform menu of a Shift-drop (mounted by the transfer feature): opens at the drop point while a drop waits in
+* `editor.storage.blockDropTarget.pending`, lists the transforms available for it and runs the one picked. Escape or a
+* click elsewhere cancels the drop.
+*/
+const ITEM_HEIGHT = 32;
+const MENU_WIDTH = 240;
+const EDGE = 8;
+const _sfc_main = /*@__PURE__*/ defineComponent({
+	__name: "TransferMenu",
+	props: { editor: {} },
+	setup(__props) {
+		const props = __props;
+		const { Button: UButton } = useUiKit();
+		const { t } = useEditorI18n();
+		const storage = props.editor.storage.blockDropTarget;
+		const pending = useStoreRef(storage.pending);
+		const transforms = computed(() => pending.value ? storage.available(pending.value) : []);
+		const label = (transform) => transform.labelKey ? t(transform.labelKey) : transform.label;
+		/** The menu's top-left corner: at the drop point, kept inside the viewport. */
+		const style = computed(() => {
+			const drop = pending.value;
+			if (!drop) return {};
+			const height = transforms.value.length * ITEM_HEIGHT + ITEM_HEIGHT + 16;
+			const left = Math.max(EDGE, Math.min(drop.x, window.innerWidth - MENU_WIDTH - EDGE));
+			const top = Math.max(EDGE, Math.min(drop.y, window.innerHeight - height - EDGE));
+			return {
+				left: `${left}px`,
+				top: `${top}px`,
+				width: `${MENU_WIDTH}px`
+			};
+		});
+		const root = ref(null);
+		const cancel = () => props.editor.commands.cancelTransfer();
+		const onKey = (event) => {
+			if (event.key !== "Escape") return;
+			event.preventDefault();
+			cancel();
+		};
+		const onPointerDown = (event) => {
+			if (!root.value?.contains(event.target)) cancel();
+		};
+		const listen = (on) => {
+			if (on) {
+				document.addEventListener("keydown", onKey, true);
+				document.addEventListener("pointerdown", onPointerDown, true);
+			} else {
+				document.removeEventListener("keydown", onKey, true);
+				document.removeEventListener("pointerdown", onPointerDown, true);
+			}
+		};
+		watch(() => pending.value !== null, listen, { immediate: true });
+		onBeforeUnmount(() => listen(false));
+		return (_ctx, _cache) => {
+			return unref(pending) ? (openBlock(), createElementBlock("div", {
+				key: 0,
+				ref_key: "root",
+				ref: root,
+				class: "fixed z-50 rounded-lg border border-[var(--sk-border)] bg-[var(--sk-bg)] p-1 shadow-lg",
+				style: normalizeStyle(style.value),
+				role: "menu",
+				"aria-label": unref(t)("transfer.menu.title")
+			}, [createElementVNode("p", _hoisted_2, toDisplayString(unref(t)("transfer.menu.title")), 1), (openBlock(true), createElementBlock(Fragment, null, renderList(transforms.value, (transform) => {
+				return openBlock(), createBlock(unref(UButton), {
+					key: transform.id,
+					class: "w-full justify-start",
+					size: "sm",
+					color: "neutral",
+					variant: "ghost",
+					role: "menuitem",
+					icon: transform.icon,
+					label: label(transform),
+					onClick: ($event) => unref(storage).run(transform.id, unref(pending))
+				}, null, 8, [
+					"icon",
+					"label",
+					"onClick"
+				]);
+			}), 128))], 12, _hoisted_1)) : createCommentVNode("v-if", true);
+		};
+	}
+});
+//#endregion
+export { _sfc_main as default };
+
+//# sourceMappingURL=TransferMenu.js.map

package/dist/features/transfer/components/TransferMenu.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TransferMenu.js","names":["_unref","_openBlock","_createElementBlock","_normalizeStyle","_createElementVNode","_toDisplayString","_Fragment","_renderList","_createBlock","_createCommentVNode"],"sources":["../../../../src/features/transfer/components/TransferMenu.vue"],"sourcesContent":["<script setup lang=\"ts\">\nimport type { Editor } from '@tiptap/vue-3'\nimport { computed, onBeforeUnmount, ref, watch } from 'vue'\nimport { useStoreRef } from '../../../vue/store-ref'\nimport { useUiKit } from '../../../vue/kit/use-ui-kit'\nimport { useEditorI18n } from '../../../vue/use-editor-i18n'\nimport type { BlockTransform } from '../transforms'\n\n/**\n * The transform menu of a Shift-drop (mounted by the transfer feature): opens at the drop point while a drop waits in\n * `editor.storage.blockDropTarget.pending`, lists the transforms available for it and runs the one picked. Escape or a\n * click elsewhere cancels the drop.\n */\nconst props = defineProps<{ editor: Editor }>()\n\nconst { Button: UButton } = useUiKit()\nconst { t } = useEditorI18n()\n\nconst storage = props.editor.storage.blockDropTarget!\nconst pending = useStoreRef(storage.pending)\n\nconst ITEM_HEIGHT = 32\nconst MENU_WIDTH = 240\nconst EDGE = 8\n\nconst transforms = computed<BlockTransform[]>(() => (pending.value ? storage.available(pending.value) : []))\nconst label = (transform: BlockTransform) => (transform.labelKey ? t(transform.labelKey) : transform.label)\n\n/** The menu's top-left corner: at the drop point, kept inside the viewport. */\nconst style = computed(() => {\n  const drop = pending.value\n  if (!drop) return {}\n  const height = transforms.value.length * ITEM_HEIGHT + ITEM_HEIGHT + 2 * EDGE\n  const left = Math.max(EDGE, Math.min(drop.x, window.innerWidth - MENU_WIDTH - EDGE))\n  const top = Math.max(EDGE, Math.min(drop.y, window.innerHeight - height - EDGE))\n  return { left: `${left}px`, top: `${top}px`, width: `${MENU_WIDTH}px` }\n})\n\nconst root = ref<HTMLElement | null>(null)\nconst cancel = () => props.editor.commands.cancelTransfer()\nconst onKey = (event: KeyboardEvent) => {\n  if (event.key !== 'Escape') return\n  event.preventDefault()\n  cancel()\n}\nconst onPointerDown = (event: PointerEvent) => {\n  if (!root.value?.contains(event.target as Node)) cancel()\n}\nconst listen = (on: boolean) => {\n  if (on) {\n    document.addEventListener('keydown', onKey, true)\n    document.addEventListener('pointerdown', onPointerDown, true)\n  }\n  else {\n    document.removeEventListener('keydown', onKey, true)\n    document.removeEventListener('pointerdown', onPointerDown, true)\n  }\n}\nwatch(() => pending.value !== null, listen, { immediate: true })\nonBeforeUnmount(() => listen(false))\n</script>\n\n<template>\n  <div\n    v-if=\"pending\"\n    ref=\"root\"\n    class=\"fixed z-50 rounded-lg border border-[var(--sk-border)] bg-[var(--sk-bg)] p-1 shadow-lg\"\n    :style=\"style\"\n    role=\"menu\"\n    :aria-label=\"t('transfer.menu.title')\"\n  >\n    <p class=\"px-2 py-1 text-xs text-[var(--sk-muted)]\">{{ t('transfer.menu.title') }}</p>\n    <UButton\n      v-for=\"transform in transforms\"\n      :key=\"transform.id\"\n      class=\"w-full justify-start\"\n      size=\"sm\"\n      color=\"neutral\"\n      variant=\"ghost\"\n      role=\"menuitem\"\n      :icon=\"transform.icon\"\n      :label=\"label(transform)\"\n      @click=\"storage.run(transform.id, pending)\"\n    />\n  </div>\n</template>\n"],"mappings":";;;;;;;;;;;;AAqBA,MAAM,cAAc;AACpB,MAAM,aAAa;AACnB,MAAM,OAAO;;;;;EAVb,MAAM,QAAQ;EAEd,MAAM,EAAE,QAAQ,YAAY,SAAS;EACrC,MAAM,EAAE,MAAM,cAAc;EAE5B,MAAM,UAAU,MAAM,OAAO,QAAQ;EACrC,MAAM,UAAU,YAAY,QAAQ,OAAO;EAM3C,MAAM,aAAa,eAAkC,QAAQ,QAAQ,QAAQ,UAAU,QAAQ,KAAK,IAAI,CAAC,CAAE;EAC3G,MAAM,SAAS,cAA+B,UAAU,WAAW,EAAE,UAAU,QAAQ,IAAI,UAAU;;EAGrG,MAAM,QAAQ,eAAe;GAC3B,MAAM,OAAO,QAAQ;GACrB,IAAI,CAAC,MAAM,OAAO,CAAC;GACnB,MAAM,SAAS,WAAW,MAAM,SAAS,cAAc,cAAc;GACrE,MAAM,OAAO,KAAK,IAAI,MAAM,KAAK,IAAI,KAAK,GAAG,OAAO,aAAa,aAAa,IAAI,CAAC;GACnF,MAAM,MAAM,KAAK,IAAI,MAAM,KAAK,IAAI,KAAK,GAAG,OAAO,cAAc,SAAS,IAAI,CAAC;GAC/E,OAAO;IAAE,MAAM,GAAG,KAAK;IAAK,KAAK,GAAG,IAAI;IAAK,OAAO,GAAG,WAAW;GAAI;EACxE,CAAC;EAED,MAAM,OAAO,IAAwB,IAAI;EACzC,MAAM,eAAe,MAAM,OAAO,SAAS,eAAe;EAC1D,MAAM,SAAS,UAAyB;GACtC,IAAI,MAAM,QAAQ,UAAU;GAC5B,MAAM,eAAe;GACrB,OAAO;EACT;EACA,MAAM,iBAAiB,UAAwB;GAC7C,IAAI,CAAC,KAAK,OAAO,SAAS,MAAM,MAAc,GAAG,OAAO;EAC1D;EACA,MAAM,UAAU,OAAgB;GAC9B,IAAI,IAAI;IACN,SAAS,iBAAiB,WAAW,OAAO,IAAI;IAChD,SAAS,iBAAiB,eAAe,eAAe,IAAI;GAC9D,OACK;IACH,SAAS,oBAAoB,WAAW,OAAO,IAAI;IACnD,SAAS,oBAAoB,eAAe,eAAe,IAAI;GACjE;EACF;EACA,YAAY,QAAQ,UAAU,MAAM,QAAQ,EAAE,WAAW,KAAK,CAAC;EAC/D,sBAAsB,OAAO,KAAK,CAAC;;GAKzB,OAAAA,MAAA,OAAA,KADRC,UAAA,GAAAC,mBAqBM,OAAA;;IAnBA,SAAA;IAAJ,KAAI;IACJ,OAAM;IACL,OAAKC,eAAE,MAAA,KAAK;IACb,MAAK;IACJ,cAAYH,MAAA,CAAA,CAAC,CAAA,qBAAA;GAEd,GAAA,CAAAI,mBAAsF,KAAtF,YAAsFC,gBAA/BL,MAAA,CAAA,CAAC,CAAA,qBAAA,CAAA,GAAA,CAAA,IACxDC,UAAA,IAAA,GAAAC,mBAWEI,UAAA,MAAAC,WAVoB,WAAA,QAAb,cAAS;IADlB,OAAAN,UAAA,GAAAO,YAWER,MAAA,OAAA,GAAA;KATC,KAAK,UAAU;KAChB,OAAM;KACN,MAAK;KACL,OAAM;KACN,SAAQ;KACR,MAAK;KACJ,MAAM,UAAU;KAChB,OAAO,MAAM,SAAS;KACtB,UAAK,WAAEA,MAAA,OAAA,CAAO,CAAC,IAAI,UAAU,IAAIA,MAAA,OAAA,CAAO"}

package/dist/features/transfer/components/TransferMenu.vue.d.ts

@@ -0,0 +1,15 @@
+import { Editor } from "@tiptap/vue-3";
+//#region src/features/transfer/components/TransferMenu.vue.d.ts
+/**
+ * The transform menu of a Shift-drop (mounted by the transfer feature): opens at the drop point while a drop waits in
+ * `editor.storage.blockDropTarget.pending`, lists the transforms available for it and runs the one picked. Escape or a
+ * click elsewhere cancels the drop.
+ */
+type __VLS_Props = {
+  editor: Editor;
+};
+declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const _default: typeof __VLS_export;
+//#endregion
+export { _default as default };
+//# sourceMappingURL=TransferMenu.vue.d.ts.map

package/dist/features/transfer/feature.d.ts

@@ -0,0 +1,76 @@
+import { Store } from "../../core/store.js";
+import { EditorFeature } from "../../core/feature.js";
+import { BlockTransfer } from "../../core/block-transfer.js";
+import "../../core/index.js";
+import { BlockTransform } from "./transforms.js";
+import { Node } from "@tiptap/pm/model";
+//#region src/features/transfer/feature.d.ts
+/** One drop of a block: the dragged block, where it lands (document position), whether the transform menu opens first and where it opens (viewport pixels). */
+export interface TransferDrop {
+  payload: BlockTransfer;
+  pos: number;
+  /** `true`: the menu opens at (`x`, `y`) and the user picks the transform; `false`: the default transform runs. */
+  menu: boolean;
+  x: number;
+  y: number;
+}
+/** A drop waiting for the user to pick a transform from the menu (`TransferDrop` with `menu` on). */
+export type PendingDrop = TransferDrop;
+export interface BlockDropTargetStorage {
+  /** The drop the transform menu is open for; `null` while no menu is open. */
+  pending: Store<PendingDrop | null>;
+  /** The transforms the menu offers for `drop` (those whose `available` says yes). */
+  available: (drop: PendingDrop) => BlockTransform[];
+  /** Closes the menu and runs the transform `id` for `drop` (a refused insert shows its notice). */
+  run: (id: string, drop: PendingDrop) => Promise<void>;
+}
+declare module '@tiptap/core' {
+  interface Storage {
+    /** Absent in an editor without the transfer feature. */
+    blockDropTarget?: BlockDropTargetStorage;
+  }
+  interface Commands<ReturnType> {
+    blockTransfer: {
+      /**
+       * Puts the block of `payload` into the document at `pos` (a position where a block may be inserted): with `menu`
+       * the transform menu opens at (`x`, `y`) and the transform the user picks runs, else the default transform runs.
+       * Refuses a drop of a block onto its own position in the same document (notice). Used by the document tree's drop executor.
+       */
+      transferBlock: (options: {
+        payload: BlockTransfer;
+        pos: number;
+        menu: boolean;
+        x?: number;
+        y?: number;
+      }) => ReturnType;
+      /** Closes the transform menu without inserting anything. */
+      cancelTransfer: () => ReturnType;
+    };
+  }
+}
+/**
+ * Whether dropping `payload` at `pos` of `doc` lands inside the very block it was dragged from: the payload names a
+ * block of this document (same `documentId`, a block with that id exists) and `pos` is strictly inside it.
+ */
+export declare function isSelfDrop(doc: Node, documentId: string | null | undefined, payload: BlockTransfer, pos: number): boolean;
+/** Options of `transferFeature`. */
+export interface TransferFeatureOptions {
+  /** The transforms the menu offers and a drop can run; default `[copyTransform]` (`composeEditor` adds the AI transforms of `@ecsplico/editor/integrations/composite-ai` when `ai` is on). A host list replaces the default (add built-ins explicitly). */
+  transforms?: readonly BlockTransform[];
+  /** Id of the transform a plain drop (no Shift) runs; default `copy`. */
+  defaultTransform?: string;
+}
+/** What a framework binding supplies to `transferFeatureCore`. */
+export interface TransferUi<C> {
+  /** The transform menu (receives `{ editor }`), mounted as an overlay. */
+  menu: C;
+}
+/**
+ * Block transfer between editor surfaces and document trees (the framework-free part of `transferFeature`): a block
+ * dragged out of another surface lands as a copy with fresh ids and a `meta.derivation` pointing at its source, or,
+ * with Shift held at the drop, as the result of a transform picked from a menu (the copy, and the AI transforms a host or `composeEditor` adds).
+ * Insert guards apply; the commands `transferBlock` and `cancelTransfer` serve the document tree's drops.
+ */
+export declare function transferFeatureCore<C>(ui: TransferUi<C>, options?: TransferFeatureOptions): EditorFeature<C>;
+//#endregion
+//# sourceMappingURL=feature.d.ts.map

package/dist/features/transfer/feature.js

@@ -0,0 +1,169 @@
+import { findBlockById } from "../../core/schema/block-ids.js";
+import { readBlockTransfer } from "../../core/block-transfer.js";
+import { createStore } from "../../core/store.js";
+import { DEFAULT_TRANSFORMS, availableTransforms, runTransform } from "./transforms.js";
+import { Extension } from "@tiptap/core";
+import { Plugin, PluginKey } from "@tiptap/pm/state";
+import { Fragment, Slice } from "@tiptap/pm/model";
+import { dropPoint } from "@tiptap/pm/transform";
+//#region src/features/transfer/feature.ts
+/**
+* Whether dropping `payload` at `pos` of `doc` lands inside the very block it was dragged from: the payload names a
+* block of this document (same `documentId`, a block with that id exists) and `pos` is strictly inside it.
+*/
+function isSelfDrop(doc, documentId, payload, pos) {
+	if (!payload.blockId || (payload.documentId ?? null) !== (documentId ?? null)) return false;
+	const found = findBlockById(doc, payload.blockId);
+	return !!found && pos > found.pos && pos < found.pos + found.node.nodeSize;
+}
+/**
+* The shared tail of a drop (DOM drop and `transferBlock`): refuses a self-drop, else opens the menu (`menu`) or runs
+* the default transform.
+*/
+function dropBlock(env, documentId, defaultId, pending, drop) {
+	const { payload, pos } = drop;
+	pending.set(null);
+	if (isSelfDrop(env.editor.state.doc, documentId, payload, pos)) {
+		env.notify({
+			kind: "warning",
+			title: env.t("transfer.selfDrop")
+		});
+		return;
+	}
+	if (drop.menu) pending.set(drop);
+	else queueMicrotask(() => {
+		runTransform(env, defaultId, payload, pos);
+	});
+}
+const blockDropTargetKey = new PluginKey("blockDropTarget");
+/**
+* The slice dropping `payload` would insert, for `dropPoint`; `null` when this schema cannot hold the block. It is closed
+* (`openStart` and `openEnd` 0): an open slice would let `dropPoint` return a position inside a paragraph, where the
+* Baustein cannot be inserted.
+*/
+function sliceOf(editor, payload) {
+	try {
+		return new Slice(Fragment.from(editor.schema.nodeFromJSON(payload.json)), 0, 0);
+	} catch {
+		return null;
+	}
+}
+/**
+* Takes blocks dragged out of another editor surface or document tree (`BLOCK_MIME`): a plain drop runs the default
+* transform, Shift opens the transform menu at the drop point. A drag that started in this editor stays ProseMirror's
+* native move. Also the commands `transferBlock` and `cancelTransfer`.
+*/
+function blockDropTarget(ctx, transforms, defaultId) {
+	const envOf = (editor) => ({
+		editor,
+		transforms,
+		ai: ctx.backend.ai,
+		app: ctx.app,
+		notify: ctx.notify,
+		t: ctx.t
+	});
+	let created;
+	const editorOf = () => {
+		if (!created) throw new Error("blockDropTarget: the editor is not created yet");
+		return created;
+	};
+	return Extension.create({
+		name: "blockDropTarget",
+		onBeforeCreate() {
+			created = this.editor;
+		},
+		addStorage() {
+			const pending = createStore(null);
+			return {
+				pending,
+				available: ({ payload, pos }) => availableTransforms(envOf(editorOf()), payload, pos),
+				run: async (id, { payload, pos }) => {
+					pending.set(null);
+					await runTransform(envOf(editorOf()), id, payload, pos);
+				}
+			};
+		},
+		addCommands() {
+			return {
+				transferBlock: ({ payload, pos, menu, x = 0, y = 0 }) => ({ editor, dispatch }) => {
+					if (!dispatch) return true;
+					dropBlock(envOf(editor), ctx.documentId ?? null, defaultId, this.storage.pending, {
+						payload,
+						pos: Math.min(Math.max(pos, 0), editor.state.doc.content.size),
+						menu,
+						x,
+						y
+					});
+					return true;
+				},
+				cancelTransfer: () => () => {
+					this.storage.pending.set(null);
+					return true;
+				}
+			};
+		},
+		addProseMirrorPlugins() {
+			const editor = this.editor;
+			return [new Plugin({
+				key: blockDropTargetKey,
+				props: {
+					handleDOMEvents: { dragover: (view, event) => {
+						if (view.dragging || !view.editable || !event.dataTransfer?.types.includes("application/x-tip-block")) return false;
+						event.preventDefault();
+						event.dataTransfer.dropEffect = "copy";
+						return false;
+					} },
+					handleDrop: (view, event) => {
+						if (view.dragging || !view.editable || !event.dataTransfer) return false;
+						const payload = readBlockTransfer(event.dataTransfer);
+						if (!payload) return false;
+						event.preventDefault();
+						const env = envOf(editor);
+						const slice = sliceOf(editor, payload);
+						if (!slice) {
+							env.notify({
+								kind: "warning",
+								title: env.t("transfer.refused")
+							});
+							return true;
+						}
+						const at = view.posAtCoords({
+							left: event.clientX,
+							top: event.clientY
+						})?.pos ?? view.state.doc.content.size;
+						const pos = dropPoint(view.state.doc, at, slice) ?? view.state.doc.content.size;
+						dropBlock(env, ctx.documentId ?? null, defaultId, this.storage.pending, {
+							payload,
+							pos,
+							menu: event.shiftKey,
+							x: event.clientX,
+							y: event.clientY
+						});
+						return true;
+					}
+				}
+			})];
+		}
+	});
+}
+/**
+* Block transfer between editor surfaces and document trees (the framework-free part of `transferFeature`): a block
+* dragged out of another surface lands as a copy with fresh ids and a `meta.derivation` pointing at its source, or,
+* with Shift held at the drop, as the result of a transform picked from a menu (the copy, and the AI transforms a host or `composeEditor` adds).
+* Insert guards apply; the commands `transferBlock` and `cancelTransfer` serve the document tree's drops.
+*/
+function transferFeatureCore(ui, options = {}) {
+	const transforms = options.transforms ?? DEFAULT_TRANSFORMS;
+	const defaultId = options.defaultTransform ?? "copy";
+	return {
+		id: "transfer",
+		dimension: "interaction",
+		requires: ["composites"],
+		extensions: (ctx) => [blockDropTarget(ctx, transforms, defaultId)],
+		overlays: [ui.menu]
+	};
+}
+//#endregion
+export { isSelfDrop, transferFeatureCore };
+
+//# sourceMappingURL=feature.js.map