@verbb/plugin-kit-tiptap-core 2.0.0

package/CHANGELOG.md

@@ -0,0 +1,11 @@
+# Changelog
+
+## Unreleased
+
+## 2.0.0 - 2026-07-19
+
+### Added
+- Initial public release of `@verbb/plugin-kit-tiptap-core` — shared TipTap schema, extensions, and serialization for Plugin Kit rich-text surfaces.
+
+### Changed
+- Package versions lockstep with `@verbb/plugin-kit-web` and related `@verbb/plugin-kit-*` packages at `2.0.0`.

package/LICENSE.md

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) Verbb
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,36 @@
+# `@verbb/plugin-kit-tiptap-core`
+
+Shared TipTap schema, extensions, toolbar helpers, and serialization for Plugin Kit rich-text surfaces.
+
+You normally consume TipTap through UI packages (`pk-tiptap-*` / React/Vue facades). Use this package when you need the headless helpers without mounting an editor.
+
+## Install
+
+```bash
+npm install @verbb/plugin-kit-tiptap-core
+```
+
+TipTap packages are dependencies of this package.
+
+## What you get
+
+| Area | Examples |
+|------|----------|
+| Extensions | `createTiptapExtensions`, `createTiptapInputExtensions`, variable-tag extension |
+| Serialization | `valueToContent`, `contentToValue`, normalize / empty checks |
+| Toolbar | presets, group menus, `runToolbarButton`, active-state helpers |
+| Links | Craft element / URL link helpers |
+
+Subpath exports: `./extensions`, `./toolbar`, `./links`, `./serialization/editor`, `./serialization/input`.
+
+## UI entry points
+
+| Surface | Import |
+|---------|--------|
+| Web | `@verbb/plugin-kit-web/components/tiptap-editor.js` (also `tiptap-input`, `tiptap-content`) |
+| React | `TiptapEditor`, `TiptapInput`, `TiptapContent` from `@verbb/plugin-kit-react/components` |
+| Vue | same names from `@verbb/plugin-kit-vue/components` |
+
+## Docs
+
+Component pages under [Web](https://docs.verbb.io/plugin-kit/web/components/tiptap-editor) / [React](https://docs.verbb.io/plugin-kit/react/components/tiptap-editor) / [Vue](https://docs.verbb.io/plugin-kit/vue/components/tiptap-editor).

package/dist/extensions/create-extensions.d.ts

@@ -0,0 +1,13 @@
+import { NodeViewRenderer } from '@tiptap/core';
+export type CreateTiptapExtensionsOptions = {
+    trailingCursorText?: string;
+    variableTagNodeView?: NodeViewRenderer;
+    includeVariableTag?: boolean;
+};
+export declare const createTiptapExtensions: ({ trailingCursorText, variableTagNodeView, includeVariableTag, }?: CreateTiptapExtensionsOptions) => (import('@tiptap/core').Mark<import('@tiptap/extension-link').LinkOptions, any> | import('@tiptap/core').Node<any, any> | import('@tiptap/core').Extension<import('@tiptap/extensions').DropcursorOptions, any> | import('@tiptap/core').Extension<any, any> | import('@tiptap/core').Node<import('@tiptap/extension-paragraph').ParagraphOptions, any> | import('@tiptap/core').Node<import('@tiptap/extension-hard-break').HardBreakOptions, any> | import('@tiptap/core').Mark<import('@tiptap/extension-bold').BoldOptions, any> | import('@tiptap/core').Mark<import('@tiptap/extension-highlight').HighlightOptions, any> | import('@tiptap/core').Node<import('@tiptap/extension-list').BulletListOptions, any> | import('@tiptap/core').Node<import('@tiptap/extension-code-block').CodeBlockOptions, any> | import('@tiptap/core').Node<import('@tiptap/extension-heading').HeadingOptions, any> | import('@tiptap/core').Node<import('@tiptap/extension-horizontal-rule').HorizontalRuleOptions, any> | import('@tiptap/core').Node<import('@tiptap/extension-list').ListItemOptions, any> | import('@tiptap/core').Node<import('@tiptap/extension-table').TableOptions, any> | import('@tiptap/core').Extension<import('@tiptap/extensions').UndoRedoOptions, any> | import('@tiptap/core').Extension<import('@tiptap/extension-text-align').TextAlignOptions, any>)[];
+export type CreateTiptapInputExtensionsOptions = {
+    trailingCursorText?: string;
+    variableTagNodeView?: NodeViewRenderer;
+};
+export declare const createTiptapInputExtensions: ({ trailingCursorText, variableTagNodeView, }?: CreateTiptapInputExtensionsOptions) => import('@tiptap/core').Node<any, any>[];
+//# sourceMappingURL=create-extensions.d.ts.map

package/dist/extensions/create-extensions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-extensions.d.ts","sourceRoot":"","sources":["../../src/extensions/create-extensions.ts"],"names":[],"mappings":"AA6BA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAMrD,MAAM,MAAM,6BAA6B,GAAG;IACxC,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,mBAAmB,CAAC,EAAE,gBAAgB,CAAC;IACvC,kBAAkB,CAAC,EAAE,OAAO,CAAC;CAChC,CAAC;AAEF,eAAO,MAAM,sBAAsB,GAAI,mEAIpC,6BAAkC,szCA2CpC,CAAC;AAEF,MAAM,MAAM,kCAAkC,GAAG;IAC7C,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,mBAAmB,CAAC,EAAE,gBAAgB,CAAC;CAC1C,CAAC;AAEF,eAAO,MAAM,2BAA2B,GAAI,+CAGzC,kCAAuC,4CASzC,CAAC"}

package/dist/extensions/create-extensions.js

@@ -0,0 +1,92 @@
+import { createLinkExtension } from "../links/extension.js";
+import { createVariableTagExtension } from "./variable-tag.js";
+import { OneLinerDocument } from "./one-liner-document.js";
+import Bold from "@tiptap/extension-bold";
+import Code from "@tiptap/extension-code";
+import Highlight from "@tiptap/extension-highlight";
+import Italic from "@tiptap/extension-italic";
+import Strike from "@tiptap/extension-strike";
+import Subscript from "@tiptap/extension-subscript";
+import Superscript from "@tiptap/extension-superscript";
+import Underline from "@tiptap/extension-underline";
+import Blockquote from "@tiptap/extension-blockquote";
+import BulletList from "@tiptap/extension-bullet-list";
+import CodeBlock from "@tiptap/extension-code-block";
+import Document from "@tiptap/extension-document";
+import HardBreak from "@tiptap/extension-hard-break";
+import Heading from "@tiptap/extension-heading";
+import HorizontalRule from "@tiptap/extension-horizontal-rule";
+import ListItem from "@tiptap/extension-list-item";
+import OrderedList from "@tiptap/extension-ordered-list";
+import Paragraph from "@tiptap/extension-paragraph";
+import { Table } from "@tiptap/extension-table";
+import TableCell from "@tiptap/extension-table-cell";
+import TableHeader from "@tiptap/extension-table-header";
+import TableRow from "@tiptap/extension-table-row";
+import Text from "@tiptap/extension-text";
+import Dropcursor from "@tiptap/extension-dropcursor";
+import Gapcursor from "@tiptap/extension-gapcursor";
+import History from "@tiptap/extension-history";
+import TextAlign from "@tiptap/extension-text-align";
+//#region src/extensions/create-extensions.ts
+var createTiptapExtensions = ({ trailingCursorText = "​", variableTagNodeView, includeVariableTag = true } = {}) => {
+	const extensions = [
+		Document,
+		Dropcursor,
+		Gapcursor,
+		Paragraph,
+		Text,
+		HardBreak,
+		Bold,
+		Code,
+		Highlight,
+		Italic,
+		Strike,
+		Subscript,
+		Superscript,
+		Underline,
+		Blockquote,
+		BulletList,
+		CodeBlock,
+		Heading.configure({ levels: [
+			1,
+			2,
+			3,
+			4,
+			5,
+			6
+		] }),
+		HorizontalRule,
+		ListItem,
+		OrderedList,
+		Table.configure({ resizable: true }),
+		TableRow,
+		TableHeader,
+		TableCell,
+		History,
+		createLinkExtension(),
+		TextAlign.configure({
+			types: ["heading", "paragraph"],
+			defaultAlignment: "start"
+		})
+	];
+	if (includeVariableTag) extensions.push(createVariableTagExtension({
+		trailingCursorText,
+		addNodeView: variableTagNodeView
+	}));
+	return extensions;
+};
+var createTiptapInputExtensions = ({ trailingCursorText = "​", variableTagNodeView } = {}) => {
+	return [
+		OneLinerDocument,
+		Text,
+		createVariableTagExtension({
+			trailingCursorText,
+			addNodeView: variableTagNodeView
+		})
+	];
+};
+//#endregion
+export { createTiptapExtensions, createTiptapInputExtensions };
+
+//# sourceMappingURL=create-extensions.js.map

package/dist/extensions/create-extensions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-extensions.js","names":[],"sources":["../../src/extensions/create-extensions.ts"],"sourcesContent":["import Bold from '@tiptap/extension-bold';\nimport Code from '@tiptap/extension-code';\nimport Highlight from '@tiptap/extension-highlight';\nimport Italic from '@tiptap/extension-italic';\nimport Strike from '@tiptap/extension-strike';\nimport Subscript from '@tiptap/extension-subscript';\nimport Superscript from '@tiptap/extension-superscript';\nimport Underline from '@tiptap/extension-underline';\n\nimport Blockquote from '@tiptap/extension-blockquote';\nimport BulletList from '@tiptap/extension-bullet-list';\nimport CodeBlock from '@tiptap/extension-code-block';\nimport Document from '@tiptap/extension-document';\nimport HardBreak from '@tiptap/extension-hard-break';\nimport Heading from '@tiptap/extension-heading';\nimport HorizontalRule from '@tiptap/extension-horizontal-rule';\nimport ListItem from '@tiptap/extension-list-item';\nimport OrderedList from '@tiptap/extension-ordered-list';\nimport Paragraph from '@tiptap/extension-paragraph';\nimport { Table } from '@tiptap/extension-table';\nimport TableCell from '@tiptap/extension-table-cell';\nimport TableHeader from '@tiptap/extension-table-header';\nimport TableRow from '@tiptap/extension-table-row';\nimport Text from '@tiptap/extension-text';\n\nimport Dropcursor from '@tiptap/extension-dropcursor';\nimport Gapcursor from '@tiptap/extension-gapcursor';\nimport History from '@tiptap/extension-history';\nimport TextAlign from '@tiptap/extension-text-align';\nimport type { NodeViewRenderer } from '@tiptap/core';\n\nimport { createLinkExtension } from '../links/extension.js';\nimport { createVariableTagExtension } from './variable-tag.js';\nimport { OneLinerDocument } from './one-liner-document.js';\n\nexport type CreateTiptapExtensionsOptions = {\n    trailingCursorText?: string;\n    variableTagNodeView?: NodeViewRenderer;\n    includeVariableTag?: boolean;\n};\n\nexport const createTiptapExtensions = ({\n    trailingCursorText = '\\u200B',\n    variableTagNodeView,\n    includeVariableTag = true,\n}: CreateTiptapExtensionsOptions = {}) => {\n    const extensions = [\n        Document,\n        Dropcursor,\n        Gapcursor,\n        Paragraph,\n        Text,\n        HardBreak,\n\n        Bold,\n        Code,\n        Highlight,\n        Italic,\n        Strike,\n        Subscript,\n        Superscript,\n        Underline,\n\n        Blockquote,\n        BulletList,\n        CodeBlock,\n        Heading.configure({ levels: [1, 2, 3, 4, 5, 6] }),\n        HorizontalRule,\n        ListItem,\n        OrderedList,\n        Table.configure({ resizable: true }),\n        TableRow,\n        TableHeader,\n        TableCell,\n\n        History,\n        createLinkExtension(),\n        TextAlign.configure({ types: ['heading', 'paragraph'], defaultAlignment: 'start' }),\n    ];\n\n    if (includeVariableTag) {\n        extensions.push(createVariableTagExtension({\n            trailingCursorText,\n            addNodeView: variableTagNodeView,\n        }));\n    }\n\n    return extensions;\n};\n\nexport type CreateTiptapInputExtensionsOptions = {\n    trailingCursorText?: string;\n    variableTagNodeView?: NodeViewRenderer;\n};\n\nexport const createTiptapInputExtensions = ({\n    trailingCursorText = '\\u200B',\n    variableTagNodeView,\n}: CreateTiptapInputExtensionsOptions = {}) => {\n    return [\n        OneLinerDocument,\n        Text,\n        createVariableTagExtension({\n            trailingCursorText,\n            addNodeView: variableTagNodeView,\n        }),\n    ];\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAyCA,IAAa,0BAA0B,EACnC,qBAAqB,KACrB,qBACA,qBAAqB,SACU,EAAE,KAAK;CACtC,MAAM,aAAa;EACf;EACA;EACA;EACA;EACA;EACA;EAEA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EAEA;EACA;EACA;EACA,QAAQ,UAAU,EAAE,QAAQ;GAAC;GAAG;GAAG;GAAG;GAAG;GAAG;GAAE,EAAE,CAAC;EACjD;EACA;EACA;EACA,MAAM,UAAU,EAAE,WAAW,MAAM,CAAC;EACpC;EACA;EACA;EAEA;EACA,qBAAqB;EACrB,UAAU,UAAU;GAAE,OAAO,CAAC,WAAW,YAAY;GAAE,kBAAkB;GAAS,CAAC;EACtF;AAED,KAAI,mBACA,YAAW,KAAK,2BAA2B;EACvC;EACA,aAAa;EAChB,CAAC,CAAC;AAGP,QAAO;;AAQX,IAAa,+BAA+B,EACxC,qBAAqB,KACrB,wBACoC,EAAE,KAAK;AAC3C,QAAO;EACH;EACA;EACA,2BAA2B;GACvB;GACA,aAAa;GAChB,CAAC;EACL"}

package/dist/extensions/index.d.ts

@@ -0,0 +1,6 @@
+export * from './create-extensions.js';
+export type { CreateTiptapExtensionsOptions, CreateTiptapInputExtensionsOptions } from './create-extensions.js';
+export * from './one-liner-document.js';
+export * from './variable-tag.js';
+export type { VariableTagExtensionOptions } from './variable-tag.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/extensions/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/extensions/index.ts"],"names":[],"mappings":"AAAA,cAAc,wBAAwB,CAAC;AACvC,YAAY,EAAE,6BAA6B,EAAE,kCAAkC,EAAE,MAAM,wBAAwB,CAAC;AAChH,cAAc,yBAAyB,CAAC;AACxC,cAAc,mBAAmB,CAAC;AAClC,YAAY,EAAE,2BAA2B,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/extensions/index.js

@@ -0,0 +1,4 @@
+import { createVariableTagExtension } from "./variable-tag.js";
+import { OneLinerDocument } from "./one-liner-document.js";
+import { createTiptapExtensions, createTiptapInputExtensions } from "./create-extensions.js";
+export { OneLinerDocument, createTiptapExtensions, createTiptapInputExtensions, createVariableTagExtension };

package/dist/extensions/one-liner-document.d.ts

@@ -0,0 +1,2 @@
+export declare const OneLinerDocument: import('@tiptap/core').Node<any, any>;
+//# sourceMappingURL=one-liner-document.d.ts.map

package/dist/extensions/one-liner-document.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"one-liner-document.d.ts","sourceRoot":"","sources":["../../src/extensions/one-liner-document.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,gBAAgB,uCAE3B,CAAC"}

package/dist/extensions/one-liner-document.js

@@ -0,0 +1,7 @@
+import Document from "@tiptap/extension-document";
+//#region src/extensions/one-liner-document.ts
+var OneLinerDocument = Document.extend({ content: "inline*" });
+//#endregion
+export { OneLinerDocument };
+
+//# sourceMappingURL=one-liner-document.js.map

package/dist/extensions/one-liner-document.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"one-liner-document.js","names":[],"sources":["../../src/extensions/one-liner-document.ts"],"sourcesContent":["import Document from '@tiptap/extension-document';\n\nexport const OneLinerDocument = Document.extend({\n    content: 'inline*',\n});\n"],"mappings":";;AAEA,IAAa,mBAAmB,SAAS,OAAO,EAC5C,SAAS,WACZ,CAAC"}

package/dist/extensions/variable-tag.d.ts

@@ -0,0 +1,7 @@
+import { Node, NodeViewRenderer } from '@tiptap/core';
+export type VariableTagExtensionOptions = {
+    trailingCursorText?: string;
+    addNodeView?: NodeViewRenderer;
+};
+export declare function createVariableTagExtension({ trailingCursorText, addNodeView, }?: VariableTagExtensionOptions): Node<any, any>;
+//# sourceMappingURL=variable-tag.d.ts.map

package/dist/extensions/variable-tag.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"variable-tag.d.ts","sourceRoot":"","sources":["../../src/extensions/variable-tag.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,cAAc,CAAC;AACpC,OAAO,KAAK,EAAgB,gBAAgB,EAAe,MAAM,cAAc,CAAC;AAKhF,MAAM,MAAM,2BAA2B,GAAG;IACtC,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,WAAW,CAAC,EAAE,gBAAgB,CAAC;CAClC,CAAC;AAMF,wBAAgB,0BAA0B,CAAC,EACvC,kBAA6B,EAC7B,WAAW,GACd,GAAE,2BAAgC,kBA8LlC"}

package/dist/extensions/variable-tag.js

@@ -0,0 +1,156 @@
+import { Node } from "@tiptap/core";
+import { NodeSelection, Plugin, PluginKey, TextSelection } from "@tiptap/pm/state";
+//#region src/extensions/variable-tag.ts
+var isCursorPlaceholder = (node) => {
+	return node && node.isText && (node.text === "​" || node.text === "⁠");
+};
+function createVariableTagExtension({ trailingCursorText = "​", addNodeView } = {}) {
+	return Node.create({
+		name: "variableTag",
+		group: "inline",
+		inline: true,
+		selectable: true,
+		draggable: true,
+		atom: true,
+		addOptions() {
+			return { trailingCursorText };
+		},
+		addAttributes() {
+			return {
+				label: { default: null },
+				value: { default: null },
+				openOnInsert: { default: false },
+				default: { default: null },
+				transformerId: { default: null },
+				transformerParams: { default: null },
+				unresolved: { default: false }
+			};
+		},
+		parseHTML() {
+			return [{
+				tag: "variable-tag",
+				getAttrs: (dom) => {
+					try {
+						return JSON.parse(dom.innerHTML);
+					} catch {
+						return {};
+					}
+				}
+			}];
+		},
+		renderHTML({ HTMLAttributes }) {
+			return ["variable-tag", JSON.stringify(HTMLAttributes)];
+		},
+		addCommands() {
+			return { setVariableTag: (options) => {
+				return ({ dispatch, state }) => {
+					if (!dispatch) return false;
+					const { selection } = state;
+					const textSelection = selection;
+					const position = textSelection.$cursor ? textSelection.$cursor.pos : textSelection.$to.pos;
+					const node = this.type.create(options);
+					const transaction = state.tr.insert(position, node);
+					const insertPos = position + node.nodeSize;
+					const cursorText = this.options.trailingCursorText;
+					if (cursorText) {
+						transaction.insert(insertPos, state.schema.text(cursorText));
+						transaction.setSelection(TextSelection.create(transaction.doc, insertPos + cursorText.length));
+					} else transaction.setSelection(TextSelection.create(transaction.doc, insertPos));
+					dispatch(transaction);
+					return true;
+				};
+			} };
+		},
+		addNodeView() {
+			return addNodeView ?? null;
+		},
+		addProseMirrorPlugins() {
+			return [new Plugin({
+				key: new PluginKey("variableTagProtection"),
+				props: {
+					handleKeyDown: (view, event) => {
+						const { state } = view;
+						const { selection, doc } = state;
+						if (event.key === "ArrowLeft" && selection.empty) {
+							const { $from } = selection;
+							const { pos } = $from;
+							if (pos > 0) {
+								const before = $from.nodeBefore;
+								if (isCursorPlaceholder(before)) {
+									const posBeforePlaceholder = pos - before.nodeSize;
+									const variableTagNode = doc.resolve(posBeforePlaceholder).nodeBefore;
+									if (variableTagNode && variableTagNode.type.name === "variableTag") {
+										const tagStart = posBeforePlaceholder - variableTagNode.nodeSize;
+										event.preventDefault();
+										view.dispatch(state.tr.setSelection(NodeSelection.create(doc, tagStart)));
+										return true;
+									}
+								}
+							}
+						}
+						if (event.key === "ArrowRight" && selection.empty) {
+							const { $from } = selection;
+							const { pos } = $from;
+							const after = $from.nodeAfter;
+							if (isCursorPlaceholder(after)) {
+								const before = $from.nodeBefore;
+								if (before && before.type.name === "variableTag") {
+									event.preventDefault();
+									view.dispatch(state.tr.setSelection(TextSelection.create(doc, pos + after.nodeSize)));
+									return true;
+								}
+							}
+						}
+						if (event.key === "Backspace" && selection.empty) {
+							const { $from } = selection;
+							const { pos } = $from;
+							if (pos > 0) {
+								const before = $from.nodeBefore;
+								if (isCursorPlaceholder(before)) {
+									const posBeforePlaceholder = pos - before.nodeSize;
+									const variableTagNode = doc.resolve(posBeforePlaceholder).nodeBefore;
+									if (variableTagNode && variableTagNode.type.name === "variableTag") {
+										const deleteFrom = posBeforePlaceholder - variableTagNode.nodeSize;
+										event.preventDefault();
+										const tr = state.tr.delete(deleteFrom, pos);
+										tr.setSelection(TextSelection.create(tr.doc, Math.max(0, deleteFrom)));
+										view.dispatch(tr);
+										return true;
+									}
+								}
+							}
+						}
+						if (selection instanceof NodeSelection && selection.node.type.name === "variableTag") {
+							if ([
+								"ArrowLeft",
+								"ArrowRight",
+								"ArrowUp",
+								"ArrowDown",
+								"Home",
+								"End"
+							].includes(event.key)) return false;
+							if (["Delete", "Backspace"].includes(event.key)) return false;
+							if (event.ctrlKey || event.metaKey || event.altKey || event.shiftKey) return false;
+							if (event.key.length === 1 || event.key === "Enter") return true;
+						}
+						return false;
+					},
+					handlePaste: (view) => {
+						const { selection } = view.state;
+						if (selection instanceof NodeSelection && selection.node.type.name === "variableTag") return true;
+						return false;
+					},
+					handleDrop: (view) => {
+						const { selection } = view.state;
+						if (selection instanceof NodeSelection && selection.node.type.name === "variableTag" && !view.dragging) return true;
+						return false;
+					}
+				}
+			})];
+		}
+	});
+}
+//#endregion
+export { createVariableTagExtension };
+
+//# sourceMappingURL=variable-tag.js.map

package/dist/extensions/variable-tag.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"variable-tag.js","names":[],"sources":["../../src/extensions/variable-tag.ts"],"sourcesContent":["import { Node } from '@tiptap/core';\nimport type { CommandProps, NodeViewRenderer, RawCommands } from '@tiptap/core';\nimport {\n    Plugin, PluginKey, NodeSelection, TextSelection,\n} from '@tiptap/pm/state';\n\nexport type VariableTagExtensionOptions = {\n    trailingCursorText?: string;\n    addNodeView?: NodeViewRenderer;\n};\n\nconst isCursorPlaceholder = (node: { isText?: boolean; text?: string } | null | undefined) => {\n    return node && node.isText && (node.text === '\\u200B' || node.text === '\\u2060');\n};\n\nexport function createVariableTagExtension({\n    trailingCursorText = '\\u200B',\n    addNodeView,\n}: VariableTagExtensionOptions = {}) {\n    return Node.create({\n        name: 'variableTag',\n        group: 'inline',\n        inline: true,\n        selectable: true,\n        draggable: true,\n        atom: true,\n\n        addOptions() {\n            return {\n                trailingCursorText,\n            };\n        },\n\n        addAttributes() {\n            return {\n                label: { default: null },\n                value: { default: null },\n                openOnInsert: { default: false },\n                default: { default: null },\n                transformerId: { default: null },\n                transformerParams: { default: null },\n                // Display-only: token did not match a known variable option.\n                unresolved: { default: false },\n            };\n        },\n\n        parseHTML() {\n            return [\n                {\n                    tag: 'variable-tag',\n                    getAttrs: (dom) => {\n                        try {\n                            return JSON.parse((dom as HTMLElement).innerHTML);\n                        } catch {\n                            return {};\n                        }\n                    },\n                },\n            ];\n        },\n\n        renderHTML({ HTMLAttributes }) {\n            return ['variable-tag', JSON.stringify(HTMLAttributes)];\n        },\n\n        addCommands() {\n            return {\n                setVariableTag: (options: Record<string, unknown>) => {\n                    return ({ dispatch, state }: CommandProps) => {\n                        if (!dispatch) {\n                            return false;\n                        }\n\n                        const { selection } = state;\n                        const textSelection = selection as TextSelection;\n                        const position = textSelection.$cursor ? textSelection.$cursor.pos : textSelection.$to.pos;\n                        const node = this.type.create(options);\n                        const transaction = state.tr.insert(position, node);\n                        const insertPos = position + node.nodeSize;\n                        const cursorText = this.options.trailingCursorText;\n\n                        if (cursorText) {\n                            transaction.insert(insertPos, state.schema.text(cursorText));\n                            transaction.setSelection(TextSelection.create(transaction.doc, insertPos + cursorText.length));\n                        } else {\n                            transaction.setSelection(TextSelection.create(transaction.doc, insertPos));\n                        }\n\n                        dispatch(transaction);\n                        return true;\n                    };\n                },\n            } as Partial<RawCommands>;\n        },\n\n        addNodeView() {\n            return addNodeView ?? null;\n        },\n\n        addProseMirrorPlugins() {\n            return [\n                new Plugin({\n                    key: new PluginKey('variableTagProtection'),\n\n                    props: {\n                        handleKeyDown: (view, event) => {\n                            const { state } = view;\n                            const { selection, doc } = state;\n\n                            if (event.key === 'ArrowLeft' && selection.empty) {\n                                const { $from } = selection;\n                                const { pos } = $from;\n                                if (pos > 0) {\n                                    const before = $from.nodeBefore;\n                                    if (isCursorPlaceholder(before)) {\n                                        const posBeforePlaceholder = pos - before!.nodeSize;\n                                        const $beforePlaceholder = doc.resolve(posBeforePlaceholder);\n                                        const variableTagNode = $beforePlaceholder.nodeBefore;\n                                        if (variableTagNode && variableTagNode.type.name === 'variableTag') {\n                                            const tagStart = posBeforePlaceholder - variableTagNode.nodeSize;\n                                            event.preventDefault();\n                                            view.dispatch(state.tr.setSelection(NodeSelection.create(doc, tagStart)));\n                                            return true;\n                                        }\n                                    }\n                                }\n                            }\n\n                            if (event.key === 'ArrowRight' && selection.empty) {\n                                const { $from } = selection;\n                                const { pos } = $from;\n                                const after = $from.nodeAfter;\n                                if (isCursorPlaceholder(after)) {\n                                    const before = $from.nodeBefore;\n                                    if (before && before.type.name === 'variableTag') {\n                                        event.preventDefault();\n                                        view.dispatch(state.tr.setSelection(TextSelection.create(doc, pos + after!.nodeSize)));\n                                        return true;\n                                    }\n                                }\n                            }\n\n                            if (event.key === 'Backspace' && selection.empty) {\n                                const { $from } = selection;\n                                const { pos } = $from;\n                                if (pos > 0) {\n                                    const before = $from.nodeBefore;\n                                    if (isCursorPlaceholder(before)) {\n                                        const posBeforePlaceholder = pos - before!.nodeSize;\n                                        const $beforePlaceholder = doc.resolve(posBeforePlaceholder);\n                                        const variableTagNode = $beforePlaceholder.nodeBefore;\n                                        if (variableTagNode && variableTagNode.type.name === 'variableTag') {\n                                            const deleteFrom = posBeforePlaceholder - variableTagNode.nodeSize;\n                                            event.preventDefault();\n                                            const tr = state.tr.delete(deleteFrom, pos);\n                                            tr.setSelection(TextSelection.create(tr.doc, Math.max(0, deleteFrom)));\n                                            view.dispatch(tr);\n                                            return true;\n                                        }\n                                    }\n                                }\n                            }\n\n                            if (selection instanceof NodeSelection && selection.node.type.name === 'variableTag') {\n                                if (['ArrowLeft', 'ArrowRight', 'ArrowUp', 'ArrowDown', 'Home', 'End'].includes(event.key)) {\n                                    return false;\n                                }\n\n                                if (['Delete', 'Backspace'].includes(event.key)) {\n                                    return false;\n                                }\n\n                                if (event.ctrlKey || event.metaKey || event.altKey || event.shiftKey) {\n                                    return false;\n                                }\n\n                                if (event.key.length === 1 || event.key === 'Enter') {\n                                    return true;\n                                }\n                            }\n\n                            return false;\n                        },\n\n                        handlePaste: (view) => {\n                            const { selection } = view.state;\n\n                            if (selection instanceof NodeSelection && selection.node.type.name === 'variableTag') {\n                                return true;\n                            }\n\n                            return false;\n                        },\n\n                        handleDrop: (view) => {\n                            const { selection } = view.state;\n\n                            if (selection instanceof NodeSelection && selection.node.type.name === 'variableTag' && !view.dragging) {\n                                return true;\n                            }\n\n                            return false;\n                        },\n                    },\n                }),\n            ];\n        },\n    });\n}\n"],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,12 @@
+export type { VariableOption, VariableCategories } from './types/variable-option.js';
+export { createTiptapExtensions, createTiptapInputExtensions, createVariableTagExtension, OneLinerDocument, } from './extensions/index.js';
+export type { CreateTiptapExtensionsOptions, CreateTiptapInputExtensionsOptions, VariableTagExtensionOptions, } from './extensions/index.js';
+export { normalizeContentArray, valueToContent, getFatalTiptapContentError, } from './serialization/editor.js';
+export type { VariableTagAttrs } from './serialization/input.js';
+export { buildVariableTagAttrs, contentToValue, dedupeVariableOptions, flattenVariableOptions, getReferenceBaseToken, parseTokenWithDefault, replaceTokenWithVariable, resolveVariableTagByValue, resolveVariableTagLabel, valueToContent as inputValueToContent, } from './serialization/input.js';
+export * from './links/index.js';
+export { isTiptapButtonActive, isTiptapButtonName, runTiptapButton, } from './toolbar/index.js';
+export type { RunTiptapButtonOptions, TiptapButtonName, TiptapTableInsertOptions, } from './toolbar/index.js';
+export { expandPresetItems, flattenToolbarButtonNames, getToolbarGroupDefaultIcon, getToolbarGroupItems, getToolbarGroupMenuItems, getToolbarGroupTriggerState, isFormattingToolbarPreset, isHeadingsOnlyToolbarPreset, isToolbarButtonActive, isToolbarSeparatorToken, normalizeToolbarNodes, parseToolbarConfig, runToolbarButton, toolbarIncludesButton, } from './toolbar/index.js';
+export type { ToolbarButtonNode, ToolbarFormattingPreset, ToolbarGroup, ToolbarGroupItemDefinition, ToolbarGroupMenuButton, ToolbarGroupMenuEntry, ToolbarGroupNode, ToolbarGroupPreset, ToolbarGroupTriggerState, ToolbarHeadingsPreset, ToolbarHeadingLevel, ToolbarIconName, ToolbarNode, ToolbarSeparatorNode, ToolbarSeparatorToken, } from './toolbar/index.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAErF,OAAO,EACH,sBAAsB,EACtB,2BAA2B,EAC3B,0BAA0B,EAC1B,gBAAgB,GACnB,MAAM,uBAAuB,CAAC;AAC/B,YAAY,EACR,6BAA6B,EAC7B,kCAAkC,EAClC,2BAA2B,GAC9B,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EACH,qBAAqB,EACrB,cAAc,EACd,0BAA0B,GAC7B,MAAM,2BAA2B,CAAC;AAEnC,YAAY,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AACjE,OAAO,EACH,qBAAqB,EACrB,cAAc,EACd,qBAAqB,EACrB,sBAAsB,EACtB,qBAAqB,EACrB,qBAAqB,EACrB,wBAAwB,EACxB,yBAAyB,EACzB,uBAAuB,EACvB,cAAc,IAAI,mBAAmB,GACxC,MAAM,0BAA0B,CAAC;AAElC,cAAc,kBAAkB,CAAC;AAEjC,OAAO,EACH,oBAAoB,EACpB,kBAAkB,EAClB,eAAe,GAClB,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EACR,sBAAsB,EACtB,gBAAgB,EAChB,wBAAwB,GAC3B,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACH,iBAAiB,EACjB,yBAAyB,EACzB,0BAA0B,EAC1B,oBAAoB,EACpB,wBAAwB,EACxB,2BAA2B,EAC3B,yBAAyB,EACzB,2BAA2B,EAC3B,qBAAqB,EACrB,uBAAuB,EACvB,qBAAqB,EACrB,kBAAkB,EAClB,gBAAgB,EAChB,qBAAqB,GACxB,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EACR,iBAAiB,EACjB,uBAAuB,EACvB,YAAY,EACZ,0BAA0B,EAC1B,sBAAsB,EACtB,qBAAqB,EACrB,gBAAgB,EAChB,kBAAkB,EAClB,wBAAwB,EACxB,qBAAqB,EACrB,mBAAmB,EACnB,eAAe,EACf,WAAW,EACX,oBAAoB,EACpB,qBAAqB,GACxB,MAAM,oBAAoB,CAAC"}

package/dist/index.js

@@ -0,0 +1,13 @@
+import { createLinkExtension } from "./links/extension.js";
+import { createVariableTagExtension } from "./extensions/variable-tag.js";
+import { OneLinerDocument } from "./extensions/one-liner-document.js";
+import { createTiptapExtensions, createTiptapInputExtensions } from "./extensions/create-extensions.js";
+import "./extensions/index.js";
+import { getFatalTiptapContentError, normalizeContentArray, valueToContent as valueToContent$1 } from "./serialization/editor.js";
+import { buildVariableTagAttrs, contentToValue, dedupeVariableOptions, flattenVariableOptions, getReferenceBaseToken, parseTokenWithDefault, replaceTokenWithVariable, resolveVariableTagByValue, resolveVariableTagLabel, valueToContent } from "./serialization/input.js";
+import { buildCraftElementLinkUrl, buildCraftElementSelectorStorageKey, getCraftLinkOptions, getLinkOptionsElementSiteId, hasCraftLinkOptions, isCraftElementLink, isLinkOptionsArray, openCraftElementLinkSelector, parseCraftElementLink } from "./links/craft-element.js";
+import { applyLinkToEditor, buildLinkMarkAttributes, getLinkEditState, getLinkOpenInNewTab, getSelectedText, unsetLinkFromEditor } from "./links/commands.js";
+import "./links/index.js";
+import { isTiptapButtonActive, isTiptapButtonName, runTiptapButton } from "./toolbar/button-registry.js";
+import { expandPresetItems, flattenToolbarButtonNames, getToolbarGroupDefaultIcon, getToolbarGroupItems, getToolbarGroupMenuItems, getToolbarGroupTriggerState, isFormattingToolbarPreset, isHeadingsOnlyToolbarPreset, isToolbarButtonActive, isToolbarSeparatorToken, normalizeToolbarNodes, parseToolbarConfig, runToolbarButton, toolbarIncludesButton } from "./toolbar/toolbar-schema.js";
+export { OneLinerDocument, applyLinkToEditor, buildCraftElementLinkUrl, buildCraftElementSelectorStorageKey, buildLinkMarkAttributes, buildVariableTagAttrs, contentToValue, createLinkExtension, createTiptapExtensions, createTiptapInputExtensions, createVariableTagExtension, dedupeVariableOptions, expandPresetItems, flattenToolbarButtonNames, flattenVariableOptions, getCraftLinkOptions, getFatalTiptapContentError, getLinkEditState, getLinkOpenInNewTab, getLinkOptionsElementSiteId, getReferenceBaseToken, getSelectedText, getToolbarGroupDefaultIcon, getToolbarGroupItems, getToolbarGroupMenuItems, getToolbarGroupTriggerState, hasCraftLinkOptions, valueToContent as inputValueToContent, isCraftElementLink, isFormattingToolbarPreset, isHeadingsOnlyToolbarPreset, isLinkOptionsArray, isTiptapButtonActive, isTiptapButtonName, isToolbarButtonActive, isToolbarSeparatorToken, normalizeContentArray, normalizeToolbarNodes, openCraftElementLinkSelector, parseCraftElementLink, parseTokenWithDefault, parseToolbarConfig, replaceTokenWithVariable, resolveVariableTagByValue, resolveVariableTagLabel, runTiptapButton, runToolbarButton, toolbarIncludesButton, unsetLinkFromEditor, valueToContent$1 as valueToContent };

package/dist/links/commands.d.ts

@@ -0,0 +1,9 @@
+import { Editor } from '@tiptap/core';
+import { InsertLinkParams, LinkEditState, LinkMarkAttributes } from './types.js';
+export declare function buildLinkMarkAttributes(url: string, openInNewTab: boolean): LinkMarkAttributes;
+export declare function getSelectedText(editor: Editor): string;
+export declare function getLinkOpenInNewTab(editor: Editor): boolean;
+export declare function getLinkEditState(editor: Editor): LinkEditState;
+export declare function applyLinkToEditor(editor: Editor, params: InsertLinkParams): void;
+export declare function unsetLinkFromEditor(editor: Editor): void;
+//# sourceMappingURL=commands.d.ts.map

package/dist/links/commands.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"commands.d.ts","sourceRoot":"","sources":["../../src/links/commands.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,KAAK,MAAM,EAAE,MAAM,cAAc,CAAC;AAEzD,OAAO,KAAK,EACR,gBAAgB,EAChB,aAAa,EACb,kBAAkB,EACrB,MAAM,YAAY,CAAC;AAEpB,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,MAAM,EAAE,YAAY,EAAE,OAAO,GAAG,kBAAkB,CAQ9F;AAED,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAGtD;AAED,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAE3D;AAED,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,aAAa,CAgB9D;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,gBAAgB,GAAG,IAAI,CA+BhF;AAED,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAExD"}

package/dist/links/commands.js

@@ -0,0 +1,63 @@
+import { getMarkRange } from "@tiptap/core";
+//#region src/links/commands.ts
+function buildLinkMarkAttributes(url, openInNewTab) {
+	const linkAttrs = { href: url };
+	if (openInNewTab) linkAttrs.target = "_blank";
+	return linkAttrs;
+}
+function getSelectedText(editor) {
+	const { from, to } = editor.state.selection;
+	return editor.state.doc.textBetween(from, to, " ");
+}
+function getLinkOpenInNewTab(editor) {
+	return editor.isActive("link") && editor.getAttributes("link").target === "_blank";
+}
+function getLinkEditState(editor) {
+	const { href } = editor.getAttributes("link");
+	const { state } = editor;
+	const linkType = state.schema.marks.link;
+	const range = getMarkRange(state.selection.$from, linkType);
+	const from = range?.from ?? state.selection.from;
+	const to = range?.to ?? state.selection.to;
+	const text = editor.state.doc.textBetween(from, to, " ");
+	return {
+		from,
+		to,
+		href: href ?? "",
+		text,
+		openInNewTab: getLinkOpenInNewTab(editor)
+	};
+}
+function applyLinkToEditor(editor, params) {
+	const { url, text, openInNewTab, from: fromParam, to: toParam } = params;
+	const chain = editor.chain().focus();
+	const linkAttrs = buildLinkMarkAttributes(url, openInNewTab);
+	const content = {
+		type: "text",
+		text: text.trim() || url,
+		marks: [{
+			type: "link",
+			attrs: linkAttrs
+		}]
+	};
+	if (typeof fromParam === "number" && typeof toParam === "number" && fromParam !== toParam) {
+		chain.insertContentAt({
+			from: fromParam,
+			to: toParam
+		}, [content]).run();
+		return;
+	}
+	const { from, to } = editor.state.selection;
+	if (editor.state.doc.textBetween(from, to, " ")) {
+		chain.extendMarkRange("link").setLink(linkAttrs).run();
+		return;
+	}
+	chain.insertContent([content]).run();
+}
+function unsetLinkFromEditor(editor) {
+	editor.chain().focus().extendMarkRange("link").unsetLink().run();
+}
+//#endregion
+export { applyLinkToEditor, buildLinkMarkAttributes, getLinkEditState, getLinkOpenInNewTab, getSelectedText, unsetLinkFromEditor };
+
+//# sourceMappingURL=commands.js.map

package/dist/links/commands.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"commands.js","names":[],"sources":["../../src/links/commands.ts"],"sourcesContent":["import { getMarkRange, type Editor } from '@tiptap/core';\n\nimport type {\n    InsertLinkParams,\n    LinkEditState,\n    LinkMarkAttributes,\n} from './types.js';\n\nexport function buildLinkMarkAttributes(url: string, openInNewTab: boolean): LinkMarkAttributes {\n    const linkAttrs: LinkMarkAttributes = { href: url };\n\n    if (openInNewTab) {\n        linkAttrs.target = '_blank';\n    }\n\n    return linkAttrs;\n}\n\nexport function getSelectedText(editor: Editor): string {\n    const { from, to } = editor.state.selection;\n    return editor.state.doc.textBetween(from, to, ' ');\n}\n\nexport function getLinkOpenInNewTab(editor: Editor): boolean {\n    return editor.isActive('link') && editor.getAttributes('link').target === '_blank';\n}\n\nexport function getLinkEditState(editor: Editor): LinkEditState {\n    const { href } = editor.getAttributes('link');\n    const { state } = editor;\n    const linkType = state.schema.marks.link;\n    const range = getMarkRange(state.selection.$from, linkType);\n    const from = range?.from ?? state.selection.from;\n    const to = range?.to ?? state.selection.to;\n    const text = editor.state.doc.textBetween(from, to, ' ');\n\n    return {\n        from,\n        to,\n        href: href ?? '',\n        text,\n        openInNewTab: getLinkOpenInNewTab(editor),\n    };\n}\n\nexport function applyLinkToEditor(editor: Editor, params: InsertLinkParams): void {\n    const {\n        url,\n        text,\n        openInNewTab,\n        from: fromParam,\n        to: toParam,\n    } = params;\n\n    const chain = editor.chain().focus();\n    const linkAttrs = buildLinkMarkAttributes(url, openInNewTab);\n    const content = {\n        type: 'text',\n        text: text.trim() || url,\n        marks: [{ type: 'link', attrs: linkAttrs }],\n    };\n\n    if (typeof fromParam === 'number' && typeof toParam === 'number' && fromParam !== toParam) {\n        chain.insertContentAt({ from: fromParam, to: toParam }, [content]).run();\n        return;\n    }\n\n    const { from, to } = editor.state.selection;\n    const selectedText = editor.state.doc.textBetween(from, to, ' ');\n\n    if (selectedText) {\n        chain.extendMarkRange('link').setLink(linkAttrs).run();\n        return;\n    }\n\n    chain.insertContent([content]).run();\n}\n\nexport function unsetLinkFromEditor(editor: Editor): void {\n    editor.chain().focus().extendMarkRange('link').unsetLink().run();\n}\n"],"mappings":";;AAQA,SAAgB,wBAAwB,KAAa,cAA2C;CAC5F,MAAM,YAAgC,EAAE,MAAM,KAAK;AAEnD,KAAI,aACA,WAAU,SAAS;AAGvB,QAAO;;AAGX,SAAgB,gBAAgB,QAAwB;CACpD,MAAM,EAAE,MAAM,OAAO,OAAO,MAAM;AAClC,QAAO,OAAO,MAAM,IAAI,YAAY,MAAM,IAAI,IAAI;;AAGtD,SAAgB,oBAAoB,QAAyB;AACzD,QAAO,OAAO,SAAS,OAAO,IAAI,OAAO,cAAc,OAAO,CAAC,WAAW;;AAG9E,SAAgB,iBAAiB,QAA+B;CAC5D,MAAM,EAAE,SAAS,OAAO,cAAc,OAAO;CAC7C,MAAM,EAAE,UAAU;CAClB,MAAM,WAAW,MAAM,OAAO,MAAM;CACpC,MAAM,QAAQ,aAAa,MAAM,UAAU,OAAO,SAAS;CAC3D,MAAM,OAAO,OAAO,QAAQ,MAAM,UAAU;CAC5C,MAAM,KAAK,OAAO,MAAM,MAAM,UAAU;CACxC,MAAM,OAAO,OAAO,MAAM,IAAI,YAAY,MAAM,IAAI,IAAI;AAExD,QAAO;EACH;EACA;EACA,MAAM,QAAQ;EACd;EACA,cAAc,oBAAoB,OAAO;EAC5C;;AAGL,SAAgB,kBAAkB,QAAgB,QAAgC;CAC9E,MAAM,EACF,KACA,MACA,cACA,MAAM,WACN,IAAI,YACJ;CAEJ,MAAM,QAAQ,OAAO,OAAO,CAAC,OAAO;CACpC,MAAM,YAAY,wBAAwB,KAAK,aAAa;CAC5D,MAAM,UAAU;EACZ,MAAM;EACN,MAAM,KAAK,MAAM,IAAI;EACrB,OAAO,CAAC;GAAE,MAAM;GAAQ,OAAO;GAAW,CAAC;EAC9C;AAED,KAAI,OAAO,cAAc,YAAY,OAAO,YAAY,YAAY,cAAc,SAAS;AACvF,QAAM,gBAAgB;GAAE,MAAM;GAAW,IAAI;GAAS,EAAE,CAAC,QAAQ,CAAC,CAAC,KAAK;AACxE;;CAGJ,MAAM,EAAE,MAAM,OAAO,OAAO,MAAM;AAGlC,KAFqB,OAAO,MAAM,IAAI,YAAY,MAAM,IAAI,IAExD,EAAc;AACd,QAAM,gBAAgB,OAAO,CAAC,QAAQ,UAAU,CAAC,KAAK;AACtD;;AAGJ,OAAM,cAAc,CAAC,QAAQ,CAAC,CAAC,KAAK;;AAGxC,SAAgB,oBAAoB,QAAsB;AACtD,QAAO,OAAO,CAAC,OAAO,CAAC,gBAAgB,OAAO,CAAC,WAAW,CAAC,KAAK"}

