@verbb/plugin-kit-tiptap-core 2.0.0

package/dist/links/craft-element.js

@@ -0,0 +1,80 @@
+//#region src/links/craft-element.ts
+function isLinkOptionsArray(value) {
+	return Array.isArray(value) && value.length > 0;
+}
+function getCraftLinkOptions(linkOptions) {
+	if (!linkOptions) return [];
+	if (isLinkOptionsArray(linkOptions)) return linkOptions;
+	const items = [];
+	if (linkOptions.linkToEntry) items.push({
+		...linkOptions.linkToEntry,
+		optionTitle: "Link to an entry"
+	});
+	if (linkOptions.linkToAsset) items.push({
+		...linkOptions.linkToAsset,
+		optionTitle: "Link to an asset"
+	});
+	if (linkOptions.linkToCategory) items.push({
+		...linkOptions.linkToCategory,
+		optionTitle: "Link to a category"
+	});
+	return items;
+}
+function getLinkOptionsElementSiteId(linkOptions) {
+	if (!linkOptions || isLinkOptionsArray(linkOptions)) return;
+	return linkOptions.elementSiteId;
+}
+function hasCraftLinkOptions(linkOptions) {
+	return getCraftLinkOptions(linkOptions).length > 0;
+}
+/**
+* Build a Craft element link URL with the standard ref fragment:
+* `https://example.com/page#refHandle:123@1`
+*/
+function buildCraftElementLinkUrl(element, refHandle) {
+	return `${element.url || ""}#${refHandle}:${element.id}@${element.siteId}`;
+}
+/** Parse a Craft element link URL back into its parts. */
+function parseCraftElementLink(href) {
+	const hashIndex = href.indexOf("#");
+	if (hashIndex === -1) return null;
+	const baseUrl = href.slice(0, hashIndex);
+	const match = href.slice(hashIndex + 1).match(/^([^:]+):(\d+)@(\d+)$/);
+	if (!match) return null;
+	return {
+		baseUrl,
+		refHandle: match[1],
+		id: Number(match[2]),
+		siteId: Number(match[3])
+	};
+}
+function isCraftElementLink(href) {
+	return parseCraftElementLink(href) !== null;
+}
+function buildCraftElementSelectorStorageKey(linkSelectorStorageKeyPrefix, elementType) {
+	return `${linkSelectorStorageKeyPrefix}.${elementType}`;
+}
+/** Open Craft's element selector modal and return a Plugin Kit link URL on selection. */
+function openCraftElementLinkSelector({ config, elementSiteId, linkSelectorStorageKeyPrefix, getSelectedText, onSelect, host }) {
+	if (!linkSelectorStorageKeyPrefix) throw new Error("Craft element links require \"linkSelectorStorageKeyPrefix\".");
+	host.openElementSelector(config.elementType, {
+		storageKey: buildCraftElementSelectorStorageKey(linkSelectorStorageKeyPrefix, config.elementType),
+		sources: config.sources,
+		criteria: config.criteria,
+		defaultSiteId: elementSiteId,
+		autoFocusSearchBox: false,
+		onSelect: (elements) => {
+			if (!elements?.length) return;
+			const [element] = elements;
+			onSelect({
+				url: buildCraftElementLinkUrl(element, config.refHandle),
+				text: getSelectedText() || element.label || ""
+			});
+		},
+		closeOtherModals: false
+	});
+}
+//#endregion
+export { buildCraftElementLinkUrl, buildCraftElementSelectorStorageKey, getCraftLinkOptions, getLinkOptionsElementSiteId, hasCraftLinkOptions, isCraftElementLink, isLinkOptionsArray, openCraftElementLinkSelector, parseCraftElementLink };
+
+//# sourceMappingURL=craft-element.js.map

package/dist/links/craft-element.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"craft-element.js","names":[],"sources":["../../src/links/craft-element.ts"],"sourcesContent":["import type {\n    CraftSelectedElement,\n    ElementSelectorHost,\n    LinkElementConfig,\n    LinkOptionSchemaItem,\n    LinkOptionsInput,\n    ParsedCraftElementLink,\n} from './types.js';\n\nexport function isLinkOptionsArray(value: LinkOptionsInput | undefined): value is LinkOptionSchemaItem[] {\n    return Array.isArray(value) && value.length > 0;\n}\n\nexport function getCraftLinkOptions(linkOptions: LinkOptionsInput | undefined): LinkOptionSchemaItem[] {\n    if (!linkOptions) {\n        return [];\n    }\n\n    if (isLinkOptionsArray(linkOptions)) {\n        return linkOptions;\n    }\n\n    const items: LinkOptionSchemaItem[] = [];\n\n    if (linkOptions.linkToEntry) {\n        items.push({ ...linkOptions.linkToEntry, optionTitle: 'Link to an entry' });\n    }\n\n    if (linkOptions.linkToAsset) {\n        items.push({ ...linkOptions.linkToAsset, optionTitle: 'Link to an asset' });\n    }\n\n    if (linkOptions.linkToCategory) {\n        items.push({ ...linkOptions.linkToCategory, optionTitle: 'Link to a category' });\n    }\n\n    return items;\n}\n\nexport function getLinkOptionsElementSiteId(linkOptions: LinkOptionsInput | undefined): number | undefined {\n    if (!linkOptions || isLinkOptionsArray(linkOptions)) {\n        return undefined;\n    }\n\n    return linkOptions.elementSiteId;\n}\n\nexport function hasCraftLinkOptions(linkOptions: LinkOptionsInput | undefined): boolean {\n    return getCraftLinkOptions(linkOptions).length > 0;\n}\n\n/**\n * Build a Craft element link URL with the standard ref fragment:\n * `https://example.com/page#refHandle:123@1`\n */\nexport function buildCraftElementLinkUrl(\n    element: CraftSelectedElement,\n    refHandle: string,\n): string {\n    return `${element.url || ''}#${refHandle}:${element.id}@${element.siteId}`;\n}\n\n/** Parse a Craft element link URL back into its parts. */\nexport function parseCraftElementLink(href: string): ParsedCraftElementLink | null {\n    const hashIndex = href.indexOf('#');\n\n    if (hashIndex === -1) {\n        return null;\n    }\n\n    const baseUrl = href.slice(0, hashIndex);\n    const fragment = href.slice(hashIndex + 1);\n    const match = fragment.match(/^([^:]+):(\\d+)@(\\d+)$/);\n\n    if (!match) {\n        return null;\n    }\n\n    return {\n        baseUrl,\n        refHandle: match[1],\n        id: Number(match[2]),\n        siteId: Number(match[3]),\n    };\n}\n\nexport function isCraftElementLink(href: string): boolean {\n    return parseCraftElementLink(href) !== null;\n}\n\nexport function buildCraftElementSelectorStorageKey(\n    linkSelectorStorageKeyPrefix: string,\n    elementType: string,\n): string {\n    return `${linkSelectorStorageKeyPrefix}.${elementType}`;\n}\n\nexport type OpenCraftElementLinkSelectorParams = {\n    config: LinkElementConfig;\n    elementSiteId?: number;\n    linkSelectorStorageKeyPrefix?: string;\n    getSelectedText: () => string;\n    onSelect: (result: { url: string; text: string }) => void;\n    host: ElementSelectorHost;\n};\n\n/** Open Craft's element selector modal and return a Plugin Kit link URL on selection. */\nexport function openCraftElementLinkSelector({\n    config,\n    elementSiteId,\n    linkSelectorStorageKeyPrefix,\n    getSelectedText,\n    onSelect,\n    host,\n}: OpenCraftElementLinkSelectorParams): void {\n    if (!linkSelectorStorageKeyPrefix) {\n        throw new Error('Craft element links require \"linkSelectorStorageKeyPrefix\".');\n    }\n\n    host.openElementSelector(config.elementType, {\n        storageKey: buildCraftElementSelectorStorageKey(linkSelectorStorageKeyPrefix, config.elementType),\n        sources: config.sources,\n        criteria: config.criteria,\n        defaultSiteId: elementSiteId,\n        autoFocusSearchBox: false,\n        onSelect: (elements) => {\n            if (!elements?.length) {\n                return;\n            }\n\n            const [element] = elements;\n            const url = buildCraftElementLinkUrl(element, config.refHandle);\n            const text = getSelectedText() || element.label || '';\n\n            onSelect({ url, text });\n        },\n        closeOtherModals: false,\n    });\n}\n"],"mappings":";AASA,SAAgB,mBAAmB,OAAsE;AACrG,QAAO,MAAM,QAAQ,MAAM,IAAI,MAAM,SAAS;;AAGlD,SAAgB,oBAAoB,aAAmE;AACnG,KAAI,CAAC,YACD,QAAO,EAAE;AAGb,KAAI,mBAAmB,YAAY,CAC/B,QAAO;CAGX,MAAM,QAAgC,EAAE;AAExC,KAAI,YAAY,YACZ,OAAM,KAAK;EAAE,GAAG,YAAY;EAAa,aAAa;EAAoB,CAAC;AAG/E,KAAI,YAAY,YACZ,OAAM,KAAK;EAAE,GAAG,YAAY;EAAa,aAAa;EAAoB,CAAC;AAG/E,KAAI,YAAY,eACZ,OAAM,KAAK;EAAE,GAAG,YAAY;EAAgB,aAAa;EAAsB,CAAC;AAGpF,QAAO;;AAGX,SAAgB,4BAA4B,aAA+D;AACvG,KAAI,CAAC,eAAe,mBAAmB,YAAY,CAC/C;AAGJ,QAAO,YAAY;;AAGvB,SAAgB,oBAAoB,aAAoD;AACpF,QAAO,oBAAoB,YAAY,CAAC,SAAS;;;;;;AAOrD,SAAgB,yBACZ,SACA,WACM;AACN,QAAO,GAAG,QAAQ,OAAO,GAAG,GAAG,UAAU,GAAG,QAAQ,GAAG,GAAG,QAAQ;;;AAItE,SAAgB,sBAAsB,MAA6C;CAC/E,MAAM,YAAY,KAAK,QAAQ,IAAI;AAEnC,KAAI,cAAc,GACd,QAAO;CAGX,MAAM,UAAU,KAAK,MAAM,GAAG,UAAU;CAExC,MAAM,QADW,KAAK,MAAM,YAAY,EAC1B,CAAS,MAAM,wBAAwB;AAErD,KAAI,CAAC,MACD,QAAO;AAGX,QAAO;EACH;EACA,WAAW,MAAM;EACjB,IAAI,OAAO,MAAM,GAAG;EACpB,QAAQ,OAAO,MAAM,GAAG;EAC3B;;AAGL,SAAgB,mBAAmB,MAAuB;AACtD,QAAO,sBAAsB,KAAK,KAAK;;AAG3C,SAAgB,oCACZ,8BACA,aACM;AACN,QAAO,GAAG,6BAA6B,GAAG;;;AAa9C,SAAgB,6BAA6B,EACzC,QACA,eACA,8BACA,iBACA,UACA,QACyC;AACzC,KAAI,CAAC,6BACD,OAAM,IAAI,MAAM,gEAA8D;AAGlF,MAAK,oBAAoB,OAAO,aAAa;EACzC,YAAY,oCAAoC,8BAA8B,OAAO,YAAY;EACjG,SAAS,OAAO;EAChB,UAAU,OAAO;EACjB,eAAe;EACf,oBAAoB;EACpB,WAAW,aAAa;AACpB,OAAI,CAAC,UAAU,OACX;GAGJ,MAAM,CAAC,WAAW;AAIlB,YAAS;IAAE,KAHC,yBAAyB,SAAS,OAAO,UAG1C;IAAK,MAFH,iBAAiB,IAAI,QAAQ,SAAS;IAE7B,CAAC;;EAE3B,kBAAkB;EACrB,CAAC"}