package/dist/links/craft-element.d.ts

@@ -0,0 +1,28 @@
+import { CraftSelectedElement, ElementSelectorHost, LinkElementConfig, LinkOptionSchemaItem, LinkOptionsInput, ParsedCraftElementLink } from './types.js';
+export declare function isLinkOptionsArray(value: LinkOptionsInput | undefined): value is LinkOptionSchemaItem[];
+export declare function getCraftLinkOptions(linkOptions: LinkOptionsInput | undefined): LinkOptionSchemaItem[];
+export declare function getLinkOptionsElementSiteId(linkOptions: LinkOptionsInput | undefined): number | undefined;
+export declare function hasCraftLinkOptions(linkOptions: LinkOptionsInput | undefined): boolean;
+/**
+ * Build a Craft element link URL with the standard ref fragment:
+ * `https://example.com/page#refHandle:123@1`
+ */
+export declare function buildCraftElementLinkUrl(element: CraftSelectedElement, refHandle: string): string;
+/** Parse a Craft element link URL back into its parts. */
+export declare function parseCraftElementLink(href: string): ParsedCraftElementLink | null;
+export declare function isCraftElementLink(href: string): boolean;
+export declare function buildCraftElementSelectorStorageKey(linkSelectorStorageKeyPrefix: string, elementType: string): string;
+export type OpenCraftElementLinkSelectorParams = {
+    config: LinkElementConfig;
+    elementSiteId?: number;
+    linkSelectorStorageKeyPrefix?: string;
+    getSelectedText: () => string;
+    onSelect: (result: {
+        url: string;
+        text: string;
+    }) => void;
+    host: ElementSelectorHost;
+};
+/** Open Craft's element selector modal and return a Plugin Kit link URL on selection. */
+export declare function openCraftElementLinkSelector({ config, elementSiteId, linkSelectorStorageKeyPrefix, getSelectedText, onSelect, host, }: OpenCraftElementLinkSelectorParams): void;
+//# sourceMappingURL=craft-element.d.ts.map