package/dist/links/extension.d.ts

@@ -0,0 +1,3 @@
+/** Shared Tiptap link mark configuration for Plugin Kit editors. */
+export declare function createLinkExtension(): import('@tiptap/core').Mark<import('@tiptap/extension-link').LinkOptions, any>;
+//# sourceMappingURL=extension.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"extension.d.ts","sourceRoot":"","sources":["../../src/links/extension.ts"],"names":[],"mappings":"AAEA,oEAAoE;AACpE,wBAAgB,mBAAmB,mFAMlC"}

package/dist/links/extension.js

@@ -0,0 +1,17 @@
+import Link from "@tiptap/extension-link";
+//#region src/links/extension.ts
+/** Shared Tiptap link mark configuration for Plugin Kit editors. */
+function createLinkExtension() {
+	return Link.configure({
+		openOnClick: false,
+		enableClickSelection: false,
+		HTMLAttributes: {
+			target: null,
+			rel: null
+		}
+	});
+}
+//#endregion
+export { createLinkExtension };
+
+//# sourceMappingURL=extension.js.map

package/dist/links/extension.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"extension.js","names":[],"sources":["../../src/links/extension.ts"],"sourcesContent":["import Link from '@tiptap/extension-link';\n\n/** Shared Tiptap link mark configuration for Plugin Kit editors. */\nexport function createLinkExtension() {\n    return Link.configure({\n        openOnClick: false,\n        enableClickSelection: false,\n        HTMLAttributes: { target: null, rel: null },\n    });\n}\n"],"mappings":";;;AAGA,SAAgB,sBAAsB;AAClC,QAAO,KAAK,UAAU;EAClB,aAAa;EACb,sBAAsB;EACtB,gBAAgB;GAAE,QAAQ;GAAM,KAAK;GAAM;EAC9C,CAAC"}

package/dist/links/index.d.ts

@@ -0,0 +1,5 @@
+export * from './types.js';
+export * from './extension.js';
+export * from './craft-element.js';
+export * from './commands.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/links/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,oBAAoB,CAAC;AACnC,cAAc,eAAe,CAAC"}

package/dist/links/index.js

@@ -0,0 +1,4 @@
+import { createLinkExtension } from "./extension.js";
+import { buildCraftElementLinkUrl, buildCraftElementSelectorStorageKey, getCraftLinkOptions, getLinkOptionsElementSiteId, hasCraftLinkOptions, isCraftElementLink, isLinkOptionsArray, openCraftElementLinkSelector, parseCraftElementLink } from "./craft-element.js";
+import { applyLinkToEditor, buildLinkMarkAttributes, getLinkEditState, getLinkOpenInNewTab, getSelectedText, unsetLinkFromEditor } from "./commands.js";
+export { applyLinkToEditor, buildCraftElementLinkUrl, buildCraftElementSelectorStorageKey, buildLinkMarkAttributes, createLinkExtension, getCraftLinkOptions, getLinkEditState, getLinkOpenInNewTab, getLinkOptionsElementSiteId, getSelectedText, hasCraftLinkOptions, isCraftElementLink, isLinkOptionsArray, openCraftElementLinkSelector, parseCraftElementLink, unsetLinkFromEditor };

package/dist/links/types.d.ts