package/dist/links/craft-element.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"craft-element.d.ts","sourceRoot":"","sources":["../../src/links/craft-element.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACR,oBAAoB,EACpB,mBAAmB,EACnB,iBAAiB,EACjB,oBAAoB,EACpB,gBAAgB,EAChB,sBAAsB,EACzB,MAAM,YAAY,CAAC;AAEpB,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,gBAAgB,GAAG,SAAS,GAAG,KAAK,IAAI,oBAAoB,EAAE,CAEvG;AAED,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,gBAAgB,GAAG,SAAS,GAAG,oBAAoB,EAAE,CAwBrG;AAED,wBAAgB,2BAA2B,CAAC,WAAW,EAAE,gBAAgB,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAMzG;AAED,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,gBAAgB,GAAG,SAAS,GAAG,OAAO,CAEtF;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,CACpC,OAAO,EAAE,oBAAoB,EAC7B,SAAS,EAAE,MAAM,GAClB,MAAM,CAER;AAED,0DAA0D;AAC1D,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,sBAAsB,GAAG,IAAI,CAqBjF;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAExD;AAED,wBAAgB,mCAAmC,CAC/C,4BAA4B,EAAE,MAAM,EACpC,WAAW,EAAE,MAAM,GACpB,MAAM,CAER;AAED,MAAM,MAAM,kCAAkC,GAAG;IAC7C,MAAM,EAAE,iBAAiB,CAAC;IAC1B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,4BAA4B,CAAC,EAAE,MAAM,CAAC;IACtC,eAAe,EAAE,MAAM,MAAM,CAAC;IAC9B,QAAQ,EAAE,CAAC,MAAM,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAC;IAC1D,IAAI,EAAE,mBAAmB,CAAC;CAC7B,CAAC;AAEF,yFAAyF;AACzF,wBAAgB,4BAA4B,CAAC,EACzC,MAAM,EACN,aAAa,EACb,4BAA4B,EAC5B,eAAe,EACf,QAAQ,EACR,IAAI,GACP,EAAE,kCAAkC,GAAG,IAAI,CAwB3C"}