@@ -0,0 +1,62 @@
+export type LinkElementConfig = {
+    elementType: string;
+    refHandle: string;
+    sources?: string[];
+    criteria?: Record<string, unknown>;
+};
+export type LinkOptionSchemaItem = LinkElementConfig & {
+    optionTitle: string;
+};
+export type LinkOptions = {
+    elementSiteId?: number;
+    linkToEntry?: LinkElementConfig;
+    linkToAsset?: LinkElementConfig;
+    linkToCategory?: LinkElementConfig;
+};
+/** linkOptions can be the object format above, or an array from schema. */
+export type LinkOptionsInput = LinkOptions | LinkOptionSchemaItem[];
+export type CraftSelectedElement = {
+    id?: number;
+    siteId?: number;
+    label?: string;
+    url?: string;
+};
+export type ParsedCraftElementLink = {
+    baseUrl: string;
+    refHandle: string;
+    id: number;
+    siteId: number;
+};
+export type ElementSelectorOpenOptions = {
+    storageKey: string;
+    sources?: string[];
+    criteria?: Record<string, unknown>;
+    defaultSiteId?: number;
+    autoFocusSearchBox?: boolean;
+    onSelect: (elements: CraftSelectedElement[]) => void;
+    closeOtherModals?: boolean;
+};
+export type ElementSelectorHost = {
+    openElementSelector: (elementType: string, options: ElementSelectorOpenOptions) => void;
+};
+export type InsertLinkDialogState = {
+    url: string;
+    text: string;
+    openInNewTab: boolean;
+};
+export type InsertLinkParams = InsertLinkDialogState & {
+    from?: number;
+    to?: number;
+};
+export type LinkMarkAttributes = {
+    href: string;
+    target?: string | null;
+};
+export type LinkEditState = {
+    from: number;
+    to: number;
+    href: string;
+    text: string;
+    openInNewTab: boolean;
+};
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/links/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,iBAAiB,GAAG;IAC5B,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACtC,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG,iBAAiB,GAAG;IACnD,WAAW,EAAE,MAAM,CAAC;CACvB,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG;IACtB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,WAAW,CAAC,EAAE,iBAAiB,CAAC;IAChC,WAAW,CAAC,EAAE,iBAAiB,CAAC;IAChC,cAAc,CAAC,EAAE,iBAAiB,CAAC;CACtC,CAAC;AAEF,2EAA2E;AAC3E,MAAM,MAAM,gBAAgB,GAAG,WAAW,GAAG,oBAAoB,EAAE,CAAC;AAEpE,MAAM,MAAM,oBAAoB,GAAG;IAC/B,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,sBAAsB,GAAG;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,MAAM,MAAM,0BAA0B,GAAG;IACrC,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,QAAQ,EAAE,CAAC,QAAQ,EAAE,oBAAoB,EAAE,KAAK,IAAI,CAAC;IACrD,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC9B,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG;IAC9B,mBAAmB,EAAE,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,0BAA0B,KAAK,IAAI,CAAC;CAC3F,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG;IAChC,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,OAAO,CAAC;CACzB,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG,qBAAqB,GAAG;IACnD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,EAAE,CAAC,EAAE,MAAM,CAAC;CACf,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,OAAO,CAAC;CACzB,CAAC"}

package/dist/serialization/editor.d.ts

@@ -0,0 +1,9 @@
+import { JSONContent } from '@tiptap/core';
+type NormalizeContentOptions = {
+    trailingCursorText?: string;
+};
+export declare const normalizeContentArray: (content: unknown, { trailingCursorText }?: NormalizeContentOptions) => JSONContent[];
+export declare const valueToContent: (value: unknown, options?: NormalizeContentOptions) => JSONContent | null;
+export declare const getFatalTiptapContentError: (value: unknown) => string;
+export {};
+//# sourceMappingURL=editor.d.ts.map

package/dist/serialization/editor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"editor.d.ts","sourceRoot":"","sources":["../../src/serialization/editor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAEhD,KAAK,uBAAuB,GAAG;IAC3B,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC/B,CAAC;AAsBF,eAAO,MAAM,qBAAqB,GAC9B,SAAS,OAAO,EAChB,yBAAwB,uBAA4B,KACrD,WAAW,EAwCb,CAAC;AAEF,eAAO,MAAM,cAAc,GACvB,OAAO,OAAO,EACd,UAAS,uBAA4B,KACtC,WAAW,GAAG,IAgDhB,CAAC;AAEF,eAAO,MAAM,0BAA0B,GAAI,OAAO,OAAO,KAAG,MA8B3D,CAAC"}

package/dist/serialization/editor.js

@@ -0,0 +1,112 @@
+//#region src/serialization/editor.ts
+var isJsonContent = (value) => {
+	return Boolean(value) && typeof value === "object";
+};
+var withTrailingCursorText = (content, trailingCursorText) => {
+	if (!trailingCursorText || !content.length) return content;
+	if (content[content.length - 1].type !== "variableTag") return content;
+	return [...content, {
+		type: "text",
+		text: trailingCursorText
+	}];
+};
+var normalizeContentArray = (content, { trailingCursorText } = {}) => {
+	if (!Array.isArray(content)) return [];
+	return withTrailingCursorText(content.flatMap((node) => {
+		if (!node) return [];
+		if (Array.isArray(node)) return normalizeContentArray(node, { trailingCursorText });
+		if (typeof node !== "object") return [];
+		if (!("type" in node)) {
+			if (isJsonContent(node) && Array.isArray(node.content)) return normalizeContentArray(node.content, { trailingCursorText });
+			return [];
+		}
+		if (isJsonContent(node) && node.type === "text" && typeof node.text === "string") {
+			const text = node.text.replace(/[\u200B\u2060]/g, "");
+			return text ? [{
+				...node,
+				text
+			}] : [];
+		}
+		if (isJsonContent(node) && Array.isArray(node.content)) {
+			const cleaned = normalizeContentArray(node.content, { trailingCursorText });
+			return [{
+				...node,
+				content: cleaned
+			}];
+		}
+		return isJsonContent(node) ? [node] : [];
+	}), trailingCursorText);
+};
+var valueToContent = (value, options = {}) => {
+	if (!value) return null;
+	if (Array.isArray(value)) {
+		const cleaned = normalizeContentArray(value, options);
+		return cleaned.length ? {
+			type: "doc",
+			content: cleaned
+		} : null;
+	}
+	if (isJsonContent(value)) {
+		if (value.type === "doc" && Array.isArray(value.content)) {
+			const cleaned = normalizeContentArray(value.content, options);
+			return cleaned.length ? {
+				...value,
+				content: cleaned
+			} : null;
+		}
+		if (Array.isArray(value.content)) {
+			const cleaned = normalizeContentArray(value.content, options);
+			return cleaned.length ? {
+				type: "doc",
+				content: cleaned
+			} : null;
+		}
+	}
+	if (typeof value === "string") try {
+		const parsed = JSON.parse(value);
+		if (Array.isArray(parsed)) {
+			const cleaned = normalizeContentArray(parsed, options);
+			return cleaned.length ? {
+				type: "doc",
+				content: cleaned
+			} : null;
+		}
+		if (isJsonContent(parsed)) {
+			if (parsed.type === "doc" && Array.isArray(parsed.content)) {
+				const cleaned = normalizeContentArray(parsed.content, options);
+				return cleaned.length ? {
+					...parsed,
+					content: cleaned
+				} : null;
+			}
+			if (Array.isArray(parsed.content)) {
+				const cleaned = normalizeContentArray(parsed.content, options);
+				return cleaned.length ? {
+					type: "doc",
+					content: cleaned
+				} : null;
+			}
+		}
+	} catch {
+		return null;
+	}
+	return null;
+};
+var getFatalTiptapContentError = (value) => {
+	const content = valueToContent(value);
+	if (!content) return "";
+	const visit = (node) => {
+		if (!node || typeof node !== "object") return false;
+		const jsonNode = node;
+		if (jsonNode.type === "text" && typeof jsonNode.text === "string" && jsonNode.text === "") return true;
+		if (!Array.isArray(jsonNode.content)) return false;
+		return jsonNode.content.some((child) => {
+			return visit(child);
+		});
+	};
+	return visit(content) ? "This field contains invalid rich-text content. The editor could not fully parse the stored document, so some content may not be shown until it is repaired and saved again." : "";
+};
+//#endregion
+export { getFatalTiptapContentError, normalizeContentArray, valueToContent };
+
+//# sourceMappingURL=editor.js.map

package/dist/serialization/editor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"editor.js","names":[],"sources":["../../src/serialization/editor.ts"],"sourcesContent":["import type { JSONContent } from '@tiptap/core';\n\ntype NormalizeContentOptions = {\n    trailingCursorText?: string;\n};\n\nconst isJsonContent = (value: unknown): value is JSONContent => {\n    return Boolean(value) && typeof value === 'object';\n};\n\nconst withTrailingCursorText = (\n    content: JSONContent[],\n    trailingCursorText?: string,\n): JSONContent[] => {\n    if (!trailingCursorText || !content.length) {\n        return content;\n    }\n\n    const lastNode = content[content.length - 1] as { type?: string };\n    if (lastNode.type !== 'variableTag') {\n        return content;\n    }\n\n    return [...content, { type: 'text', text: trailingCursorText }];\n};\n\nexport const normalizeContentArray = (\n    content: unknown,\n    { trailingCursorText }: NormalizeContentOptions = {},\n): JSONContent[] => {\n    if (!Array.isArray(content)) {\n        return [];\n    }\n\n    const normalized = content.flatMap((node) => {\n        if (!node) {\n            return [];\n        }\n\n        if (Array.isArray(node)) {\n            return normalizeContentArray(node, { trailingCursorText });\n        }\n\n        if (typeof node !== 'object') {\n            return [];\n        }\n\n        if (!('type' in node)) {\n            if (isJsonContent(node) && Array.isArray(node.content)) {\n                return normalizeContentArray(node.content, { trailingCursorText });\n            }\n\n            return [];\n        }\n\n        if (isJsonContent(node) && node.type === 'text' && typeof node.text === 'string') {\n            const text = node.text.replace(/[\\u200B\\u2060]/g, '');\n            return text ? [{ ...node, text }] : [];\n        }\n\n        if (isJsonContent(node) && Array.isArray(node.content)) {\n            const cleaned = normalizeContentArray(node.content, { trailingCursorText });\n            return [{ ...node, content: cleaned }];\n        }\n\n        return isJsonContent(node) ? [node] : [];\n    });\n\n    return withTrailingCursorText(normalized, trailingCursorText);\n};\n\nexport const valueToContent = (\n    value: unknown,\n    options: NormalizeContentOptions = {},\n): JSONContent | null => {\n    if (!value) {\n        return null;\n    }\n\n    if (Array.isArray(value)) {\n        const cleaned = normalizeContentArray(value, options);\n        return cleaned.length ? { type: 'doc', content: cleaned } : null;\n    }\n\n    if (isJsonContent(value)) {\n        if (value.type === 'doc' && Array.isArray(value.content)) {\n            const cleaned = normalizeContentArray(value.content, options);\n            return cleaned.length ? { ...value, content: cleaned } : null;\n        }\n\n        if (Array.isArray(value.content)) {\n            const cleaned = normalizeContentArray(value.content, options);\n            return cleaned.length ? { type: 'doc', content: cleaned } : null;\n        }\n    }\n\n    if (typeof value === 'string') {\n        try {\n            const parsed = JSON.parse(value);\n\n            if (Array.isArray(parsed)) {\n                const cleaned = normalizeContentArray(parsed, options);\n                return cleaned.length ? { type: 'doc', content: cleaned } : null;\n            }\n\n            if (isJsonContent(parsed)) {\n                if (parsed.type === 'doc' && Array.isArray(parsed.content)) {\n                    const cleaned = normalizeContentArray(parsed.content, options);\n                    return cleaned.length ? { ...parsed, content: cleaned } : null;\n                }\n\n                if (Array.isArray(parsed.content)) {\n                    const cleaned = normalizeContentArray(parsed.content, options);\n                    return cleaned.length ? { type: 'doc', content: cleaned } : null;\n                }\n            }\n        } catch {\n            return null;\n        }\n    }\n\n    return null;\n};\n\nexport const getFatalTiptapContentError = (value: unknown): string => {\n    const content = valueToContent(value);\n\n    if (!content) {\n        return '';\n    }\n\n    const visit = (node: unknown): boolean => {\n        if (!node || typeof node !== 'object') {\n            return false;\n        }\n\n        const jsonNode = node as JSONContent;\n\n        if (jsonNode.type === 'text' && typeof jsonNode.text === 'string' && jsonNode.text === '') {\n            return true;\n        }\n\n        if (!Array.isArray(jsonNode.content)) {\n            return false;\n        }\n\n        return jsonNode.content.some((child) => {\n            return visit(child);\n        });\n    };\n\n    return visit(content)\n        ? 'This field contains invalid rich-text content. The editor could not fully parse the stored document, so some content may not be shown until it is repaired and saved again.'\n        : '';\n};\n"],"mappings":"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"}

package/dist/serialization/input.d.ts

@@ -0,0 +1,55 @@
+import { Editor, JSONContent } from '@tiptap/core';
+import { VariableOption } from '../types/variable-option.js';
+export type VariableTagAttrs = {
+    label: string;
+    value: string;
+    openOnInsert: boolean;
+    /** True when the token did not match a known variable option (display-only). */
+    unresolved?: boolean;
+    /** Inline default when value is empty (e.g. {user:firstName|Guest}) */
+    default?: string;
+    /** Optional transform id (e.g. "round", "format"). */
+    transformerId?: string;
+    /** Optional transform params payload. */
+    transformerParams?: Record<string, unknown>;
+};
+export declare function dedupeVariableOptions(items: VariableOption[]): VariableOption[];
+export declare function flattenVariableOptions(items: VariableOption[]): VariableOption[];
+/**
+ * Build VariableTag attributes from base and selected variable options.
+ * Optional defaultIfEmpty is used when the resolved value is empty (e.g. "Guest" for {user:firstName|Guest}).
+ */
+export declare function buildVariableTagAttrs(baseVariable: VariableOption, selectedVariable?: VariableOption, options?: {
+    openOnInsert?: boolean;
+    defaultIfEmpty?: string;
+    transformerId?: string;
+    transformerParams?: Record<string, unknown>;
+    label?: string;
+    value?: string;
+}): VariableTagAttrs;
+/**
+ * Strip optional inline default from token for lookup: {user:firstName|Guest} -> {user:firstName}.
+ * Returns [tokenWithoutDefault, defaultText].
+ */
+export declare function parseTokenWithDefault(tokenValue: string): [string, string | undefined];
+export declare function getReferenceBaseToken(tokenValue: string): string;
+export declare function resolveVariableTagLabel(tokenValue: string, option: VariableOption | null): string;
+/**
+ * Resolve variable tag attrs from a token string (e.g. '{form:name}' or '{user:firstName|Guest}').
+ */
+export declare function resolveVariableTagByValue(tokenValue: string, topLevelVariables: VariableOption[], allVariables: VariableOption[]): VariableTagAttrs | null;
+/**
+ * Convert string value with {token} placeholders to Tiptap doc content.
+ */
+export declare function valueToContent(value: string, topLevelVariables: VariableOption[], allVariables: VariableOption[], trailingCursorText?: string): JSONContent | null;
+/**
+ * Convert Tiptap content to string value.
+ * Content is typically editor.getJSON().content (array of block/inline nodes).
+ */
+export declare function contentToValue(content: unknown): string;
+/**
+ * Replace a range in the editor with a variable tag node.
+ * @param editor - Tiptap editor instance
+ */
+export declare function replaceTokenWithVariable(editor: Editor, attrs: VariableTagAttrs, from: number, to: number): void;
+//# sourceMappingURL=input.d.ts.map

package/dist/serialization/input.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"input.d.ts","sourceRoot":"","sources":["../../src/serialization/input.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AACxD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAElE,MAAM,MAAM,gBAAgB,GAAG;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,OAAO,CAAC;IACtB,gFAAgF;IAChF,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,uEAAuE;IACvE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,sDAAsD;IACtD,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,yCAAyC;IACzC,iBAAiB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC/C,CAAC;AA0KF,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,cAAc,EAAE,GAAG,cAAc,EAAE,CAe/E;AAED,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,cAAc,EAAE,GAAG,cAAc,EAAE,CAehF;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CACjC,YAAY,EAAE,cAAc,EAC5B,gBAAgB,GAAE,cAA6B,EAC/C,OAAO,GAAE;IACL,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,iBAAiB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC5C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;CACb,GACP,gBAAgB,CAoBlB;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,UAAU,EAAE,MAAM,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAGtF;AAED,wBAAgB,qBAAqB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAWhE;AAcD,wBAAgB,uBAAuB,CACnC,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,cAAc,GAAG,IAAI,GAC9B,MAAM,CAQR;AAoCD;;GAEG;AACH,wBAAgB,yBAAyB,CACrC,UAAU,EAAE,MAAM,EAClB,iBAAiB,EAAE,cAAc,EAAE,EACnC,YAAY,EAAE,cAAc,EAAE,GAC/B,gBAAgB,GAAG,IAAI,CA+CzB;AAED;;GAEG;AACH,wBAAgB,cAAc,CAC1B,KAAK,EAAE,MAAM,EACb,iBAAiB,EAAE,cAAc,EAAE,EACnC,YAAY,EAAE,cAAc,EAAE,EAC9B,kBAAkB,SAAW,GAC9B,WAAW,GAAG,IAAI,CA0BpB;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CA4CvD;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,CACpC,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,gBAAgB,EACvB,IAAI,EAAE,MAAM,EACZ,EAAE,EAAE,MAAM,GACX,IAAI,CAqBN"}